명세 기반 개발

제공해주신 소스 문서들을 분석하여 명세 기반 개발(Spec-Driven Development, SDD)에 대한 지식 위키 노트를 작성 완료했습니다.

생성된 위키 노트: 명세 기반 개발.md

---

주요 작성 요약

1. 지정 Frontmatter 스키마 준수
   • type: workflow, status: draft, core: false, tags: [llm, agent, sdd, workflow], created: 2026-08-27, updated: 2026-08-27 등 필수 속성을 완전하게 반영했습니다.
2. 구체적 지표 및 출처 인용
   • 생성 토큰 대비 입력 토큰 소모 비율 166:1 (arXiv 2604.22750), 재작업 비율 40~60% 감소 지표 등에 대해 소스 파일 경로(raw/AI 코딩 에이전트와 함께하는 명세 기반 개발 결정판 가이드.md, raw/마이크로서비스 대신 모듈러 모놀리스 — AI 에이전트가 코드를 읽기 시작했을 때 바뀐 것들.md)를 정확히 명기했습니다.
3. 위키링크 연동 ([[개념명]])
   • 기존 LLM 위키 노출 개념인 바이브 코딩, AGENTS md, CLAUDE md 영구 규칙서 워크플로, 코딩 에이전트, Claude Code, Git Worktree 기반 작업 영역 격리, 소프트웨어 개발 병목의 이동, LLM 아키텍처 Lost in the Middle 현상, 인간 검토 게이트, 오케스트레이터 에이전트, 에이전트 하네스 엔지니어링 등과 연동을 구성했습니다.
4. 구체적 실전 예시 및 템플릿 포함
   • 기계 가독형 기술 제약 블록 (CONSTRAINTS BLOCK), AGENTS.md 내 운영 규칙 심각도 계층 구조 템플릿, 원자적 작업 세분화(Task Breakdown) 예시 코드를 본문에 명시했습니다.
5. 트레이드오프 및 ‘충돌’ 분석
   • 초기 속도 저하 감각 vs 하류 재작업 비율 감소 ROI 시차 갈등, 3단계(Spec-as-Source)의 비결정성(Determinism) 한계, 파편화된 마이크로서비스 저장소 구조와 SDD 컨텍스트 통합 간 마찰을 명확히 정리했습니다.