본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

스펙 주도 개발(Spec-driven development)

스펙 주도 개발(spec-driven development)은 코딩 에이전트와 일하는 방식의 하나로, 먼저 무엇을 왜 만들지 명세를 쓴 다음 에이전트가 이를 계획, 작업 목록, 그리고 마지막으로 코드로 바꾸게 합니다.

다른 이름: spec-first

작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식

에이전트에게 "로그인 페이지를 만들어"라고 하면 세부 사항은 에이전트가 추측하게 됩니다. 스펙 주도 개발은 결정을 앞단으로 옮깁니다. 사람이 작성하고 검토한 스펙이 에이전트가 작업하는 기준이 됩니다.

작동 방식

일반적인 흐름에는 몇 단계가 있으며, 각 단계는 다음으로 넘어가기 전에 검토합니다.

1. 명세: 기술을 고르지 않은 채 기능, 사용자, 요구 사항을 설명합니다. 2. 계획: 에이전트가 코드베이스에 맞는 기술 설계를 제안합니다. 3. 작업: 계획을 작고 확인 가능한 단계로 나눕니다. 4. 구현: 코딩 에이전트가 작업을 차례로 처리합니다.

GitHub의 오픈소스 Spec Kit은 이를 에이전트 채팅에서 실행하는 명령 묶음으로 제공하며, 모든 기능에 적용할 규칙을 정하는 프로젝트 헌장을 둡니다. Kiro는 요구 사항, 설계, 작업으로 이루어진 스펙이라는 형태로 비슷한 흐름을 에디터에 내장합니다.

바이브 코딩과의 차이

바이브 코딩은 검토를 건너뛰고 코드가 스스로 말하게 둡니다. 스펙 주도 개발은 단계마다 검토를 두므로, 실수를 큰 diff가 아니라 계획 단계에서 잡아냅니다.

한계

좋은 스펙을 쓰는 데는 시간이 걸리며, 작은 변경에는 그 부담이 값어치를 하지 못합니다. 스펙을 갱신하지 않으면 코드와 어긋날 수도 있습니다. AI 코딩 규칙 파일에서 다루는 프로젝트 규칙 파일은 모든 스펙에 적용되는 상시 지침을 담습니다.

관련 용어

코딩 에이전트
코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
AI 코드 에디터
AI 코드 에디터(AI code editor)는 언어 모델이 내장된 코드 에디터나 IDE입니다. 자동 완성, 코드베이스에 대한 채팅, 그리고 여러 파일에 걸쳐 변경을 계획하고 실행하는 에이전트 모드를 제공합니다.
바이브 코딩(Vibe coding)
바이브 코딩(vibe coding)은 원하는 것을 AI 모델에 설명하고, 모델이 쓴 코드를 읽거나 검토하지 않은 채 받아들이며, 프로그램이 작동하는 것처럼 보이는지만으로 결과를 판단하는 소프트웨어 개발 방식입니다.
에이전트 지침 파일(AGENTS.md)
에이전트 지침 파일(agent instructions file)은 AGENTS.md나 CLAUDE.md처럼 코드 저장소 안에 두는 Markdown 파일로, 코딩 에이전트가 세션을 시작할 때 읽어 프로젝트의 명령, 관례, 규칙을 익힙니다.

출처