# Cursor Diary

> Keep a tiny-step implementation diary during coding sessions (what changed, why, commands run, failures, and what was learned), with docmgr integration (doc add/relate/changelog). Use when the user asks to "keep a diary", "write a dev log", or document work step-by-step.

- Skill: `majiayu000/cursor-diary` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/cursor-diary`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/cursor-diary/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/cursor-diary

---


# Cursor Diary

## Overview

Maintain a step-by-step implementation diary as you work, focused on reproducibility (exact commands, file paths, commit hashes) and review efficiency (what to check + how to validate).

## Workflow

### 1) Bootstrap
- Create a diary doc early (before exploration if possible).
  - If using docmgr tickets: `docmgr doc add --ticket TICKET-ID --doc-type reference --title "Diary"`

### 2) Record each tiny step (frequently)
- Write 1–2 short prose paragraphs first (intent + what it unlocked).
- Include exact commands, key outputs, and versions when relevant.
- Capture failures verbatim (errors are valuable).

### 3) Keep code ↔ docs consistent (docmgr loop)
- Implement + format + test.
- Commit code (record hash).
- Update diary with the commit hash + rationale.
- Relate files to the diary with absolute paths: `docmgr doc relate --doc <diary-path> --file-note "/abs/path:why it matters"`
- Update ticket changelog per step: `docmgr changelog update --ticket TICKET-ID --entry "Step N: ..." --file-note "/abs/path:reason"`
- Commit docs separately (e.g., `Diary: record Step N`).

## Output template
- Use the diary template in `references/diary.md` (copy/paste) as the canonical structure.

## Notes
- Prefer many small steps over a few big ones.
- Always include: “What was tricky to build” + “What warrants a second pair of eyes” when behavior changes.