zhu1090093659/spec_driven_develop

해결하는 문제

Spec-Driven Develop는 대규모 소프트웨어 변경(이전, 재작성, 복잡한 리팩터링 등)을 계획 중심의 구조화된 아키텍처 우선 워크플로우로 처리할 수 있도록 AI 코딩 에이전트를 지원합니다. AI 에이전트가 진행 상황을 잃거나 잘못된 계획을 맹목적으로 실행하는 것을 방지합니다. 복잡한 구현 과정에서 원래 의도에서 벗어나거나 아키텍처적 후퇴를 유발하는 일반적인 문제를 예방합니다.

작동 방식

이 프로젝트는 AI 에이전트가 읽고 실행할 수 있는 플랫폼 독립적인 Markdown 기반의 "스킬" 세트입니다. 의도 수집, 심층 분석, 실행, 아카이브에 이르는 7단계 파이프라인을 구현하고, 실행 텔레메트리를 모니터링하는 폐쇄 루프 피드백 시스템인 "Adaptive Control"를 사용합니다. 에이전트의 진행 상황이 계획에서 너무 멀리 벗어나면 시스템이 자동으로 경로 수정 또는 작업 재분해를 트리거합니다.

GitHub에 네이티브로 통합되어 Issues, Milestones, Labels를 통해 작업을 추적하며, 분할된 PR이 아닌 일관된 "배달 배치"로 작업을 그룹화합니다. 또한 두 가지 보조 워크플로우도 포함합니다: 구조화된 기술적 브레인스토밍을 위한 "Deep Discuss"와 버그 및 리그레션에 초점을 맞춘 "Findings-first" 코드 리뷰를 위한 "Review SPD"입니다.

대상 사용자

Claude Code, Cursor, Windsurf, Aider와 같은 AI 코딩 에이전트를 사용하여 고위험, 대규모 아키텍처 변경 또는 엄격한 계획과 추적을 필요로 하는 복잡한 기능 구현을 수행하는 개발자.

주요 특징

• S.U.P.E.R 아키텍처 원칙: 자동화된 헬스 체크와 체크리스트를 통해 단일 목적, 단방향 흐름, 구현보다 포트, 환경 독립, 교체 가능한 부품을 강제합니다.
• Adaptive Control 루프: 제어공학을 영감으로 한 피드백 시스템으로, 실행 편차가 특정 임계값(20%, 40%, 60%)을 초과하면 계획을 중단하거나 재설계합니다.
• GitHub 네이티브 추적: 자동으로 Issues와 Milestones를 생성하고, 워크트리와 배치 PR을 관리하여 프로페셔널 수준의 프로젝트 관리를 가능하게 합니다.
• 플랫폼 독립성: Claude Code, Codex, OpenCode용 플러그인으로 작동하거나, 사용자 지정 지침을 지원하는 모든 에이전트에 대한 간단한 Markdown 스킬로도 사용 가능합니다.