# 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.

- Skill: `sp-daewoon/devlog` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sp-daewoon/devlog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sp-daewoon/devlog/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: sp-daewoon (https://skillmd.com/u/sp-daewoon)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sp-daewoon/devlog

---


# 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:

```json
{
  "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:

```bash
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.