sddadd

SDD + ADD Starter Template은 AI 프로그래밍 어시스턴트, 특히 Claude Code를 위한 거버넌스 프레임워크입니다. 주요 목표는 AI 어시스턴트를 Spec-Driven Development(SDD) 워크플로우와 Agent-Driven Development(ADD)를 결합한 규율 있는 개발 파트너로 전환하는 것입니다. ## 핵심 워크플로우 템플릿은 CONTEXT → SPEC → PLAN → TASKS → 실행(execute) → 검증(verify) → 동기화(sync)의 순차적 개발 워크플로우를 적용합니다. 각 단계에는 체크포인트가 있으며, 에이전트가 실행하기 전에 인간의 승인이 필요합니다. ## 세 가지 기본 규칙 1. **Spec을 편집하고 코드를 편집하지 마십시오**: 요구 사항이 누락되었거나 모호한 경우 `/sdd-update` 명령을 사용하여 먼저 Spec을 업데이트하고, 동작을 변경하기 전에 검토하십시오. 2. **기술적 추측 금지**: 계획, 작업 및 실행은 `.sdd/architecture-profile.md`에서 승인된 바인딩과 정확한 검증 명령만 사용합니다. 3. **인간이 결정합니다**: 에이전트는 스스로 승인하지 않고, `git push`하지 않으며, 배포하지 않고, 물리적 상태 변경을 자율적으로 수행하지 않습니다. ## 소유권 및 실행 템플릿은 `.sdd/shared_context.md`에서 두 개의 독립적인 축을 분리합니다: - **프로젝트 소유권**(`solo` 또는 `team`): 인간 검토의 유효성과 Git 전달 정책을 결정합니다. 기본값은 `team`입니다. - **에이전트 실행**(`direct` 또는 `orchestrated`): `/add-execute`는 현재 에이전트에서 직접 실행되거나 런타임 기능을 관찰한 후 워커를 오케스트레이션합니다. ## 문서 템플릿은 포괄적인 문서 시스템을 제공합니다: - **빠른 시작**(`docs/sdd-add-quickstart.md`): 신규 사용자를 위한 단계별 로드맵. - **운영 가이드**(`docs/sdd-add-guide.md`): 아티팩트, 게이트 및 소유권 이해. - **빠른 참조**(`docs/sdd-add-field-guide.md`): 시나리오별 명령 선택. - **시나리오 플레이북**(`docs/sdd-add-scenario-playbook.md`): 그린필드, 브라운필드, 오류 및 핸드오프 처리. - **아키텍처 프로필 가이드**(`docs/architecture-profile-guide.md`): 바인딩 및 기술 명령 선택. - **실행 가이드**(`docs/multi-agent-orchestration-guide.md`): 작업/기능 실행 및 워커 오케스트레이션. ## 정식 소스 - `.claude/skills/`: 명령에 대한 계약(Contracts). - `.claude/skills/_shared/ai-review-protocol.md`: 검토 프로토콜, 방법론 및 Action Record. - `.sdd/architecture-profile.md`: 기술 바인딩 및 정확한 검증 명령. - `CONSTITUTION.md`: 보안, 아키텍처 및 품질에 대한 하드 규칙. - `AGENTS.md`: 에이전트 범위 및 권한. ## 유틸리티 스크립트 - `scripts/self-heal.sh`: 승인된 명령을 실행하여 증거를 수집합니다. 소스를 수정하거나 재시도하지 않습니다. - `scripts/template-smoke.sh` / `.ps1`: 파일, 링크 및 정책 계약에 대한 정적 검사. - `scripts/adopt.*`: 기존 저장소에 템플릿을 채택합니다. - `scripts/update.*`: 템플릿에서 업데이트를 가져옵니다. 거버넌스 파일은 인간 검토를 위해 스테이징됩니다.