← ClaudeAtlas

agent-impl-notes-loglisted

Keep a running impl-notes file next to the phase meeting log while a subagent executes a task, recording design decisions, intentional deviations from spec, tradeoffs, and open questions as they happen rather than after the fact. Use at the start of any non-trivial subagent dispatch (multi-file change, ambiguous spec, new dependency or module, refactor), when ambiguity is hit mid-task, or before deviating from spec. Not the post-hoc meeting log (session-to-meeting-log); the two coexist.
wei18/apple-dev-skills · ★ 18 · AI & Automation · score 81
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