Skills

aid-update-cli

Frontmatter

name — aid-update-cli
description — Direct-entry Lite-path shortcut (Update an existing CLI command.) — skips the aid-describe interview/triage. Binds VERB=update ARTIFACT=cli and runs the shared shortcut engine, producing a fully-graded flattened Lite work that halts for approval. State machine: delegated to canonical/aid/templates/shortcut-engine.md (INTAKE -> CAPTURE -> SPEC -> PLAN -> DETAIL -> GATE -> APPROVAL-HALT).
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#L18

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

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

Source: canonical/aid/templates/shortcut-engine.md#L89 · full step: canonical/aid/templates/shortcut-engine.md#L215-L354

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#L90 · full step: canonical/aid/templates/shortcut-engine.md#L358-L442

5 · SPEC — Collapses Define + Specify. · step

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

Source: canonical/aid/templates/shortcut-engine.md#L91 · full step: canonical/aid/templates/shortcut-engine.md#L446-L492

6 · PLAN — Collapses Plan. · step

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

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

7 · DETAIL — Collapses Detail. · step

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

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

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#L94 · full step: canonical/aid/templates/shortcut-engine.md#L672-L843

9 · Circuit breaker · exit · HALT

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

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

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

| APPROVAL-HALT | below | inline | HALT |

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

Report an issue with this page →