설명
Spec-first Agentic Development는 AI 코딩 에이전트와 작업하기 위한 구조화된 접근 방식을 도입하여 모든 변경이 명확하게 정의되고 검토된 사양에 의해 시작되도록 보장합니다. 이 방법론은 개발 생애 주기 전반에 걸쳐 인간의 감독과 자동 검사를 통합하여 AI 에이전트가 개발한 코드의 신뢰성과 유지 관리성을 향상시키는 것을 목표로 합니다.
더 읽기
핵심 원칙은 모든 개발 작업을 저장소에 저장된 서면 사양으로 시작하는 것입니다. 이 사양은 목표, 관련 사실(파일 및 줄 참조 포함), 수행할 단계 및 정확한 '완료' 기준을 설명합니다. 코드가 작성되기 전에 새로운 검토자가 기존 코드베이스에 대해 사양의 정확성과 실행 가능성을 검토합니다. 승인이 완료되면 AI 에이전트는 자신의 격리된 브랜치와 작업 트리에서 기능을 구축합니다. 모든 미리 정의된 검사와 테스트가 통과한 후에만 최종 커밋이 메인 저장소에 반영되어 코드 품질과 사양 준수를 보장합니다.
이 시스템은 전통적인 '느낌 코딩'과 크게 다르며, 임의의 프롬프트를 검토된 지속적인 사양으로 대체합니다. 에이전트가 내린 각 결정과 그 이유를 기록하여 명확한 감사 추적을 제공하고, 개발 후 문서화의 필요성을 줄입니다. 사양은 지나치게 정밀한 코드 생성기가 아니라 의도와 아키텍처를 명확히 하기 위해 설계되었으며, 테스트와 커밋 게이트가 필요한 정밀성을 제공합니다. 오래된 사양은 커밋과 유사하게 불변의 변경 기록으로 취급되며 업데이트되지 않아 노후화를 방지합니다.
Spec-first Agentic Development는 병렬 개발을 지원하여 여러 에이전트가 고유한 브랜치 및 작업 트리 ID를 사용하여 동시에 다른 사양에서 작업할 수 있도록 합니다. 검토된 사양이 열린 질문에 대한 사전 답변을 제공하므로 프로세스는 중단되지 않으며, 에이전트는 직접 완료 기준에 따라 구축할 수 있습니다. 전체 워크플로우는 구조화되어 있으며, 하나의 사양은 하나의 브랜치와 하나의 커밋에 해당하여 풀 요청을 단순화하고 일관성을 보장합니다. 상태는 `context.yaml`에 유지되어 재시작 후에도 작업을 재개할 수 있습니다.
이 방법, 템플릿 및 Claude Code 플러그인은 모두 MIT 라이센스 하에 제공되어 비용이 들지 않는 솔루션입니다. Claude Code 플러그인이 회계 및 게이트 기능을 자동화하는 동안, `AGENTS.md`를 따르고 커밋 게이트를 위한 git commit-msg 훅을 설치함으로써 Codex, Cursor 또는 Copilot과 같은 다른 에이전트와 함께 이 방법론을 채택할 수 있습니다. 이 접근 방식은 오픈 소스 에이전틱 소프트웨어 공장인 Agent Smith의 개발과 개선을 통해 실용적인 적용과 효과성을 입증했습니다.
- 카테고리AI 코딩 어시스턴트
- 요금제무료
- 배포클라우드
- 플랫폼웹
Spec-first Agentic Development의 핵심 기능
AI 코딩 에이전트를 위한 사양 주도 개발
구축 전에 코드와 비교하여 검토된 사양
각 개발 작업을 위한 격리된 작업 트리
모든 검사가 통과해야 하는 게이트 커밋
저장소에 저장된 지속적인 사양
추적 가능성을 위한 이유와 함께 결정 기록
고유한 브랜치 ID를 통한 병렬 개발 지원
context.yaml에 저장된 상태로 재개 가능한 워크플로우
MIT 라이센스의 방법, 템플릿 및 Claude Code 플러그인
Codex, Cursor, Copilot 및 터미널과의 호환성
커밋 게이트 강제를 위한 git commit-msg 훅
사양 인용에 대한 자동화된 증거 검사
단일 또는 일련의 사양을 위한 구조화된 풀 요청
기존 코드베이스에서 생성된 컨텍스트 및 규칙
Agent Smith의 빌드 프로세스에 필요한 수작업 코드 없음
Spec-first Agentic Development 사용 방법은?
플러그인/훅 설치: 프로젝트 클론에 Claude Code 플러그인 또는 git commit-msg 훅을 설치합니다.
프로젝트 부트스트랩: /spec-first:bootstrap-project를 실행하여 기존 코드에서 컨텍스트와 규칙을 생성합니다.
사양 생성: create-spec 기술을 사용하여 목표, 단계, 사실 및 완료 기준을 정의하여 새로운 작업을 만듭니다.
사양 검토: 새로운 검토자가 코드에 대해 사양의 정확성과 실행 가능성을 확인합니다.
사양 적용: 에이전트가 프로젝트 규칙에 따라 자신의 브랜치와 작업 트리에서 사양을 구축합니다.
사양 전달: 모든 검사가 통과하도록 게이트를 통해 변경 사항을 커밋하고 풀 요청을 엽니다.
시리즈 전달: 더 큰 변경 사항의 경우 /spec-first:deliver-series를 사용하여 여러 상호 의존적인 사양을 관리하고 전달합니다.
Spec-first Agentic Development의 사용 사례
- AI 에이전트 코드 개발
- 코드 품질 보장
- 복잡한 프로젝트 관리
- 코드 추적 가능성 향상
- 코드 리뷰 촉진
- 개발 워크플로우 자동화
- 신규 개발자 온보딩
- 기존 도구와 통합
