Skills

aid-housekeep

Frontmatter

name — aid-housekeep
description — Sweep the project back into a consistent state after work has landed. Use this skill when the Knowledge Base has drifted from the code, the generated summary is stale, or work-area artifacts have piled up. It runs three gated jobs in order: re-discovering KB docs that changed since the last approval, regenerating the visual summary if the KB moved, and clearing stale work-area artifacts. Forward-authored greenfield docs take the Conformance Lane, which flags design-versus-as-built divergence for you to reconcile and never overwrites the design itself. Each stage commits on its own branch and nothing is pushed; a stalled run resumes where it stopped. This is the source-driven global reconcile — for a targeted, prompt-named delta use /aid-update-kb.
allowed-tools — Read, Glob, Grep, Bash, Write, Edit, Agent
argument-hint — [—cleanup-only] [—grade X] jump to cleanup stage, or set minimum summary grade

Definition: canonical/skills/aid-housekeep/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(["PREFLIGHT<br/>PREFLIGHT is the synchronous gate that verifies all…"])
  n2(["KB-DELTA<br/>KB-DELTA is a lightweight, drift-focused re-discovery: you…"])
  n3(["SUMMARY-DELTA<br/>SUMMARY-DELTA checks whether kb.html needs to be…"])
  n4["CLEANUP<br/>CLEANUP is the terminal gated stage of /aid-housekeep."]
  n5(["DONE<br/>DONE is the terminal state."])
  n1 --> n2
  n1 --> n4
  n2 --> n3
  n3 --> n4
  n4 --> n5
  class n1 aidEntry
  class n2 aidExit
  class n3 aidExit
  class n4 aidStep
  class n5 aidExit
  class n1 aidNode
  class n2 aidNode
  class n3 aidNode
  class n4 aidNode
  class n5 aidNode

Source fragments

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

1 · PREFLIGHT — PREFLIGHT is the synchronous gate that verifies all… · entry

| PREFLIGHT | `references/state-preflight.md` | inline | CHAIN → KB-DELTA (or CLEANUP if Mode=cleanup-only) |

Source: canonical/skills/aid-housekeep/SKILL.md#L226 · full step: canonical/skills/aid-housekeep/references/state-preflight.md#L1-L118

2 · KB-DELTA — KB-DELTA is a lightweight, drift-focused re-discovery: you… · exit · PAUSE-FOR-USER-ACTION

| KB-DELTA | `references/state-kb-delta.md` | `aid-architect` (feat-002 dispatches sub-agents via `/aid-discover`) | CHAIN → SUMMARY-DELTA / PAUSE-FOR-USER-ACTION if stalled |

Source: canonical/skills/aid-housekeep/SKILL.md#L227 · full step: canonical/skills/aid-housekeep/references/state-kb-delta.md#L1-L887

3 · SUMMARY-DELTA — SUMMARY-DELTA checks whether kb.html needs to be… · exit · PAUSE-FOR-USER-ACTION

| SUMMARY-DELTA | `references/state-summary-delta.md` | inline (delegates to `/aid-summarize`) | CHAIN → CLEANUP / PAUSE-FOR-USER-ACTION if stalled |

Source: canonical/skills/aid-housekeep/SKILL.md#L228 · full step: canonical/skills/aid-housekeep/references/state-summary-delta.md#L1-L357

4 · CLEANUP — CLEANUP is the terminal gated stage of /aid-housekeep. · step

| CLEANUP | `references/state-cleanup.md` | inline | CHAIN → DONE |

Source: canonical/skills/aid-housekeep/SKILL.md#L229 · full step: canonical/skills/aid-housekeep/references/state-cleanup.md#L1-L535

5 · DONE — DONE is the terminal state. · exit · HALT

| DONE | `references/state-done.md` | inline | HALT |

Source: canonical/skills/aid-housekeep/SKILL.md#L230 · full step: canonical/skills/aid-housekeep/references/state-done.md#L1-L73

Report an issue with this page →