aitask-gate-docs-updatedlisted
Install: claude install-skill beyondeye/aitasks
## Purpose
This is the **verifier for the `docs_updated` gate** — a *procedure-backed*
(`kind: procedure`) gate. Unlike a command verifier (build/tests/lint), it is a
**skill run by the attended agent**: it inspects the task's change, updates the
project's user-facing / design documentation per the project's doc-update spec
(**confirming with the user**), and records the gate result in the ledger. The
headless engine (`ait gates run`) never executes this — it reports the gate as
`needs agent` and defers to the attended task-workflow / aitask-resume path, which
starts the run and Read-and-follows this skill.
This skill is **project-agnostic**: it reads *how* to update docs from the
project's configured guide (never from any framework-internal convention doc).
## Contract
**Invocation** (positional args, from the dispatch seam):
```
<task-id> <attempt> <run-id>
```
`<attempt>` and `<run-id>` are allocated by the dispatch seam via
`aitask_gate.sh begin-procedure <task-id> docs_updated` (which already opened the
`running` block). **Reuse `<run-id>` verbatim** when appending the terminal block.
Do **not** invent these values.
**Terminal status semantics (record exactly one):**
| Status | When |
|--------|------|
| `pass` | The procedure **performed the required doc work**, OR inspected the doc-relevant surfaces and **confirmed the existing docs are already correct**. |
| `skip` | The procedure **evaluated the task and concluded `docs_updated` is not applicable** to this ch