← ClaudeAtlas

agent-impl-notes-loglisted

Maintain a running `meetings/{date}_{topic}.impl-notes.md` *during* subagent task execution to capture in-flight design decisions, intentional deviations from spec, considered alternatives, and open questions for Leader/User. Distinct from the post-hoc phase meeting log; this file is updated incrementally as decisions are made. Invoke at the start of any non-trivial subagent dispatch, when ambiguity is encountered mid-task, or when about to deviate from spec.
wei18/apple-dev-skills · ★ 0 · AI & Automation · score 70
Install: claude install-skill wei18/apple-dev-skills
# Agent Implementation Notes — Running Log ## 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. The user explicitly asked for this: > 在你進行工作的同時,維護一個名為 implementation-notes.md 的持續更新檔案,記錄任何我應該知道的,關於實作如何偏離或詮釋規格的事項。 ## When to invoke Subagent MUST invoke this skill at the start of any dispatch matching ANY of: - Touches more than 3 files in production code. - 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 task with a `PROPOSAL_DRAFT` step in the AI Collaboration Mode workflow. 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 ```markdown # Impl Notes — {topic} ({date}) St