feat(plugins): every skill says when its own work is done

plugins/aidd-context/skills/00-onboard/SKILL.md

@@ -30,3 +30,17 @@ Run the actions in that order, looping. Read an action's file in `actions/` befo
 - Never test a plugin version against a registry.
 - Never trust a stale status.
 - Wait for an explicit reply before running anything.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:00-onboard"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/01-bootstrap/SKILL.md

@@ -37,3 +37,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 
 - `assets/checklist.md` - the 24-item checklist (4 blocks)
 - `assets/install-template.md` - the `INSTALL.md` skeleton
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:01-bootstrap"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/02-project-memory/SKILL.md

@@ -31,3 +31,17 @@ Run the flow above, reading only the next action file.
 - Ask before anything ambiguous. Never default silently.
 - A bank that already exists changes only through what the user approved, file by file and line by line.
 - End with a short report of what changed.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:02-project-memory"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/03-context-generate/SKILL.md

@@ -19,3 +19,17 @@ Routes a generation request to the dedicated generator for the artifact kind. Ho
 | hook     | `aidd-context:08-hook-generate`  |
 
 Identify the artifact kind from the request, then hand off to the matching generator. If the kind is unclear, ask which one. To survey or list existing artifacts, use the explore skill instead.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:03-context-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/04-skill-generate/SKILL.md

@@ -29,3 +29,17 @@ Run the flow above. Read only the next action file.
 - If a cited reference cannot be read, stop and report the missing file.
 - Confirm every target and name with the user.
 - Never write silently.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:04-skill-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/05-rule-generate/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## Assets
 
 - `assets/rule-template.md`: rule file scaffold.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:05-rule-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/06-agent-generate/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## Assets
 
 - `assets/agent-template.md`: agent file scaffold.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:06-agent-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/07-command-generate/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## Assets
 
 - `assets/command-template.md`: command file scaffold.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:07-command-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/08-hook-generate/SKILL.md

@@ -28,3 +28,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 
 - `assets/hook-template.json`: the entry scaffold.
 - `assets/hook-script-template.sh`: the backing-script scaffold.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:08-hook-generate"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/09-mermaid/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## References
 
 - `references/mermaid-conventions.md`: the conventions and defaults every generated diagram follows.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:09-mermaid"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/10-learn/SKILL.md

@@ -33,3 +33,17 @@ Run the flow above. Read only the next action file.
 - Write only the user-approved plan.
 - Preserve user edits and touch affected files only.
 - Write project files only, never personal or global memory.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:10-learn"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/11-explore/SKILL.md

@@ -37,3 +37,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## References
 
 - `references/ai-mapping.md`: the per-tool signals, scan paths, and formats for the Tooling and Context axes.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:11-explore"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-context/skills/12-cook/SKILL.md

@@ -29,3 +29,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 
 - `assets/recipe-template.md`: the canonical recipe scaffold `upsert` renders from, and the shape `list` parses.
 - `assets/recipes/`: bundled recipes shipped with this skill.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-context:12-cook"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/02-implement/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## References
 
 - `references/blocked.md`: the conditions that make a plan `blocked` and need a human.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:02-implement"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/03-assert/SKILL.md

@@ -29,3 +29,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## Assets
 
 - `assets/task-template.md`: the tracking file the frontend facet fills across its fix loop.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:03-assert"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/04-audit/SKILL.md

@@ -35,3 +35,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## Assets
 
 - `assets/audit-template.md`: the report structure both run modes fill.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:04-audit"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/05-review/SKILL.md

@@ -38,3 +38,17 @@ Run all three by default, composing one report. Run a single axis only when the
 
 - `assets/review-template.md`: the single report the three axes fill.
 - `assets/review-validator.yml`: the closed set of report sections.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:05-review"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/06-test/SKILL.md

@@ -24,3 +24,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 - One action per run: follow only the matching action file.
 - Functional behavior only: never couple a test to implementation details.
 - Never compromise quality for speed.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:06-test"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/07-refactor/SKILL.md

@@ -27,3 +27,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 - Audit-fed, optional: when the caller pushes an audit report (a path under `aidd_docs/tasks/audits/` or pasted findings), take its findings for this axis as the fix list and skip the scan. The bridge is the report artifact; this skill never loads or calls another skill. The audit `code-quality` pillar feeds the `cleanup` axis; the other axes map by name.
 - Severity uses the shared 3-level scale: 🔴 critical, 🟡 warning, 🟢 minor.
 - Stay inside the axis: dependency upgrades and UI redesign are out of scope. Add tests only as a regression for a security fix, never otherwise.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:07-refactor"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/08-debug/SKILL.md

@@ -32,3 +32,17 @@ Pick the one action matching the intent; never default to `01`. Triggers like "r
 ## References
 
 - `references/mermaid-conventions.md`: the project's Mermaid conventions for the action-path flowchart.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:08-debug"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/09-for-sure/SKILL.md

@@ -35,3 +35,17 @@ Before running an action, read its file in `actions/`, not only the table or ass
 ## References
 
 - `references/autonomous-loop-log-format.md`: the Log entry format the loop appends per attempt.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:09-for-sure"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.

plugins/aidd-dev/skills/10-todo/SKILL.md

@@ -15,3 +15,17 @@ actions/01-todo.md
 ```
 
 Before running an action, read its file in `actions/`, not only the table or assets.
+
+## Say when this skill's work is done
+
+Once this skill has produced what it was called for, and only then, run:
+
+```shell
+echo "aidd:step-end aidd-dev:10-todo"
+```
+
+No host reports when a skill's work finished. A skill call's own result comes back in a
+tenth of a second, which is the dispatch and not the completion, so a measurement that
+never hears this ends the step where the next one begins — or, where none follows, at the
+journal's own last witnessed moment, which credits this skill with everything the session
+did afterwards.