AI 코딩 에이전트에 개발 프로세스를 부여해 일관된 결과물을 얻게 하는 도구
AI 코딩 에이전트와 대화하며 기능을 만들거나 버그를 고칠 때, 매번 처음부터 지시를 내려야 하는 번거로움을 덜어줍니다. 이 툴킷은 요구사항 정의부터 구현, 검증까지 이어지는 표준화된 흐름을 에이전트에 제공하여 일관된 결과물을 얻게 합니다. Python 기반의 CLI 도구를 설치하고, 에이전트 채팅창에서 특정 명령어를 입력하는 것만으로 복잡한 개발 단계를 체계적으로 진행할 수 있습니다.
상황에 맞는 세 가지 진입점
기능이나 애플리케이션을 새로 만들 때는 '스펙 기반 개발(SDD)'을, 기존 동작이 깨진 문제를 해결할 때는 '버그 수정'을, 아이디어의 가치를 판단할 때는 '아이디어 평가'를 선택합니다. 이 세 가지는 필수적인 단계가 아니라 상황에 따라 선택적으로 사용하는 독립적인 진입점입니다. SDD는 코어에 포함되어 있고, 나머지 두 가지는 필요할 때 설치하는 확장 기능으로 제공됩니다.
에이전트 채팅창에서 실행하는 스킬
터미널에서 specify 명령어로 프로젝트를 초기화한 뒤, AI 코딩 에이전트의 채팅창에서 /speckit-* 형식의 스킬을 호출합니다. 예를 들어 SDD를 진행할 때는 constitution, specify, plan, tasks, implement, converge 순서로 스킬을 실행하며, 각 단계의 결과를 검토한 후 다음 단계로 넘어갑니다. 버그 수정이나 아이디어 평가도 동일한 방식으로 확장 기능을 설치한 후 관련 스킬을 순차적으로 실행합니다. 모든 산출물은 프로젝트 내 .specify 폴더에 마크다운 파일로 저장되어 추적을 용이하게 합니다.
조직 표준 적용과 커스텀 프로세스 구축
기본 제공된 프로세스 외에도 조직의 표준을 적용하거나 새로운 워크플로를 만들 수 있는 다양한 메커니즘을 지원합니다. Extension은 새로운 명령어나 품질 게이트를 추가하고, Preset은 템플릿이나 용어를 조직 규정에 맞게 조정합니다. Workflow는 프롬프트나 셸 작업을 자동화하며, Bundle은 특정 역할이나 팀에 맞는 설정을 패키지로 제공합니다. 또한 Catalog를 통해 커뮤니티에서 만든 구성 요소를 검색하고 설치할 수 있으며, 사내 전용 카탈로그를 구축하여 승인된 컴포넌트만 사용하도록 제한할 수도 있습니다.
설치 환경과 커뮤니티 소스 검토
사용을 위해 Python 3.11 이상, uv 패키지 매니저, 그리고 지원되는 AI 코딩 에이전트가 필요합니다. Linux, macOS, Windows 환경에서 uv tool install specify-cli 명령어로 설치할 수 있습니다. 커뮤니티 카탈로그에서 제공하는 구성 요소는 감사나 보증 대상이 아니므로, 설치하거나 실행하기 전에 소스 코드를 반드시 검토해야 합니다. 또한 버그 수정 과정에서 검증이 누락된 경우를 성공으로 보지 않으며, 최종 판정 결과가 verified인지 확인하는 것이 중요합니다.
