ai-sdlc-framework/ai-sdlc

해결하는 문제

AI 에이전트는 작은 그린필드 프로젝트에서는 훌륭하지만 성숙한 코드베이스에서는 실패합니다. README에서 인용한 연구에 따르면 AI 도구를 사용하는 개발자는 성숙한 코드베이스에서 실제로 19% 더 느리고, 리팩토링은 감소하고, 안정성은 떨어지며, 개발자의 3%만이 AI 출력을 신뢰합니다. 근본 원인은 코드가 성장함에 따라 에이전트가 어떻게 작동하는지 아무도 조정하지 않는다는 것입니다. 모든 결정이 최악의 순간에, 가장 적은 맥락을 가진 행위자에 의해 이루어집니다. AI-SDLC는 부하가 큰 결정을 사전에 인간 운영자에게 이동하고 AI가 명확히 지정된 계약을 결정론적으로 실행하도록 함으로써 이를 뒤집습니다.

작동 방식

AI-SDLC는 AI 에이전트를 구조로 감싸는 "결정 엔진"입니다. 다섯 가지 기둥이 있습니다.

1. Definition-of-Ready (DoR) 게이트 — 운영자가 실제로 결정하지 않은 작업의 디스패치를 거부합니다. 결정 카탈로그는 영향력 순으로 정렬된 미해결 질문을 권장 사항과 반대 논거와 함께 표시합니다.
2. 세션 계층 구조 — cli-hierarchy up은 플래너, 디스패치 세션, 최대 5개의 실행기를 시작합니다. 각각은 자체 tmux 내의 Claude Code 세션입니다. 디스패치는 의존성 그래프를 따라 승인된 작업을 스텝 0-13 파이프라인(개발 에이전트 → 리뷰어 → 증명 → PR)을 실행하는 격리된 git worktree의 실행기에 전달합니다.
3. 교차 하네스 리뷰 — 서로 다른 하네스(예: Claude vs Codex)의 리뷰어가 변경 사항을 병렬로 검증합니다. DSSE 증명에는 harness 필드가 있으며 독립성이 강제됩니다: Claude가 구현한 경우 Claude는 리뷰어가 될 수 없습니다. 리뷰어 간의 결탁은 기계적으로 불가능합니다.
4. 운영자 표면 — 운영자는 cli-hierarchy(status, attach, brief, down)와 결정 카탈로그를 통해 작업하며 입력보다는 모니터링에 집중합니다.
5. 선언적 거버넌스 — Pipeline, Decision, AgentRole, QualityGate, AutonomyPolicy, AdapterBinding과 같은 리소스는 JSON Schema 리소스로 존재합니다. 품질 게이트는 자문 → 소프트 필수 → 하드 필수 순으로 실행되며, 컴플라이언스 체계는 EU AI Act, NIST AI RMF, ISO 42001에서 기본값을 도출합니다.

설치는 Claude Code 플러그인을 통해 이루어지며, 그 다음 ai-sdlc init, ai-sdlc doctor, 그리고 /ai-sdlc execute AISDLC-42와 같은 디스패치를 수행합니다. 프레임워크는 에이전트에 독립적입니다(Claude Code, Codex, Cursor, Copilot, Aider 또는 OpenAI 호환 API).

대상 사용자

소프트웨어 개발에 AI 에이전트를 사용하고 싶지만 거버넌스, 신뢰성, 책임성이 필요한 팀을 위한 것입니다. 운영자가 "결정 관리자"가 되기 위한 것입니다. 미해결 질문을 구성하고 해결하며 파이프라인을 모니터링하는 반면, 프레임워크는 입력과 날인을 처리합니다. 통제되지 않은 AI가 품질 및 안정성 저하를 유발하는 성숙한 코드베이스를 대상으로 합니다.

하이라이트

• 비용 비대칭 — 완전한 맥락으로 사전에 이루어지는 운영자 결정은 저렴하고 대부분 정확합니다. 실행 중 AI 결정은 비싸고 종종 틀립니다.
• DoR 게이트 — 운영자가 실제로 결정할 때까지 디스패치를 방지합니다.
• 교차 하네스 리뷰 — 구조적으로 리뷰어 독립성을 강제하여 결탁을 불가능하게 만듭니다.
• DSSE 증명 — 모든 변경 사항을 봉인하며 병합은 governance.allowMerge 규칙을 따릅니다.
• Kubernetes 스타일 API 성숙도 — JSON 스키마, RFC 프로세스, 적합성 테스트 스위트를 갖춘 v1alpha1 사양.
• 다중 SDK — TypeScript, Python, Go 및 Claude Code 플러그인과 MCP 서버.
• 선언적 거버넌스 — 품질 게이트 및 컴플라이언스 체계( EU AI Act, NIST AI RMF, ISO 42001)를 리소스로.