Skip to content

JPeetz/agent-skills / skills/development/finding-unknowns/skills/implementation-notes

implementation-notes

Unverified

Use when implementing against an agreed plan or spec.

Implementation notes

No amount of planning removes every unknown; some only appear once the code is open. When the territory disagrees with the plan, don't stop and don't silently improvise — take the conservative option, write it down, and keep going. The notes file is how the next attempt learns from this one.

Steps

  1. At the start of the build, create implementation-notes.md with three headings: Deviations, Discovered edge cases, Questions for review.
  2. Whenever reality forces a choice the plan didn't cover:
    • pick the conservative option (the one that's easiest to reverse),
    • log it under Deviations: what the plan said, what was done instead, why, and what it would take to revisit,
    • continue working. Do not block on the user for reversible decisions.
  3. Log edge cases as they're found, even ones handled cleanly — they are exactly the unknowns the next plan should account for.
  4. Anything irreversible or scope-changing goes under Questions for review AND stops the work at a safe checkpoint. Deviating conservatively is fine; deviating expensively needs a human.
  5. At the end, append a five-line summary: deviations count, the one most likely to be revisited, edge cases found, and what the next session should read first. Reference the file in the handoff or PR.

Guardrails

  • The notes file is temporary working memory, not documentation. Keep entries to 2-3 lines each.
  • Never let the notes drift from reality — an unlogged deviation is worse than no notes at all, because the file claims completeness.
  • "Conservative" means reversible, not necessarily simple.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall