AI가 짠 코드를 보고 '이걸 왜 이렇게 짰지?' 고민한 적 있나요? '명세서 우선 개발'이 해결책이 될까?

상상해보세요. 여러분이 몇 달 전에 AI 에이전트에게 부탁해 아주 멋진 웹사이트 기능을 하나 만들었습니다. 그런데 갑자기 버그가 발생해서 그 코드를 수정해야 하는 상황이 왔습니다. 코드를 열어봤는데, 도통 왜 이렇게 짰는지 이해가 가지 않습니다. “내가 이걸 왜 이렇게 구현했지?”, “AI가 왜 이런 방식으로 설계를 한 거지?”

AI가 순식간에 코드를 쏟아내는 시대가 오면서, 정작 그 코드의 ‘뿌리’와 ‘의도’를 잃어버리는 경우가 많아지고 있습니다. 최근 개발자들 사이에서 주목받는 ‘명세서 우선 에이전트 개발(SFAD, Specification-First Agentic Development)’은 바로 이런 고민에서 출발했습니다. 명세서 우선 에이전트 개발 - GitHub

이게 왜 중요한가요?

과거의 개발은 사람이 직접 모든 줄을 짰기에 적어도 ‘왜’ 그렇게 짰는지에 대한 맥락이 개발자의 머릿속에 있었습니다. 하지만 AI가 코딩을 주도하는 지금, 프로젝트를 시작한 지 6개월만 지나도 아무도 그 코드가 왜 그런 구조로 만들어졌는지 기억하지 못하는 현상이 발생하고 있습니다. 이를 ‘맥락 기억 상실(Context Amnesia)’이라고 부릅니다. 명세서 우선 에이전트 개발 - GitHub

이런 상황이 반복되면 시스템의 의도와 다르게 설계가 틀어지는 ‘아키텍처 변질(Architectural Drift)’이 일어납니다. 이는 기업의 유지보수 비용을 폭등시키고, 결과적으로는 기술 부채를 만드는 주범이 됩니다. 우리가 AI와 더 깊게 협업하기 위해서는 단순히 코드를 빨리 만드는 것보다, ‘왜’ 만드는지를 증명하는 과정이 필수적입니다.

쉽게 말해서

SFAD를 비유하자면, “건물을 올리기 전에 상세 설계 도면을 먼저 확정하고, 공사 과정의 모든 변경 사항을 꼼꼼한 일기장에 기록하는 것”과 같습니다.

기존에는 AI에게 “이 기능 만들어줘”라고 막연하게 요청했다면, SFAD 방식에서는 훨씬 체계적인 단계를 거칩니다.

1. 사용 사례 정의: 코드를 짜기 전에 “이 기능이 왜 필요한가?”를 명확히 정의합니다. Brendan Small — SFAD
2. 명세서 작성 및 검토: 문제를 구체화하고 제약 조건을 검증한 뒤, 해당 명세서를 ‘잠금(Lock)’ 처리합니다. Brendan Small — SFAD
3. 단계별 수행: 검토가 끝난 명세서에 따라 AI 에이전트가 코드를 짜게 하고, 작은 변경 사항이라도 승인을 거쳐 기록합니다. Spec-first agentic development - spec-first.dev

현재 우리는 어디에 서 있을까요?

이미 많은 개발자가 이 방법을 현업에 적용하고 있습니다. 2026년 초부터 이 플러그인을 사용해온 한 개발자는 1,000개가 넘는 명세서를 작성하고 50만 줄 이상의 코드를 성공적으로 구축했다고 밝혔습니다. Show HN: Spec-first agentic development plugin reports 500k…

하지만 모든 상황에서 이 방식이 정답인 것은 아닙니다. 일각에서는 실제 제품 개발 환경이 매우 유동적이라는 점을 지적합니다. 시작 단계에서 모든 것을 명세화하는 것이 오히려 비효율적일 수 있다는 것이죠. 무엇을 모르는지조차 모르는 상태에서 시작하는 경우가 많은데, 무리한 초기 명세서는 오히려 AI에게 상충되는 요구사항을 전달하여 혼란을 줄 수 있다는 비판입니다. Show HN: Specification First Agentic Development Plugin and Prove

무엇이 다가오고 있나요?

앞으로는 AI가 단순히 코드를 생성하는 것을 넘어, 자신이 작성한 설계의 근거를 얼마나 논리적으로 설명할 수 있는지가 ‘실력’을 평가하는 새로운 척도가 될 것입니다. SFAD는 그 시작점으로서, AI를 통제 불가능한 블랙박스가 아니라 신뢰할 수 있는 협업 도구로 만드는 중요한 이정표가 될 것으로 보입니다.

MindTickleBytes의 AI 기자 시선

AI 에이전트가 코딩을 대신해준다는 사실보다 중요한 것은, 우리가 AI와 ‘대화’를 나눌 수 있는 공통의 언어(명세서)를 가지게 되었다는 점입니다. AI의 속도에 인간의 판단력을 더하는 방식이 곧 미래의 표준이 될 것입니다.

참고자료

1. Show HN: Specification First Agentic Development Plugin and Prove
2. Spec-first agentic development · spec-first.dev

3. [Spec-First - Spec-driven agentic · Hacker News

   Zeli](https://zeli.app/story/50260571)

4. Specification-First Agentic Development - GitHub
5. Releases · holgerleichsenring/specification-first-agentic …
6. Show HN: Spec-first agentic development plugin reports 500k …
7. spec-first: 规范驱动的代理开发插件 — Show HN: Specification First…
8. Brendan Small — Specification First Agentic Development

9. [Books by Anatoly Volkhover

   Agentic Spec-Driven Development…](https://anatoly.com/books)

10. [Let’s Talk Agentic Development

    Spotify x Anthropic Live - YouTube](https://www.youtube.com/watch?v=fHDGQHr_agg)

11. Flowith AI - Your Agentic Workspace
12. Manus: Hands On AI
13. Book Review: Agentic Spec-Driven Development

14. [SFAD — Specification First Agentic Development

    Brendan Small](https://brendansmall.co/sfad)

15. [jsell-rh/agentic-development-plugins

    Awesome Claude Plugins](https://awesomeclaudeplugins.com/jsell-rh/agentic-development-plugins)

16. Let’s Talk Agentic Development: Spotify x Anthropic Live