[한영자막] AI 에이전트와 함께하는 스펙 주도 개발 풀코스 강의

한 줄 핵심

스펙 주도 개발은 코딩 에이전트에게 바로 코드를 맡기기보다, 헌법·기능 스펙·검증을 문서화해 인간이 방향을 통제함으로써 대형 코드 변경과 장기 프로젝트를 안정적으로 운영하게 해주는 워크플로다.

시간별 요약

1. 0:00
   스펙 주도 개발의 핵심 개념 스펙 주도 개발은 코드 대신 맥락과 제약을 문서로 고정해 에이전트가 그 문서를 바탕으로 구현하게 만드는 방식이다. 작은 문장 하나로도 큰 코드 변경을 유도할 수 있고, 세션 간 컨텍스트 소실을 막으며, 의도와 결과의 일치를 높인다.
2. 3:02
   비바코딩과의 차이 즉흥적인 프롬프트와 반복 수정에 의존하는 비바코딩은 빠르지만 재사용 가능한 산출물이 남지 않아 기술 부채가 쌓이기 쉽다. 반대로 스펙 주도 개발은 무엇과 왜를 분리해 계약처럼 고정하고, 인간은 구현의 세부보다 의사결정과 품질 검증에 집중한다.
3. 9:00
   프로젝트 헌법과 기능 루프 프로젝트 수준에서는 mission, tech stack, road map을 담은 헌법을 먼저 만들고, 각 기능은 plan, implement, verify 루프로 반복한다. 새 프로젝트와 기존 코드베이스 모두에 적용할 수 있으며, 기능 사이마다 재계획을 통해 헌법과 로드맵을 갱신한다.
4. 13:01
   Agent Clinic로 배우는 초기 세팅과 첫 기능 WebStorm과 Claude Code로 Agent Clinic 프로젝트를 만들고, 대화형 질문을 통해 mission.md, techstack.md, roadmap.md를 생성한 뒤 Git으로 버전 관리한다. 이후 첫 기능인 Hello Hono를 별도 브랜치에서 스펙 작성, 구현, 검증, 커밋까지 작은 단위로 진행하며 스펙이 코드로 확장되는 흐름을 확인한다.
5. 29:02
   검증, 재계획, 피로도 관리 기능 하나를 끝낼 때마다 테스트, 코드 리뷰, 브랜치 정리로 검증하고, 필요하면 constitution과 roadmap을 다시 조정한다. AI가 많은 변경을 한꺼번에 만들수록 인간의 검토 피로도가 커지므로, 작은 커밋과 명확한 구간 분리로 cognitive debt를 줄이는 것이 중요하다.
6. 46:02
   레거시 적용과 자동화, 표준화 스펙 주도 개발은 새 프로젝트뿐 아니라 기존 코드베이스에서도 헌법을 역공학하듯 추출해 적용할 수 있다. 여기에 skills, MCP, ACP, 플러그인 같은 표준을 결합하면 반복 작업을 자동화하고 에이전트와 도구를 교체해도 워크플로를 유지할 수 있다.

실무 인사이트

• 기능 구현 전에 한 줄짜리 요구사항보다 성공 기준·제약·검증 방법을 먼저 문서화하면, 이후 수백 줄의 코드 변경을 훨씬 적은 수정으로 통제할 수 있다.
• 에이전트가 만든 결과를 바로 수정하기보다 스펙과 코드가 함께 일치하도록 되돌리는 습관이 장기 유지보수성과 팀 커뮤니케이션을 크게 높인다.
• 반복되는 스펙 작성·검증 절차는 skills나 MCP, ACP로 표준화하면 사람의 판단은 남기면서도 작업 속도와 일관성을 동시에 확보할 수 있다.