Skills

aid-create-cicd

Frontmatter

name — aid-create-cicd
description — Realize a ready CI/CD seed from .aid/design/cicd.md into the project’s shipping (C8) Knowledge Base document — the pipeline stages and their order, the triggers, the environments and promotion between them, and the release flow. Use this skill when a CI/CD seed is ready and the project has no record of its delivery pipeline yet. It writes the KB record by default, and emits a workflow file only if you ask for one in that run. Creating the document also registers it, in the same run, which opts it into the Conformance Lane permanently — a choice you make by running this skill. To revise C8 content already committed use /aid-update-cicd; for a resource the pipeline ships to, /aid-create-infra or /aid-update-infra; for a data pipeline rather than a delivery one, /aid-create-data-pipeline or /aid-update-data-pipeline; to ship a built artifact now, /aid-deploy.
allowed-tools — Read, Glob, Grep, Bash, Write, Edit, Agent
argument-hint — [<direction>] — which parts of the CI/CD seed to realize

Definition: canonical/skills/aid-create-cicd/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(["INTAKE"])
  n2["CREATE"]
  n3["VERIFY"]
  n4["PRESENT<br/>hard stop -- the user decides"]
  n5(["DONE"])
  n1 --> n2
  n2 --> n3
  n3 -.-> n2
  n3 --> n4
  n4 --> n5
  class n1 aidEntry
  class n2 aidStep
  class n3 aidLoopBack
  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 · INTAKE · entry

## State: INTAKE

1. **Allocate** through the Work Initiation Gate exactly as the contract's Allocation rule
   requires (`canonical/skills/aid-design/SKILL.md` INTAKE step 4 is the shape), with
   `initiator: aid-create-cicd`. `phase` is not driven.
2. **Read the seed** at `.aid/design/cicd.md`.
3. **Resolve the destination by concern, not filename.** This skill binds concern **C8**
   (shipping & operation, `canonical/aid/templates/kb-authoring/concern-model.md`). The seed's
   `## Destination` names the resolved path; where it does not, resolve C8 against
   `.aid/settings.yml` `knowledge.doc_set`, falling back to the C8 row of
   `canonical/aid/templates/kb-authoring/domain-doc-matrix.md`, and confirm with the user. An
   ambiguous realization is **asked**, never picked silently.
4. **Read the whole destination** if it exists, and note its `source:` field.
5. **Ask whether the user also wants production config this run.** Emitting a workflow file
   is **opt-in per run and never the default**; the KB record is what this skill writes
   unless the user asks in this run.
6. **Classify complexity** for the `aid-architect` dispatch (verifier tier >= producer).

Source: canonical/skills/aid-create-cicd/SKILL.md#L41-L57 · full step: canonical/skills/aid-create-cicd/SKILL.md#L41-L59

2 · CREATE · step

## State: CREATE

**Exactly three conditions refuse. There is no fourth.**

Source: canonical/skills/aid-create-cicd/SKILL.md#L63-L65 · full step: canonical/skills/aid-create-cicd/SKILL.md#L63-L97

3 · VERIFY · loop-back

## State: VERIFY

**Full verify**, as `design-lifecycle.md` defines it. Not clean -> loop to CREATE; the
3-cycle circuit breaker there escalates to IMPEDIMENT + `lifecycle: Blocked`.

Source: canonical/skills/aid-create-cicd/SKILL.md#L101-L104 · full step: canonical/skills/aid-create-cicd/SKILL.md#L101-L106

4 · PRESENT — hard stop — the user decides · step

## State: PRESENT (hard stop -- the user decides)

Set `lifecycle: Paused-Awaiting-Input`. Present the realized document and assert: whether a
workflow file was emitted and that it was asked for; on the creation path both registration
surfaces were written; and anything routed to `/aid-update-cicd` is named.

Source: canonical/skills/aid-create-cicd/SKILL.md#L110-L114 · full step: canonical/skills/aid-create-cicd/SKILL.md#L110-L116

5 · DONE · exit · UNSPECIFIED

## State: DONE

Set `lifecycle: Completed`, `updated` now, append a `## Lifecycle History` row.

Source: canonical/skills/aid-create-cicd/SKILL.md#L120-L122 · full step: canonical/skills/aid-create-cicd/SKILL.md#L120-L122

Report an issue with this page →