Docs System
Lightweight, agent-safe project documentation: a transient worklog, curated refs, and an end-of-day sweep that turns notes into summaries. Per-project — no global state.
How the three skills compose
Run once, then use forever:
- /doc:initOnce per project. Recons the repo, proposes a worklog/refs layout, scaffolds
.notes-config.yml+new-note.sh. - /doc:new-noteThroughout the day. Calls the script, returns a path, enforces naming/sequence.
- /doc:sweepEnd of day. Reads today's notes, resolves tensions, fills the daily summary. Convergent — safe to re-run.
/doc:init needs four asset files on disk (templates it copies verbatim into the project). The install script below grabs all of them.
One-command install
Drops three SKILL.md files plus the four assets into ~/.claude/skills/. Restart Claude Code to pick them up.
BASE="https://guide.zenaitutoring.com/docs-system"
for s in doc-init doc-new-note doc-sweep; do
mkdir -p ~/.claude/skills/$s
curl -fsSL "$BASE/$s.md" -o ~/.claude/skills/$s/SKILL.md
done
mkdir -p ~/.claude/skills/doc-init/assets
for a in config-template.yml new-note.sh refs-claude.md worklog-claude.md; do
curl -fsSL "$BASE/assets/$a" -o ~/.claude/skills/doc-init/assets/$a
done
chmod +x ~/.claude/skills/doc-init/assets/new-note.shAfter install: invoke with /doc:init in a fresh project, then /doc:new-note and /doc:sweep day-to-day.
What you get
Three skills + four assets. Each file is curl-able individually below.
Recons the project, proposes a worklog/refs shape, scaffolds .notes-config.yml + new-note.sh. Convergent — safe to re-run.
Creates a worklog note via the project's new-note.sh. Enforces naming, sequence numbers, and layout. Never creates files manually.
Reads today's notes, resolves cross-note tensions, fills today's daily summary. Optionally seeds tomorrow and updates STATUS.md. Idempotent — runs twice = no-op.