docs-writing
Installation
SKILL.md
Docs Writing Router
문서 작성 요청을 받았을 때 프로젝트 repo docs와 Obsidian vault 중 무엇을 어디에 남길지 결정하는 최상위 스킬이다.
이 스킬은 문서의 정본 위치(canonical location) 를 먼저 정한다. 위치가 정해지기 전에는 곧바로 파일을 쓰지 않는다.
핵심 원칙
- 코드와 함께 바뀌어야 하는 확정 정책/결정/운영 절차는 프로젝트 repo에 둔다.
- 계획 문서는 Obsidian-first로 관리한다. 아이디어 단계와 상세 plan의 정본은 Obsidian에 둔다.
- 구현 중 체크리스트와 진행 상태는 repo 문서가 아니라 Pi todo/session state로 관리한다.
- 세션 간 이어받기 handoff는 Obsidian이 아니라 repo의
docs/handoff/에 둔다. - 프로젝트 하나를 넘어 재사용되는 지식은 Obsidian에 둔다.
- 둘 다 필요한 경우에도 역할을 분리한다.
- repo docs: 실행 가능한 정책, ADR 정본, runbook, 코드 계약, handoff
- Obsidian: 계획 정본, 상위 지식, 요약, 링크, 일반화된 원칙
- Obsidian 위치는 이 스킬이 하드코딩하지 않는다. Obsidian에 작성해야 하면 반드시
obsidian-writing스킬을 이어서 사용하고 vault 내부CLAUDE.md/_index.md를 따른다. - 사용자가 명시적으로 저장 위치를 정해도, 정본 위치가 위험해 보이면 한 번 짚고 넘어간다.