docs: add draw.io flow diagram for the skill

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+### Added (flow diagram)
+- `docs/linear-issue-craft-flow.drawio`: a one-page draw.io map of the skill end to end (trigger, classify archetype + detect mode, draft, the three gates / save-hook, file), plus the downstream compiler pipeline it feeds and the nine golden rules. Themed to match the house palette. Linked from the README.
+
 ### Added (save-hook: weld the boundary)
 - `hooks/validate-issue-on-save.sh`: a Claude Code PreToolUse hook for `mcp__linear__save_issue` that runs the Gate-1 validator at the tool boundary, so the check cannot be skipped on the headless batch-filing path (a PreToolUse hook fires for subagent tool calls too). Create-only (an update with an `id` is left alone, so the pre-Anchor corpus is never orphaned); build-lane scoped (governance labels `human`/`eval` exempt); `observe` by default (logs would-blocks, allows) and `enforce` on an operator flip (denies with the validator's re-fileable output via `permissionDecision: deny`). Fails open on any unexpected input. On a create, a missing or prose-shaped Anchor is promoted from WARN to a block. `hooks/README.md` documents install + the operator-owned enforce flip (gated on a clean corpus replay); `hooks/test_hook.sh` covers the decision matrix (7 cases).
 

README.md

@@ -26,6 +26,10 @@ skill/
     └── issue-reviewer.md         Gate 3: independent reviewer subagent template
 ```
 
+## Flow diagram
+
+`docs/linear-issue-craft-flow.drawio` is a one-page map of what the skill does end to end: trigger, classify the archetype and detect the mode, draft, clear the gates (or the save-hook in headless mode), then file. It also shows the downstream compiler pipeline the issue feeds and the nine golden rules. Open it at [app.diagrams.net](https://app.diagrams.net) or with the draw.io VS Code extension.
+
 ## The archetypes
 
 | Archetype | Title shape | Body sections |