session-documenter

📁 shipshitdev/library 📅 Jan 20, 2026
37
总安装量
37
周安装量
#5536
全站排名
安装命令
npx skills add https://github.com/shipshitdev/library --skill session-documenter

Agent 安装分布

claude-code 30
codex 24
gemini-cli 23
antigravity 23
opencode 23
cursor 21

Skill 文档

Session Documenter Skill

Document work, decisions, and context with explicit commands.

Commands

Command Action
/start Begin new session – creates/appends to today’s file, loads context
/end Finalize session – writes entry with all tracked work, updates related files

How It Works

  1. /start – Creates .agents/SESSIONS/YYYY-MM-DD.md if missing, or loads existing context
  2. During session – You tell me what to track: decisions, files changed, mistakes
  3. /end – I write the full session entry with flowcharts, decisions, next steps

Critical Rules

Session File Naming (ONE FILE PER DAY)

✅ CORRECT: .agents/SESSIONS/2025-11-15.md
❌ WRONG:   .agents/SESSIONS/2025-11-15-feature-name.md

Multiple sessions same day → Same file, Session 1, Session 2, etc.

Flowcharts (MANDATORY for features)

Include flowchart for:

  • New features
  • Feature modifications
  • Multi-component bug fixes

Session Entry Structure

  1. Session number and title
  2. System flow diagram (mermaid or text)
  3. Affected components (frontend, backend, data, external)
  4. What was done (task checklist)
  5. Key decisions (with rationale)
  6. Files changed
  7. Mistakes and fixes
  8. Next steps

Related Files to Update

  • .agents/SESSIONS/README.md
  • .agents/SYSTEM/SUMMARY.md
  • .agents/TASKS/*/TODO.md
  • .agents/SYSTEM/ARCHITECTURE.md (if architectural decisions)

References