Documentation & Session Workflow
Invoke with /tzurot-docs for session management and documentation procedures.
Session Start Procedure
-
Read CURRENT.md
-
What's the active task?
-
Read BACKLOG.md High Priority - What's next?
-
Continue active task or pull next
Session End Procedure
-
Update CURRENT.md with progress
-
If task incomplete, note blockers in Scratchpad
-
Commit with wip: prefix if needed
Work Tracking Files
File Purpose Update When
CURRENT.md
Active session - what's happening NOW Start/end session, task done
BACKLOG.md
Everything else - all queued work New ideas, triage, completion
Tags: 🏗️ [LIFT] refactor/debt | ✨ [FEAT] feature | 🐛 [FIX] bug | 🧹 [CHORE] maintenance
CURRENT.md Structure
Current
Session: YYYY-MM-DD Version: v3.0.0-beta.XX
Session Goal
One sentence on what we're doing today.
Active Task
🏗️ [LIFT] Task Name
- Subtask 1
- Subtask 2
Scratchpad
Error logs, decisions, API snippets.
Recent Highlights
- beta.XX: Brief description
BACKLOG.md Structure
Inbox
New items. Triage to appropriate section later.
High Priority
Top 3-5 items to pull into CURRENT next.
Epic: [Theme Name]
Group related work by project.
Smaller Items
Opportunistic work.
Icebox
Ideas for later.
Workflow Operations
Intake (New Idea)
Add to Inbox in BACKLOG.md with a tag:
- ✨
[FEAT]Feature Name - Brief description
Start Work (Pull)
-
Cut task from BACKLOG.md
-
Paste into CURRENT.md under Active Task
-
Add checklist if needed
-
Update Session Goal
Complete Work (Done)
-
Mark task complete in CURRENT.md
-
Move to Recent Highlights (keep last 3-5)
-
Pull next task from BACKLOG High Priority
Documentation Standards
For doc placement, naming, and lifecycle rules, see .claude/rules/07-documentation.md .
References
-
Current session: CURRENT.md
-
All work items: BACKLOG.md
-
Documentation standards: .claude/rules/07-documentation.md
-
Documentation audit: .claude/skills/tzurot-doc-audit/SKILL.md