kaanozhan/Frame

ADE( Agentic Development Environment) The spec-driven environment for AI coding agents, where your planning becomes lasting, shared project context.

Frame – 스펙 주도, AI 오케스트레이션 개발 환경

개요 – Frame은 AI 코딩 에이전트에 영구적이고 git 기반의 컨텍스트를 제공하는 Electron 기반 데스크톱 IDE입니다. 모든 프로젝트에 표준 .frame/ 폴더를 생성하여 다음을 저장합니다:

AGENTS.md – 에이전트가 자동으로 읽는 프로젝트 전체 규칙
STRUCTURE.json – 모듈의 빠른 인텐트 인덱스
PROJECT_NOTES.md – 세션 간에 유지되는 아키텍처 결정 사항
tasks.json – 공유 작업 보드
specs/ – 마크다운 기반 스펙 → 계획 → 작업 → 결과 워크플로

이 도구는 세션 시작 시 .frame/AGENTS.md 파일을 주입하여 Claude Code, Codex CLI, Gemini CLI(및 향후 AI CLI)와 함께 작동합니다. 이를 통해 모든 에이전트가 동일한 프로젝트 지식으로 시작합니다.

핵심 개념

개념	Frame의 활용 방식
Git 커밋을 컨텍스트 앵커로	프리커밋 훅이 `STRUCTURE.json`, `tasks.json`, `PROJECT_NOTES.md`를 업데이트합니다. 새로운 AI 세션을 시작하면 에이전트는 이 파일들을 읽으며, 무엇이 변경되었고 왜 변경되었는지 정확히 아는 것을 보장합니다.
스펙 주도 개발	각 기능은 `.frame/specs/<slug>/` 안에 4개의 마크다운 파일(spec, plan, tasks, outcome)과 함께 존재합니다. AI는 계획을 생성(`/spec.plan`), 작업을 분해(`/spec.tasks`), 구현(`/spec.implement`)할 수 있습니다. 각 작업 후 에이전트는 짧은 결과 노트를 작성하여 무엇이 구축되었는지에 대한 스토리를 보존합니다.
에이전트 오케스트레이션	conductor 에이전트가 준비된 스펙을 병렬로 실행하며, 각각은 자신의 git worktree(`.frame/worktrees/<slug>`) 내에서 실행됩니다. 푸트프린트 분석을 통해 중복되는 파일 변경을 방지하고, 완료된 작업은 인간이 승인한 후에만 병합됩니다.
빠른 파일 검색	`STRUCTURE.json`에는 개념을 소스 파일로 매핑하는 `intentIndex`가 포함되어 있습니다. `node scripts/find-module.js github`와 같은 스크립트는 관련 파일을 즉시 반환하여 AI가 저장소 전체를 스캔하는 것을 방지합니다.

주요 기능

멀티 터미널 그리드 – 단일 창에서 최대 9개의 실제 PTY 터미널, 리사이즈 가능한 레이아웃.
작업 및 스펙 패널 – 시각적 보드; 작업은 선택된 AI 도구로 직접 전송할 수 있습니다.
GitHub 통합 – 사이드바에서 이슈, PR, 브랜치, 라벨을 볼 수 있습니다.
병렬 스펙 실행 – 격리된 git worktree, 스펙별 브랜치, 병합 전 자동 드리프트 체크.
멀티 AI 지원 – Claude Code(네이티브), Codex CLI(래퍼), Gemini CLI(래퍼). 도구 전환 시 프로젝트 파일이 손실되지 않습니다.
프리커밋 훅 – 모듈 맵과 작업 상태를 자동으로 동기화합니다.
확장 가능한 플러그인 – Claude Code 플러그인 활성화/비활성화 패널; 마켓플레이스 계획 중.

일반적인 워크플로

폴더 초기화 – Frame이 .frame/ 구조를 생성합니다.
AI 세션 시작 – Claude, Codex 또는 Gemini 선택; 에이전트가 프로젝트 규칙을 로드합니다.
스펙 작성 – spec.md가 기능을 설명하고, AI가 plan.md를 초안합니다.
작업 생성 – /spec.tasks가 tasks.json에 데이터를 채웁니다.
오케스트레이션 – conductor가 병렬 worktree에서 여러 스펙을 실행; 파이프라인 레일을 관찰합니다.
승인 – 드리프트 체크 후 스펙의 브랜치를 병합하거나 PR을 엽니다.
커밋 – 프리커밋 훅이 컨텍스트 파일을 업데이트하여 다음 세션을 앵커링합니다.

대상 사용자

LLM 기반 코드 생성에 의존하는 팀으로, 재현 가능하고 버전 관리되는 컨텍스트가 필요한 경우.
대규모 코드베이스를 구축하는 개발자로, 각 새로운 AI 세션에 아키텍처를 재설명하는 것이 병목인 경우.
프로덕트 매니저나 기술 작가로, git에 유지되는 마크다운 우선의 스펙, 계획, 결과 기록을 원하는 경우.

설치 및 빠른 시작

# clone and install
git clone https://github.com/kaanozhan/Frame.git
cd Frame
npm install
npm run dev   # launches the Electron app in dev mode

macOS, Windows, Linux용 사전 빌드 바이너리도 릴리스 페이지에서 제공됩니다. Node 16+, npm, 그리고 지원되는 AI CLI 중 최소 하나가 필요합니다.

라이선스

Apache-2.0 – 상업적 및 비상업적 사용 모두 무료.

결론 – Frame은 LLM 지원 코딩의 혼란스럽고 상태 없는 특성을 규율 있는 git 기반 워크플로로 전환하는 구체적인 오픈소스 도구입니다. 모든 도구(또는 팀원)가 읽을 수 있는 일반 마크다운 파일에 계획, 스펙, 결정을 유지하면서 AI 생성 코드의 병렬적이고 안전한 실행을 위한 UI를 제공합니다.