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를 따른다.
  • 사용자가 명시적으로 저장 위치를 정해도, 정본 위치가 위험해 보이면 한 번 짚고 넘어간다.
Installs
1
GitHub Stars
4
First Seen
Jun 6, 2026