스펙 주도 개발
요구 사항을 스펙, 계획, 코드, 추적 가능한 변경 기록으로 바꾸세요.
구현 전에 사람과 Coding Agent가 공유할 계약을 만드세요. FiboCode와 Fibo Skills는 초기 요청을 명시적인 인수 기준, 연결된 설계, 순서가 있는 계획, 검토된 코드, 저장소에 남는 변경 기록으로 바꿉니다.
빠른 코드가 합의된 코드와 같지는 않습니다.
Coding Agent는 짧은 요청에서 구현으로 빠르게 이동하지만 빠진 가정은 파일이 바뀐 뒤에 드러나기 쉽습니다. 요구 사항, 경계, 완료 근거가 암묵적이면 검토자는 코드를 평가하면서 의도한 동작도 재구성해야 합니다.
스펙 주도 개발은 실행 전에 명확한 경로를 만듭니다. 요구 사항은 검증 가능한 인수 기준이 되고, 설계 결정은 기준을 만족하는 방법을 설명하며, 계획은 작업, 파일, 검증을 순서대로 지정합니다. 구현에는 보이는 계약이 생기고 마지막 diff 기록이 실제 변경을 설명합니다.
흐름이 실제 작업에 계속 연결되는 모습을 확인하세요.
추적 가능한 프로젝트 기록이 코드와 함께 성장하고 Agent CLI가 기존 터미널 흐름에 남는 모습을 보여 줍니다.
초기 요구 사항을 결정, 작업, 구현 근거, 이후 이해로 연결하는 문서 사슬을 확인하세요.
Agent CLI를 터미널에 둔 채 구체적인 파일, 심볼, 스크린샷, 탐색 가능한 출력 경로를 제공합니다.
네 단계로 의도에서 근거까지 이동하세요.
각 단계의 역할을 분리해 질문이 숨은 구현 선택이 되기 전에 해결합니다.
요구 사항과 인수 기준을 명확히 하세요.
초기 요청을 명시적이고 검증 가능한 결과로 바꾸고 변경에서 제외할 범위를 정하세요. 프로덕션 코드 전에 개발자가 계약을 승인합니다.
기준에 맞춰 접근 방식을 설계하세요.
경계, 인터페이스, 중요한 절충안을 포함해 시스템이 각 기준을 충족하는 방법을 설명합니다. 링크로 결정을 대상 동작에 추적 가능하게 합니다.
순서가 있는 계획을 만들고 실행하세요.
설계를 관련 파일과 인수 방법이 명확한 작업으로 나눕니다. Coding Agent는 합의된 컨텍스트를 사용해 순서대로 작업합니다.
코드를 검토하고 실제 변경을 기록하세요.
결과 diff와 인수 기준을 확인하고 무엇을 왜 바꿨는지 hunk별로 설명하는 기록을 남깁니다.
Agent 실행을 둘러싼 추적 가능한 계약.
구현 전 인수 기준.
스펙이 모호한 의도를 관찰 가능한 결과로 바꿔 개발자와 Agent에 공통 완료 정의를 제공합니다.
동작에 연결된 설계 결정.
설계는 변경의 작동 방식을 설명하고 중요한 결정을 그 결정을 요구한 기준에 연결합니다.
범위가 정해진 순차 실행.
계획에 작업, 관련 파일, 검증 방법을 기록해 불투명한 한 번의 변경이 아니라 검토 가능한 단위로 구현합니다.
실제 diff에 근거한 변경 기록.
실행 후 기록이 구현 hunk를 설명하고 주변 로직과 프로젝트 의도에 연결합니다.
사용 사례: 여러 모듈에 걸친 동작 변경하기.
간단해 보이는 요청이 routing, 상태, UI, 검증에 걸칠 수 있습니다. 개발자는 관찰 가능한 결과와 제외 사항에 먼저 합의하고, 설계는 이를 영향 경계에 매핑하며, 계획은 파일 단위 작업과 각 검증 방법으로 나눕니다.
Agent CLI는 숨은 선택을 줄여 실행합니다. 검토자는 결과를 승인된 기준과 비교하고 실제 변경을 확인하며 구현과 원래 요구 사항의 관계를 설명하는 diff 기록을 남길 수 있습니다.
Agent나 테스트를 대체하지 않는 워크플로 계층.
Fibo Skills는 명확화, 스펙, 설계, 계획, 실행, 변경 기록 단계를 안내합니다. 코딩은 선택한 Agent CLI가 계속 수행하고, 정확성은 프로젝트의 실제 테스트와 인수 방법이 결정합니다.
가치는 공유된 합의와 추적 가능성에 있습니다. 프롬프트 중심 흐름은 의도가 해결되지 않은 채 구현할 수 있지만, 스펙 주도 경로는 변경 전에 의도를 검토하고 변경 후에도 근거를 보존합니다.
스펙 주도 개발 FAQ
작은 수정마다 스펙이 필요한가요?
동작, 경계, 인수에 합의가 필요할 때 사용하세요. 기계적인 작은 변경은 여러 모듈에 걸친 기능과 같은 깊이가 필요하지 않을 수 있습니다.
Fibo Skills란 무엇인가요?
지원되는 Agent CLI 환경에서 명확화, 스펙, 설계, 계획, 실행, 변경 기록을 안내하는 워크플로 지침입니다.
승인 전에 Agent가 코딩을 시작할 수 있나요?
의도된 흐름에서는 미해결 가정이 아닌 명시적인 동작 계약을 바탕으로 프로덕션 코드를 작성하도록 개발자가 먼저 스펙을 승인합니다.
설계와 계획의 추적 가능성을 어떻게 유지하나요?
설계 결정을 인수 기준에 연결하고 계획 작업에 관련 기준, 파일, 인수 방법을 기록합니다.
구현 후에는 무엇을 하나요?
스펙과 실제 diff에 맞춰 결과를 검토하고 변경 기록으로 구현 hunk와 그 이유를 보존합니다.