structure-checks: frontmatter 중복 키 미탐지 사각지대 보강

[choiyounggi]

배경

2026-08-29 wiki 소급 감사(#156)에서 frontmatter에 last_verified/related 키가 두 번 선언된 페이지 4건이 발견됨 — YAML last-key-wins 의미론으로 앞쪽 값이 조용히 유실되는데, scripts/wiki-structure-checks.js는 required-key 존재만 검사하고 중복 선언은 잡지 못함 (라인 단위 파싱이라 마지막 값으로 통과).

발견된 계통 결함 (수정 자체는 #156에서):

• wiki/platforms/processes/tool-diagnostics-without-a-failing-exit-code.md — last_verified·related 각 2회
• wiki/infrastructure/agent-orchestration/session-completion-gates.md — 동일 + sources 리스트 밖 고아 불릿
• wiki/infrastructure/agent-orchestration/worktree-isolated-workers.md — 동일 패턴
• wiki/qa/deliverables/generated-artifacts-as-deliverable-source.md — related:에 리스트 리터럴 3개 중첩 (파서가 앞 2개 유실)
• wiki/qa/document-verification/spec-document-gates.md — last_verified 2회 (advisory 분류였으나 동일 계통)

할 일

1. scripts/wiki-structure-checks.js에 duplicate-frontmatter-key 검사 추가 — 한 frontmatter 블록 안에서 같은 top-level 키가 2회 이상 등장하면 finding (error-level)
2. related:에 리스트가 이어 붙는 형태(닫힌 ] 뒤 새 [)도 잡히는지 확인 — 키 중복 검사로 잡히지 않으면 별도 검사
3. tests/wiki-structure-checks.bats에 fixture 기반 테스트 추가 (정상 + 중복 키 negative control + 경계값)
4. 라이브 코퍼스 클린 확인은 #156의 4건 수정이 먼저 머지된 뒤에만 통과 가능 — 순서 주의 (이 이슈의 게이트 추가는 wiki 소급 감사: 팩트 blocker 33건(24페이지) + advisory 정리 #156 수정과 같은 PR이거나 그 이후)

DoD

• 중복 키 fixture가 finding을 내고, 클린 fixture는 통과
• node scripts/wiki-structure-checks.js wiki findings 0 (wiki 소급 감사: 팩트 blocker 33건(24페이지) + advisory 정리 #156 수정 반영 후)
• bats 신규 테스트 통과

🤖 Generated with Claude Code

https://claude.ai/code/session_01RJsPDQCz3wNt2qk4opqcKG