chore(harness): docs/agent 및 신규 스킬·명령어 정합성 점검 (2026-05-21 audit)

[thxforall]

요약

.agents/skills/ 신규 9개 + .claude/commands/ 신규 6개 정합성 + docs/agent ↔ decoded-docs vault 라우팅 + 하네스 일관성을 점검. 상세 audit 리포트: docs/superpowers/specs/2026-05-21-harness-audit.md

심각도	항목	영향
HIGH	F1 generator 7개 model: Codex-sonnet-4-20250514 비표준	트리거되어도 routing 불확실
HIGH	F2 specs/shared/*·.Codex/·lib/types 참조 경로 부재	4개 generator가 master spec 못 읽음
MEDIUM	F3 data-model/component-template generator monorepo prefix 누락	생성된 코드 잘못된 경로
MEDIUM	F4 .claude/commands/*.md 6개 /Users/kiyeol/ 하드코딩	타 머신에서 동작 불가
MEDIUM	F5 to-issues/to-prd가 setup-matt-skills 1회 실행 prerequisite	첫 사용 전 setup 필요
LOW	F6 docs/agent/README에 vault 라우팅 미반영	CLAUDE.md와 drift
LOW	F7 OMC artifact·.next.bak·.scratch untracked 다수	gitignore 정리 필요

Non-issue 확정: vault-dispatch.yml은 의도된 상태. PR #557 revert는 별개로 중복 추가됐던 dispatch-docs-event.yml(92라인)만 제거한 것.

즉시 (이 PR 범위)

• F1 7개 generator 스킬의 model: 줄 제거 (api-contract-generator, component-template-generator, data-model-generator, git-workflow, pencil-screen-ui, screen-spec-generator, supabase-migration-generator)
• F2 specs/shared/ → specs/_shared/ 일괄 교체, 부재 master spec 파일 stub 또는 참조 제거
• F2 git-workflow SKILL.md의 .Codex/agents/code-reviewer.md 참조 정정
• F3 data-model-generator, component-template-generator 출력 경로에 packages/web/ / packages/shared/ prefix
• F4 .claude/commands/*.md 6개 /Users/kiyeol/ → ~/ 일괄 교체
• F5 /setup-matt-skills 1회 실행 후 결과물(CLAUDE.md/AGENTS.md diff) 함께 커밋
• excalidraw-generator, meeting-prep은 그대로 커밋
• CLAUDE.md Skill routing 표에 신규 9 + 6개 등록
• F6 docs/agent/README.md에 vault 라우팅 1줄 + sync-policy 링크 추가

후속 (별도 PR)

• F7 .gitignore 정리 — **/.omc/state/, **/.next.bak/, **/.omc/project-memory.json, .scratch/
• untracked plans 2개 처리 (docs/superpowers/plans/2026-05-07-profile-tries-detail-modal.md, docs/superpowers/plans/2026-05-14-content-studio-pipeline-v2.md)
• docs/research/2026-05-14-obsidian-transition-research.md 로컬본 vs origin/dev 본 비교 정리
• 신규 스킬 9개에 multi-provider agent 메타(.agents/skills/gstack-* 처럼) 추가 결정

백업

/tmp/audit-backup-2026-05-21/ — dev divergence 처리 중 백업한 로컬 파일 3종

메타

• Branch: chore/docs-agent-audit (base: origin/dev 1cf5c3cf)
• Labels: documentation, tech-debt, bump:none

PR

• 처리 PR: docs(harness): docs/agent + skills/commands 정합성 점검 (audit #558) #559 (base: dev)
• 즉시 체크리스트 9/9 처리 완료. 후속 4개는 별도 PR로 분리.

[thxforall]

즉시 체크리스트 9/9 완료. PR #559 (chore/docs-agent-audit → dev)에서 6 atomic commit으로 분할:

Commit	내용	Findings
1c4994a5	excalidraw + meeting-prep (그대로)	—
5854b316	7 generator skills	F1/F2/F3
eee2d17a	6 Matt Pocock commands	F4
5edadfc5	docs/agent/README vault routing	F6
ec5c0f1b	CLAUDE.md routing 표 (9+6)	routing
8568683b	Matt Pocock setup	F5

검증: typecheck pass (exit 0), lint web/api-server pass (ai-server flake8 에러는 origin/dev pre-existing, 이 PR과 무관).

후속(별도 PR): F7 .gitignore 정리, untracked plans 2개, docs/research 비교, multi-provider agent 메타 결정.