Skills

aid-update-cli

Frontmatter

name — aid-update-cli
description — Update an existing CLI command. Use this skill when you already know what to update and want it scoped, specified, and broken into reviewable tasks in a single pass, with no requirements interview. You approve the resulting plan before anything is built: this skill plans and stops, so run /aid-execute to carry the plan out.
allowed-tools — Read, Glob, Grep, Bash, Write, Edit, Agent
argument-hint — [description] — what to update; runs straight to a graded flattened Lite work

Definition: canonical/skills/aid-update-cli/SKILL.md

Flow

flowchart TB
  classDef aidNode color:#fff
  classDef aidEntry fill:#166534,stroke:#14532d,color:#fff
  classDef aidExit fill:#991b1b,stroke:#7f1d1d,color:#fff
  classDef aidDecision fill:#92400e,stroke:#78350f,color:#fff
  classDef aidLoopBack fill:#1e3a8a,stroke:#1e3a8a,color:#fff
  classDef aidStep fill:#1a2035,stroke:#d4a853,color:#f1f5f9
  n1(["aid-update-cli<br/>Bind VERB=update, ARTIFACT=cli"])
  n2{"INTAKE"}
  n3(["CONTINUATION"])
  n4["CAPTURE<br/>Collapses Describe."]
  n5["SPEC<br/>Collapses Define + Specify."]
  n6["PLAN<br/>Collapses Plan."]
  n7["DETAIL<br/>Collapses Detail."]
  n8{"GATE"}
  n9(["Circuit breaker"])
  n10(["APPROVAL-HALT<br/>Terminal state (FR-10 / NFR-10)."])
  n1 --> n2
  n2 -->|"On continuation"| n3
  n2 -->|"On new work"| n4
  n4 --> n5
  n5 --> n6
  n6 --> n7
  n7 --> n8
  n8 --- n8
  n8 -->|"If the pass's grade has not improved across 3 consecutive cycles"| n9
  n8 --> n10
  class n1 aidEntry
  class n2 aidDecision
  class n3 aidExit
  class n4 aidStep
  class n5 aidStep
  class n6 aidStep
  class n7 aidStep
  class n8 aidDecision
  class n9 aidExit
  class n10 aidExit
  class n1 aidNode
  class n2 aidNode
  class n3 aidNode
  class n4 aidNode
  class n5 aidNode
  class n6 aidNode
  class n7 aidNode
  class n8 aidNode
  class n9 aidNode
  class n10 aidNode

Source fragments

Every node in the chart above, in chart order, with the exact canonical/ text it was derived from.

1 · aid-update-cli — Bind VERB=update, ARTIFACT=cli · entry

Bind **VERB=`update`**, **ARTIFACT=`cli`**, then run the shared engine at `canonical/aid/templates/shortcut-engine.md`. The engine scaffolds the flattened Lite work (feature-001 structure), authors REQUIREMENTS -> SPEC -> PLAN + BLUEPRINT -> DETAIL tasks with reduced capture, runs the per-document Grading Gates (feature-004), and halts at the FR-10 approval gate. It never executes. This shortcut's `default_type`/`group` are its row in `canonical/aid/templates/shortcut-catalog.yml`.

Source: canonical/skills/aid-update-cli/SKILL.md#L16

2 · INTAKE — parse the bound invocation values; resolve the catalog row… · decision

| INTAKE | below | inline | CHAIN -> CAPTURE |

Source: canonical/aid/templates/shortcut-engine.md#L92 · full step: canonical/aid/templates/shortcut-engine.md#L222-L362

3 · CONTINUATION · exit · HALT

### 3b. CONTINUATION -> route to the chosen work's resume entry point, then STOP

Source: canonical/aid/templates/work-initiation-gate.md#L129

4 · CAPTURE — Collapses Describe. · step

| CAPTURE | below | `aid-architect` (Large) | CHAIN -> SPEC |

Source: canonical/aid/templates/shortcut-engine.md#L93 · full step: canonical/aid/templates/shortcut-engine.md#L366-L461

5 · SPEC — Collapses Define + Specify. · step

| SPEC | below | `aid-architect` (Large) | CHAIN -> PLAN |

Source: canonical/aid/templates/shortcut-engine.md#L94 · full step: canonical/aid/templates/shortcut-engine.md#L465-L516

6 · PLAN — Collapses Plan. · step

| PLAN | below | `aid-architect` (Large) | CHAIN -> DETAIL |

Source: canonical/aid/templates/shortcut-engine.md#L95 · full step: canonical/aid/templates/shortcut-engine.md#L520-L606

7 · DETAIL — Collapses Detail. · step

| DETAIL | below | `aid-architect` (Large) | CHAIN -> GATE |

Source: canonical/aid/templates/shortcut-engine.md#L96 · full step: canonical/aid/templates/shortcut-engine.md#L610-L708

8 · GATE — Runs feature-004’s two batched Grading-Gate passes over the… · decision

| GATE | below | `aid-reviewer` (Large) | CHAIN -> APPROVAL-HALT |

Source: canonical/aid/templates/shortcut-engine.md#L97 · full step: canonical/aid/templates/shortcut-engine.md#L710-L892

9 · Circuit breaker · exit · HALT

   **Circuit breaker.** If the pass's grade has not improved across 3

Source: canonical/aid/templates/shortcut-engine.md#L848

10 · APPROVAL-HALT — Terminal state (FR-10 / NFR-10). · exit · HALT

| APPROVAL-HALT | below | inline | HALT |

Source: canonical/aid/templates/shortcut-engine.md#L98 · full step: canonical/aid/templates/shortcut-engine.md#L896-L944

Report an issue with this page →