배경
BL-085 (Knowledge System Phase 1) Task 4 실행 중, plan이 명시한 33개 패턴/리뷰어 파일의 applies_to 매핑이 부정확함이 발견되었다 (Agent 검증 결과 ~10/33만 정확).
발견 경로
- Task 4 commit (
362af3e) — plan에 명시된 매핑 그대로 적용
- 사용자 요청으로 multi-agent review (Codex + general-purpose agent) 실행
- general-purpose agent가 SKILL.md grep 기반 mapping 정확성 검증
- MAJOR issues 발견:
- Reviewer 12개: "requesting-code-review가 모든 reviewer 사용" 가정 → 실제 4개만
- Protocol 4개: `applies_to: []` → 실제는 모두 specific consumers 존재
- Pattern 9개: false positive (claim하지만 미사용)
- amend로 정정 완료
근본 원인
aidlc-writing-plans 스킬이 plan 작성 시 mapping/참조성 검증 단계가 없음.
Plan 작성자가 "기획 의도" 매핑을 명시했으나 실제 SKILL.md 본문 grep 검증을 안 함.
제안
aidlc-writing-plans에 다음 단계 추가:
- plan에 file path 매핑이나 dependency 명시 시:
- 명시된 path가 실제 존재하는지 확인
- 명시된 의존성/참조가 실제 코드에서 grep으로 검증 가능한지 확인
- Verification 단계 추가: 매핑된 항목별로 1줄 grep 명령 명시
- 검증 실패 항목은 "plan 검증 결과" 섹션에 명시 후 작성자가 수정/명시적 우회
영향
이 단계가 있었다면 Task 4 정정 사이클 (commit → review → amend) 회피 가능.
향후 plan 신뢰성 향상.
참고
배경
BL-085 (Knowledge System Phase 1) Task 4 실행 중, plan이 명시한 33개 패턴/리뷰어 파일의
applies_to매핑이 부정확함이 발견되었다 (Agent 검증 결과 ~10/33만 정확).발견 경로
362af3e) — plan에 명시된 매핑 그대로 적용근본 원인
aidlc-writing-plans스킬이 plan 작성 시 mapping/참조성 검증 단계가 없음.Plan 작성자가 "기획 의도" 매핑을 명시했으나 실제 SKILL.md 본문 grep 검증을 안 함.
제안
aidlc-writing-plans에 다음 단계 추가:영향
이 단계가 있었다면 Task 4 정정 사이클 (commit → review → amend) 회피 가능.
향후 plan 신뢰성 향상.
참고