mcpField
S
session-documenter

session-documenter

github.com/shipshitdevAgent workflows38150 installsUpdated 2d ago
Repository

About session-documenter

session-documenter is an agent skill for recording work, decisions, and next steps in daily project session files. It redacts secrets and can update durable project memory when decisions affect it.

Key features

  1. 01Start and load daily session context
  2. 02Append redacted session entries
  3. 03Update durable project memory
  4. 04Require confirmation for history rewrites

Use cases

  1. 01Record work and decisions at session end
  2. 02Resume work using the current day's context
  3. 03Capture project-changing architectural decisions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipshitdev/skills --skill session-documenter

After installing, type/session-documenterin Claude Code to confirm it loaded.

Bundled filesplugin.jsonreferences/full-guide.md

Details

From the project README

Session Documenter Skill

Document work, decisions, and context.

Contract

Inputs:

  • Current session context, redacted for secret-like values
  • Files changed, decisions made, blockers, and next steps
  • Optional task or PRD references

Outputs:

  • Appended session entry in .agents/sessions/YYYY-MM-DD.md with secrets removed
  • Related summary/task updates when needed

Creates/Modifies:

  • .agents/sessions/ daily session file
  • .agents/memory/*.md when a decision changes durable project context (architecture, deployment, migrations, gotchas)

External Side Effects:

  • None

Confirmation Required:

  • Before rewriting existing session history
  • Before promoting session notes into permanent rules or skills

Delegates To:

  • rules-capture for reusable preferences discovered during the session
  • skill-capture for reusable workflows discovered during the session
  • session-end for wrap-up flow

Commands

CommandAction
/startBegin new session - creates/appends to today's file, loads context
/endFinalize 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 - Track decisions, files changed, mistakes
  3. /end - Write a redacted 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
Redaction (MANDATORY)

Before writing session notes:

  • Replace API keys, tokens, passwords, cookies, private credentials, and secret values with [REDACTED_SECRET].
  • Summarize sensitive command output instead of copying it verbatim.
  • Do not store full request/response payloads if they contain personal data, private URLs, or credentials; record only the decision-relevant fields.

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/memory/*.md — when a decision changes durable repo context (architecture, deployment, migrations, gotchas). Bump the file's last_verified date when you touch it.

References

Comments

Markdown supported