noteslisted

# Notes — Plan Deviation Log (Implementation Notes) When work hits a situation not in plan/spec (unknown), **do not decide arbitrarily and pass silently — log it**. Core device stopping agent from silently drifting off-plan. Origin: Implementation Notes — see skills/loop/references/talk-source.md. ## File Rules - Location: `IMPLEMENTATION_NOTES.md` at project root (create if missing). - **Persistence**: once the file exists or `init` has been run, appending to the file is mandatory — a chat-only summary does not satisfy the rule (the reminder hook, buy-in and quiz all read the file). With no file, a chat summary is allowed, but the final message must then say there is no notes file. - Argument `init`: create the file — heading `# Implementation Notes — plan deviation log`, then a commented-out copy of Entry Format as the template. Then offer (never write silently) to append a 3–5 line deviation-log rule — log criteria, escalation, file path — to the project's `CLAUDE.md` or `.claude/rules/unknowns.md`, so the rule is in context for every later session, not only when this skill is invoked. - Argument `show`: summarize current notes. - Any other text: append an entry using that text as **Situation found**, filling remaining fields from context; ask only about what context cannot supply. - No argument: log the most recent unplanned decision of this session, or state that there is none. ## Entry Format Deviation entry: ```markdown ## [YYYY-MM-DD] <task/feature name> - **Sit