chore: monorepo docs/ → Obsidian vault 점진적 마이그레이션

[thxforall]

Summary

monorepo docs/ 문서를 정리하면서 decoded-docs vault로 점진적 마이그레이션.

Tasks

• docs/ 내 문서 성격별 분류 (코드 밀착 vs 운영) — Step 2 매핑 완료
• 운영 문서 우선 vault로 이동 — Step 3, 9개 파일 (ai-playbook 6 + prompts 2 + gstack-guide 1)
• 코드 밀착 기술 문서 당분간 monorepo 유지 — .planning/codebase/*, plans/specs/briefs, research/incidents/handoffs 모두 monorepo 잔류 확정 (grill-docs Q3 B + Q4 E)
• CLAUDE.md 경로 참조 업데이트 — 변경 없음 (🟢/⚪ 모두 경로 그대로, Step 1 stub은 same path)
• 이동 완료된 문서 monorepo에서 제거 — Step 5 (~2026-06-21 이후) 1개월 병행 운영 종료 후

Progress

Done

• Step 1 (PR docs: Step 1 (ADR+architecture stub) + Step 2 (미분류 문서 매핑) — refs #518 #542 commit 64a5a076): ADR + architecture 6개 vault stub 전환
• Step 2 (PR docs: Step 1 (ADR+architecture stub) + Step 2 (미분류 문서 매핑) — refs #518 #542 commit a11aca62 + a67d7b13): 미분류 문서 매핑 + grill-docs 재점검 정정
• Step 3 본체 (vault PR docs(agent): Harness-style agent knowledge split #4): ai-playbook 6 + prompts 2 + gstack-guide 1 vault 복사 + frontmatter
• Step 3 drift 보정 (vault PR chore(cursor): expand skills and rules for team parity #5): assets-project.md ← monorepo PR feat(data-pipeline): Instagram 엔티티 enrichment 파이프라인 추가 #544 backport + double-frontmatter 정리 + drift 인프라(last_synced/last_synced_pr 필드)
• CI 통과 보정 (PR docs: Step 1 (ADR+architecture stub) + Step 2 (미분류 문서 매핑) — refs #518 #542 commit c25f33da): vault stub 6개에 wiki-lint 통과용 minimal frontmatter

진행 중

• Step 4: 1개월 병행 운영 (2026-05-21 ~ 2026-06-21) — drift 모니터링

남은 작업

• Step 5 (~2026-06-21 이후):
  • VAULT 9개 monorepo 원본 삭제
  • ARCHIVE 2개 삭제 (docs/ai-playbook/usage-log.md, docs/backend-frontend-status.md)
  • docs/superpowers/specs/2026-05-14-obsidian-vault-transition-design.md 본문 정정 (§이동 대상 wiki/harness, .planning/codebase/, adr/ 행)

Dependencies

• decoded-docs vault 초기 설정 완료 후 (ongoing) — ✅ 완료 (chore: decoded-docs Obsidian vault 초기 설정 #512 closed)

Refs

• monorepo PR docs: Step 1 (ADR+architecture stub) + Step 2 (미분류 문서 매핑) — refs #518 #542 (Step 1+2 + CI fix, merged)
• vault PR docs(agent): Harness-style agent knowledge split #4 (Step 3 본체, merged)
• vault PR chore(cursor): expand skills and rules for team parity #5 (drift backport, merged)
• plan: docs/superpowers/plans/2026-05-15-docs-migration-step2-mapping.md
• spec: docs/superpowers/specs/2026-05-14-obsidian-vault-transition-design.md

[thxforall]

Codex Review Feedback (Major)

M4: CLAUDE.md 경로 업데이트는 ongoing 작업

단일 체크박스로 처리 불가. 문서 이동 시마다 반복 발생.

수정:

• 문서 이동은 atomic batch: 이동 + link-fix를 동일 PR에서 처리
• CI에 dead-link checker 추가 (markdown-link-check 등)
• 이동 후 CLAUDE.md 경로 참조 자동 검증 스크립트

M5: wiki-lint.yml workflow 경로 수정

docs/wiki/ 문서를 vault로 이동하면 CI가 빈 경로를 lint할 수 있음. 이동 시 workflow도 함께 수정.

[thxforall]

Design: 하네스 파일 마이그레이션 매핑

monorepo → vault 이동 대상

현재 위치	vault 이동 경로	이유
docs/wiki/wiki/harness/claude-code.md	Harness/claude-code.md	프로젝트 무관 하네스 전략
docs/wiki/wiki/harness/session-discipline.md	Harness/session-discipline.md	세션 규율
docs/wiki/wiki/harness/commit-protocol.md	Harness/commit-protocol.md	커밋 프로토콜
docs/wiki/wiki/harness/review-flow.md	Harness/review-flow.md	리뷰 플로우
.planning/codebase/STACK.md	Planning/STACK.md	스냅샷 성격
.planning/codebase/ARCHITECTURE.md	Planning/ARCHITECTURE.md	스냅샷 성격
docs/superpowers/specs/ (완료된 것)	Specs/	에버그린
docs/wiki/schema/conventions.md (일부)	Conventions/	프로젝트 무관 부분

monorepo에 유지 (코드 밀착)

• docs/agent/ (API/DB/라우트 표)
• docs/database/operating-model.md
• docs/DATABASE-MIGRATIONS.md
• docs/GIT-WORKFLOW.md
• docs/adr/
• 패키지별 README, AGENTS.md

하네스 설정 통합

현재	전환 후	이유
CLAUDE.md (루트+패키지)	AGENTS.md로 점진적 통합	크로스벤더 표준
.omc/ (루트+패키지)	루트만 유지, 패키지별 제거	런타임 상태 집중
.planning/	vault Planning/ 이동	중복 경로 제거

CLAUDE.md 경로 전환 전략

• 코드 밀착 문서(docs/agent/) 참조는 유지
• vault 이동 문서는 atomic batch(이동 + link-fix 동일 PR)
• CI dead-link checker 추가

[thxforall]

⏰ Step 5 Due: 2026-06-21

Step 4 (1개월 병행 운영) 종료일. 이후 작업:

1. monorepo 원본 9개 삭제 PR
2. ARCHIVE 2개 삭제 (docs/ai-playbook/usage-log.md, docs/backend-frontend-status.md)
3. docs/superpowers/specs/2026-05-14-obsidian-vault-transition-design.md 본문 정정
4. vault Step 1 stub 6개 drift 점검 (Architecture/adr, README, assets-project, data-pipeline, state-management)
5. 이슈 close

상세 체크리스트는 vault Project/migration/step5-2026-06-21.md 에 보관 (commit a73b01d).