soft6096/ai-dev-workflow

ai-dev-workflow은(는) 무엇을 하나요?

AI 개발 완전 프로세스: 사양 주도(SDD) + 계층적 테스트 우선(TDD) + 수렴 검증을 통해 AI가 규격에서 벗어나지 않는 코드를 생성하도록 합니다. 9개의 중간 산출물 템플릿과 설치 가능한 Agent Skill이 포함되어 있습니다.

개요

이 워크플로우는 AI 기반 개발에서 코드 품질과 사양 일관성을 보장하기 위해 설계된 체계적인 방법론입니다. SDD(Specification-Driven Development)로 시작하여 TDD(Test-Driven Development)를 계층적으로 적용하고, 최종적으로 수렴 검증을 통해 산출물의 정합성을 확인합니다.

주요 특징

• 사양 주도(SDD): 명확한 사양 정의로 개발 방향 설정
• 계층적 테스트 우선(TDD): 단위, 통합, 시스템 테스트를 단계별로 작성
• 수렴 검증: 최종 코드가 사양과 테스트를 모두 충족하는지 검증
• 9개 중간 산출물 템플릿: 프로젝트 이해, 사양, 설계, 테스트, 구현, 검증 단계별 템플릿 제공
• 설치 가능한 Agent Skill: Claude Code, Cursor, Codex 등 다양한 AI 플랫폼에서 사용 가능

워크플로우 단계

1. 프로젝트 이해 및 요구사항 분석

   • project_overview.md: 프로젝트 개요 및 목표 정의
   • requirements_analysis.md: 요구사항 분석 및 우선순위 설정

2. 사양 정의 (SDD)

   • specification_document.md: 상세 기능 사양 정의
   • interface_contracts.md: API 및 인터페이스 계약 정의

3. 테스트 계획 및 설계

   • test_plan.md: 테스트 전략 및 계획 수립
   • unit_tests.md: 단위 테스트 케이스 작성
   • integration_tests.md: 통합 테스트 케이스 작성

4. 구현

   • implementation.md: 코드 구현 및 테스트 실행

5. 수렴 검증

   • convergence_validation.md: 사양, 테스트, 구현 간의 일관성 검증

설치 방법

Agent Skill 설치

# Claude Code용 설치 예시
claude code install-skill soft6096/ai-dev-workflow

# Cursor용 설치 예시
# Cursor 설정에서 Agent Skill 추가

수동 설정

1. 저장소 클론 또는 템플릿 다운로드
2. 각 단계별 템플릿을 프로젝트에 맞게 수정
3. AI 에이전트에게 워크플로우 단계를 따라 작업하도록 지시

사용 예시

1. project_overview.md를 작성하여 프로젝트 목표 정의
2. AI 에이전트에게 "이 프로젝트 개요를 바탕으로 사양 문서를 작성해줘" 요청
3. 생성된 사양을 바탕으로 테스트 케이스 작성
4. TDD 방식으로 구현 진행
5. 수렴 검증을 통해 최종 코드 확인

라이선스

MIT License

기여

버그 리포트, 기능 제안, 풀 리퀘스트를 환영합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.