Skip to content

BL-086: aidlc-writing-plans에 mapping 검증 단계 추가 (재발 방지) #155

@bluejayA

Description

@bluejayA

배경

BL-085 (Knowledge System Phase 1) Task 4 실행 중, plan이 명시한 33개 패턴/리뷰어 파일의 applies_to 매핑이 부정확함이 발견되었다 (Agent 검증 결과 ~10/33만 정확).

발견 경로

  1. Task 4 commit (362af3e) — plan에 명시된 매핑 그대로 적용
  2. 사용자 요청으로 multi-agent review (Codex + general-purpose agent) 실행
  3. general-purpose agent가 SKILL.md grep 기반 mapping 정확성 검증
  4. MAJOR issues 발견:
    • Reviewer 12개: "requesting-code-review가 모든 reviewer 사용" 가정 → 실제 4개만
    • Protocol 4개: `applies_to: []` → 실제는 모두 specific consumers 존재
    • Pattern 9개: false positive (claim하지만 미사용)
  5. amend로 정정 완료

근본 원인

aidlc-writing-plans 스킬이 plan 작성 시 mapping/참조성 검증 단계가 없음.
Plan 작성자가 "기획 의도" 매핑을 명시했으나 실제 SKILL.md 본문 grep 검증을 안 함.

제안

aidlc-writing-plans에 다음 단계 추가:

  1. plan에 file path 매핑이나 dependency 명시 시:
    • 명시된 path가 실제 존재하는지 확인
    • 명시된 의존성/참조가 실제 코드에서 grep으로 검증 가능한지 확인
  2. Verification 단계 추가: 매핑된 항목별로 1줄 grep 명령 명시
  3. 검증 실패 항목은 "plan 검증 결과" 섹션에 명시 후 작성자가 수정/명시적 우회

영향

이 단계가 있었다면 Task 4 정정 사이클 (commit → review → amend) 회피 가능.
향후 plan 신뢰성 향상.

참고

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions