Roadmap

AI Rules 시스템 개선 계획 · 격차 분석 기반 · 9/22 완료

전체 진행률 41%

분석된 구조적 격차

AITEM 프로젝트 실제 사고 사례 + Anthropic 공식 문서 + 33,596개 PR 분석 기반

Gap A

Advisory vs. Deterministic

CLAUDE.md 규칙은 Advisory — Hooks로 이중화 필요

Gap B

CLAUDE.md 비대화 리스크

200줄 이하 유지 권장, Skills 시스템으로 on-demand 분리

Gap C

신규 프로젝트 진입 절차 부재

docs/00_INDEX.md 없으면 Bootstrap 절차 필요

Gap D

Subagent 정의가 텍스트로만 존재

.claude/agents/ 공식 포맷으로 전환

Gap E

Human-AI 하이브리드 게이트 불균형

자율 실행 트리거 + 승인 임계치 명시

Gap F

Context 소진 관리 부족

Subagent 위임으로 메인 컨텍스트 보호

개선 계획

완료 Phase 1 — 즉시 적용 — 세션 시작 절차 + 자율 실행 트리거 + Bootstrap 절차

신규 프로젝트 Bootstrap 절차 (04-lifecycle Step 0) core/04-lifecycle.md

탐색 앵커 부재 시 예외 조건 (05-responses) core/05-responses.md

AI 자율 실행 트리거 + 사람 승인 임계치 (04-lifecycle) core/04-lifecycle.md

완료 Phase 2 — 단기 — Governance 통합 + Hooks 가이드 + Subagent 패턴

Governance 교차 검증 시스템 통합 (ai-governance → ai-rules) governance/

Provider-Agnostic llm-client (verifiers/judge 구조) governance/orchestrator/llm-client.mjs

Hooks 가이드 (09-hooks-guide.md) core/09-hooks-guide.md

Subagent 위임 패턴 (10-subagent-patterns.md) core/10-subagent-patterns.md

Governance 공통 정책 문서화 (BYPASS_POLICY, DEPLOYMENT_CONTRACT, DOMAIN_THRESHOLD_MODEL, PROJECT_CAPABILITY_MATRIX) docs/guide/

진행 중 Phase 3 — 중기 — Governance 스크립트 구현 + Domain Threshold 자동화 + Deployment Adapter

agents/ → .claude/agents/ YAML frontmatter 포맷 전환 agents/

gate-health-check.mjs 구현 governance/scripts/gate-health-check.mjs

eval-runner.mjs 구현 governance/scripts/eval-runner.mjs

trust-score.mjs 구현 governance/scripts/trust-score.mjs

DOMAIN_THRESHOLD_MODEL 기반 thresholds.yaml 자동 생성 (governance adapter) adapters/governance.mjs

PROJECT_CAPABILITY_MATRIX 프로젝트별 상태 기입 + bypass 정책 적용 docs/guide/PROJECT_CAPABILITY_MATRIX.md

Deployment adapter 패턴 구현 (Vercel / Docker-VM 기본 지원) adapters/deployment.mjs

extensions/aitem-frontend.md 중복 항목 제거 extensions/aitem-frontend.md

예정 Phase 4 — 장기 — CLAUDE.md 슬리밍 + AGENTS.md 표준 + Gemini 지원 + MCP 통합

CLAUDE.md 150줄 이하 슬리밍 + Skills 시스템 분리

AGENTS.md 표준 지원 (Linux Foundation) + agents-md adapter

Google Gemini provider 검증 및 공식 지원 governance/orchestrator/llm-client.mjs

MCP 통합 — Linear/Jira → INTENT.md 자동 생성

MCP 통합 — Figma → UI 자산 자동 탐색

Rollback readiness 관리 + post-deploy verify 수준 정의 docs/guide/DEPLOYMENT_CONTRACT.md