agent-impl-notes-loglisted
Install: claude install-skill wei18/apple-dev-skills
# Agent Implementation Notes — Running Log
Invoke with a topic argument (frontmatter [`argument-hint: "[topic]"`](https://code.claude.com/docs/en/skills#pass-arguments-to-skills)).
## Purpose
The phase meeting log (`meetings/{date}_{topic}.md`) is summative — written after work completes. By that point, dozens of micro-decisions made mid-flight are already lost to the commit diff. An impl-notes log fills that gap: a **concurrent record** of decisions, deviations, tradeoffs, and unresolved questions, written as they happen.
## When to invoke
Subagent MUST invoke this skill at the start of any dispatch matching ANY of:
- Implements behavior whose spec has known ambiguity (e.g., `// UNCONFIRMED` markers, "Unconfirmed ?" prerequisites).
- Introduces a new dependency, target, or module.
- Refactors existing code beyond a one-line fix.
- Any M- or L-size task by your workflow's task-sizing convention, if it has one (touches ≥2 files, adds new behavior, or gets a spec/plan before code).
Subagent MAY skip this skill for trivial one-line fixes, pure typo corrections, or documentation copy edits.
## File layout
Path: `meetings/{YYYY-MM-DD}_{topic}.impl-notes.md`
Paired naming with the phase meeting log. If the phase log is `meetings/2026-05-20_phase-11-foo.md`, the impl-notes is `meetings/2026-05-20_phase-11-foo.impl-notes.md`.
If multiple subagents work on the same topic on the same day, append a numeric suffix: `meetings/2026-05-20_topic.impl-notes.2.md`.
## File format