/devlog

name: devlog
description: Turn every working session into a clean, dated development journal, automatically. Use when writing a development session log — it captures the session into a self-contained, dependency-free HTML page and updates a running index. Creates a new sequenced file per call so it never overwrites past logs, adapting to any repo via config.
license: MIT

Devlog Workflow

Capture a development session as a dated HTML log.

Gather the session

Summarize what happened this session into the configured sections (default: Summary, Changes, Decisions, Next). Each section's content must be a **fragment of valid HTML** (e.g. `<p>...</p>`, `<ul><li>...</li></ul>`).

Build a JSON object:

{
  "title": "Short session title",
  "sections": [
    { "heading": "Summary", "html": "<p>...</p>" },
    { "heading": "Changes", "html": "<ul><li>...</li></ul>" }
  ]
}

Render

Pipe the JSON into the helper with today's date:

echo "$JSON" | node "${CLAUDE_PLUGIN_ROOT}/scripts/devlog-render.mjs" --date <today>

The helper writes `<devlog.dir>/YYYY-MM-DD.html` (sequencing `-2`, `-3` on repeat calls the same day — it never overwrites) and rebuilds `index.html`.

Rules

• Use today's real date (never guess).
• Repeat calls the same day create new sequenced files; do not overwrite prior logs.
• Keep HTML fragments self-contained — no external scripts or stylesheets.