chore(harness): entry SSOT + ownership-matrix + folder unify (#561 PR-A)

[thxforall]

Summary

#561 Sub-task #1·#2·#3 — agent 진입점 통합 + ownership-matrix routing SSOT 격상 + docs/agents/ ↔ docs/agent/setup/ 통합.

• docs/agent/skills.md 신설 — gstack · Matt Pocock · Spec/Generator · Skill routing 정본
• AGENTS.md (6 → 85줄) canonical cross-tool 진입점으로 확장
• CLAUDE.md (241 → 55줄) Claude Code overlay로 축소
• WARP.md Warp overlay로 정렬 (※ symlink였던 점 발견 — 실제 파일로 재작성, 아래 참고)
• .cursor/rules/*.mdc 4개에 AGENTS.md redirect 헤더 1줄 추가
• AGENT.md (37 → 5줄) AGENTS.md 1줄 redirect
• docs/wiki/schema/ownership-matrix.md 5개 row 추가 (ADR · Harness wiki · Skills inventory · Cross-tool agent entry · Vault contract) + 원칙 2개 추가
• docs/agents/{issue-tracker,triage-labels,domain}.md → docs/agent/setup/ (git mv로 history 유지)
• docs/agent/README.md에 ## Setup (1회성) 섹션 추가

Notable findings during implementation

• WARP.md was a symlink to CLAUDE.md, not an independent file. 작업 중 발견하여 symlink를 해제하고 Warp Terminal-specific 내용(Warp Workflows 예시 5종, AI Command tip, worktree-per-tab 패턴 등)으로 실제 파일을 생성했다. 추정 작성된 workflow 이름(decoded:dev, decoded:gen-api 등)은 monorepo의 bun run 명령에서 도출 — 필요 시 후속 조정 가능.
• ownership-matrix 기존 데이터 row가 14개가 아니라 15개였다 (plan에서 1개 miscount). 5개 추가하여 총 20개 + header/sep = pipe-starting 22줄.

Verification

• rg "docs/agents/" --type md --glob '!docs/superpowers/plans/2026-05-21-*' → 0건
• AGENTS.md 단독으로 cross-tool 진입 가능 (Codex / Cursor / Warp 시뮬레이션 통과 — 모든 핵심 reference 포함: ownership-matrix, docs/agent/skills, docs/wiki/wiki/harness, docs/agent/setup)
• ownership-matrix.md 22 pipe-starting lines (header 1 + separator 1 + 20 rows)
• 9 commits, 15 files changed, +1392 / -258

Linked

Part of #561 (Sub-task #1, #2, #3). 다음 PR(PR-B)는 ADR vault 일원화(#4·#6), PR-C는 archive + INDEX.md 정정(#5·#7).

Plan: docs/superpowers/plans/2026-05-21-561-harness-docs-ssot.md

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
decoded-app	Ready	Preview, Comment	May 21, 2026 10:42am