implementation-noteslisted
Install: claude install-skill to4iki/skills
# Implementation Notes
Implement the spec and keep `implementation-notes.html` updated as you go so the user can follow how the implementation interprets, decides on, and diverges from the spec without reading every diff.
## Invocation
```
/implementation-notes <SPEC>
```
`<SPEC>` is what to implement — a file path, URL, issue/PR reference, or inline requirements in the same message.
If the user invokes the skill without `<SPEC>`, ask what to implement before coding.
## Notes file
- Default: `implementation-notes.html` at the project root (self-contained; no external assets).
- Purpose: leave a human-readable HTML file that lets the user review spec interpretation, implementation differences, and open questions.
- Capture anything the implementation diverges from, interprets, or adds to the spec as notes the user should know about.
Capture as you work — not only at the end — especially:
- Design decisions: choices you made where the spec was ambiguous
- Deviations: places where you intentionally departed from the spec, and why
- Tradeoffs: alternatives you considered and why you picked what you did
- Open questions: anything you'd want the user to confirm or revise
- Verification results (commands run and results)
Link to files; don't paste large code blocks.
## HTML usage
Do not make `implementation-notes.html` a plain text document wrapped in HTML. Use HTML, CSS, SVG, and JavaScript when they make the notes easier to review.
Read `references/html-output.md` whe