agent-impl-notes-log

Solid

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.

AI & Automation 19 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
43
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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. ## 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 M- or L-size task under `ai-collaboration-mode` (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 ```markdown # Impl Notes — {topic} ({date}) Status: IN_PROGRESS Owner: {subagent type, e.g. "Senior Developer"} Dispa...

Details

Author
wei18
Repository
wei18/apple-dev-skills
Created
2 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category