diff --git a/CHANGELOG.md b/CHANGELOG.md index 86db81a..7b7e537 100644 --- a/CHANGELOG.md +++ b/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). diff --git a/README.md b/README.md index 21f3592..7f46169 100644 --- a/README.md +++ b/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 | diff --git a/docs/linear-issue-craft-flow.drawio b/docs/linear-issue-craft-flow.drawio new file mode 100644 index 0000000..654f3ed --- /dev/null +++ b/docs/linear-issue-craft-flow.drawio @@ -0,0 +1,246 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +