spec-kitty/spec-kitty

해결하는 문제

Spec Kitty는 AI 기반 개발에서 구조와 추적 가능성의 부재를 해결합니다. 요구사항, 아키텍처 결정, 수용 기준이 채팅 기록에 사라지는 '바이브 코딩'을 방지하기 위해 개발 프로세스의 진실의 근원을 Git 리포지토리 자체로 옮깁니다.

작동 방식

spec -> plan -> tasks -> next -> review -> accept -> merge의 사양 기반 개발 워크플로우를 구현하는 CLI를 제공합니다. 도구는 리포지토리 내부 아티팩트(저장 위치: kitty-specs/)를 관리하고, 별도의 git worktree(저장 위치: .worktrees/)를 사용하여 여러 AI 에이전트나 개발자가 병렬로 다른 워크패키지 작업을 수행할 수 있도록 하되, 브랜치 충돌을 방지합니다.

대상 사용자

Claude Code, Cursor, Windsurf, GitHub Copilot 등의 AI 코드 에이전트를 사용하면서, 일시적인 프롬프트가 아닌 관리되고 반복 가능한 소프트웨어 팩토리 방식을 원하는 개발자 및 팀입니다.

주요 특징

• 리포지토리 내부 가버넌스: 사양, 계획, 리뷰 상태를 Git에 직접 저장.
• 에이전트 격리: git worktree를 사용해 병렬 AI 구현 시 '브랜치 혼란'을 방지.
• 워크패키지 라이프사이클: planned, in_progress, for_review, approved 등의 레인을 통해 작업을 추적.
• 광범위한 에이전트 지원: 슬래시 명령어와 CLI 훅을 통해 다양한 AI 코드 도구와 통합 가능.
• 리트로스펙티브 학습: 완료된 미션 후 자동으로 리트로스펙티브를 생성해 향후 작업을 개선.
• 로컬 우선: 기본적으로 로컬에서 작동하며, 옵션으로 호스팅된 동기화 통합 가능.