Devlog

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.

sp-daewoon ea33d6c 1.4 KB Updated

File contents

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.

sp-daewoon/chronicle/tree/main/skills/devlog commit ea33d6c264

Frequently asked questions

npx skillmds@latest add sp-daewoon/devlog