@ludecker/aaac 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -0
- package/package.json +38 -0
- package/src/cli.mjs +138 -0
- package/src/generators/generate-commands.mjs +165 -0
- package/src/generators/generate-graph-commands.mjs +63 -0
- package/src/generators/generate-graph.mjs +242 -0
- package/src/lib/copy.mjs +36 -0
- package/src/lib/install.mjs +76 -0
- package/src/lib/paths.mjs +54 -0
- package/templates/cursor/aaac/capabilities/registry.json +106 -0
- package/templates/cursor/aaac/contract-schema.md +66 -0
- package/templates/cursor/aaac/contracts/commands/create-module.yaml +28 -0
- package/templates/cursor/aaac/contracts/commands/fix-bug.yaml +32 -0
- package/templates/cursor/aaac/contracts/commands/update-module.yaml +28 -0
- package/templates/cursor/aaac/contracts/skills/impact-analysis.yaml +17 -0
- package/templates/cursor/aaac/contracts/skills/investigation-lite.yaml +17 -0
- package/templates/cursor/aaac/contracts/skills/investigation.yaml +17 -0
- package/templates/cursor/aaac/contracts/skills/validation.yaml +14 -0
- package/templates/cursor/aaac/dependencies.yaml +14 -0
- package/templates/cursor/aaac/dispatch.md +135 -0
- package/templates/cursor/aaac/fitness-functions.yaml +34 -0
- package/templates/cursor/aaac/governance/gates.json +39 -0
- package/templates/cursor/aaac/graph.project.yaml +161 -0
- package/templates/cursor/aaac/layers.md +93 -0
- package/templates/cursor/aaac/lifecycle/lifecycle.json +78 -0
- package/templates/cursor/aaac/lifecycle/phases.json +19 -0
- package/templates/cursor/aaac/ontology.json +219 -0
- package/templates/cursor/aaac/ontology.md +90 -0
- package/templates/cursor/aaac/project.config.json +3 -0
- package/templates/cursor/aaac/run/RUN.md +72 -0
- package/templates/cursor/aaac/run/schema.json +83 -0
- package/templates/cursor/aaac/state/checkpoints/README.md +20 -0
- package/templates/cursor/agents/boundary-review.md +11 -0
- package/templates/cursor/agents/check-capability-trace.md +18 -0
- package/templates/cursor/agents/dependency-analysis.md +11 -0
- package/templates/cursor/agents/discovery-boundaries.md +11 -0
- package/templates/cursor/agents/discovery-inventory.md +14 -0
- package/templates/cursor/agents/discovery-ssot.md +11 -0
- package/templates/cursor/agents/fallow-check-changed.md +9 -0
- package/templates/cursor/agents/impact-analysis.md +22 -0
- package/templates/cursor/agents/plan-layer-map.md +11 -0
- package/templates/cursor/agents/plan-state-machines.md +11 -0
- package/templates/cursor/agents/release-git.md +36 -0
- package/templates/cursor/agents/system-decomposition.md +11 -0
- package/templates/cursor/agents/unit-test-run.md +19 -0
- package/templates/cursor/policies/implementation.md +8 -0
- package/templates/cursor/policies/master-rules.md +7 -0
- package/templates/cursor/skills/shared/api/SKILL.md +26 -0
- package/templates/cursor/skills/shared/architecture/SKILL.md +25 -0
- package/templates/cursor/skills/shared/architecture/orchestrator/SKILL.md +21 -0
- package/templates/cursor/skills/shared/architecture/refactor-analysis.md +302 -0
- package/templates/cursor/skills/shared/check/SKILL.md +47 -0
- package/templates/cursor/skills/shared/component/SKILL.md +24 -0
- package/templates/cursor/skills/shared/dependency-graph/SKILL.md +38 -0
- package/templates/cursor/skills/shared/discovery/SKILL.md +29 -0
- package/templates/cursor/skills/shared/documentation/SKILL.md +21 -0
- package/templates/cursor/skills/shared/documentation/orchestrator/SKILL.md +26 -0
- package/templates/cursor/skills/shared/documentation/orchestrator/contract.yaml +20 -0
- package/templates/cursor/skills/shared/documentation/write-arch-doc.md +168 -0
- package/templates/cursor/skills/shared/domain/SKILL.md +24 -0
- package/templates/cursor/skills/shared/execution/SKILL.md +34 -0
- package/templates/cursor/skills/shared/fitness-functions/SKILL.md +42 -0
- package/templates/cursor/skills/shared/governance/implementation/SKILL.md +424 -0
- package/templates/cursor/skills/shared/impact-analysis/SKILL.md +44 -0
- package/templates/cursor/skills/shared/integration/SKILL.md +22 -0
- package/templates/cursor/skills/shared/investigation/SKILL.md +46 -0
- package/templates/cursor/skills/shared/investigation/orchestrator/SKILL.md +22 -0
- package/templates/cursor/skills/shared/investigation-lite/SKILL.md +38 -0
- package/templates/cursor/skills/shared/migration/SKILL.md +22 -0
- package/templates/cursor/skills/shared/model/SKILL.md +22 -0
- package/templates/cursor/skills/shared/module-authoring/SKILL.md +29 -0
- package/templates/cursor/skills/shared/module-authoring/authoring-template.md +9 -0
- package/templates/cursor/skills/shared/planning/SKILL.md +30 -0
- package/templates/cursor/skills/shared/platform-release/SKILL.md +46 -0
- package/templates/cursor/skills/shared/platform-release/orchestrator/SKILL.md +51 -0
- package/templates/cursor/skills/shared/platform-release/orchestrator/contract.yaml +29 -0
- package/templates/cursor/skills/shared/platform-release/ship-procedure.md +31 -0
- package/templates/cursor/skills/shared/remove/SKILL.md +28 -0
- package/templates/cursor/skills/shared/reporting/SKILL.md +43 -0
- package/templates/cursor/skills/shared/rollback/SKILL.md +46 -0
- package/templates/cursor/skills/shared/root-cause/SKILL.md +24 -0
- package/templates/cursor/skills/shared/run/SKILL.md +64 -0
- package/templates/cursor/skills/shared/schema/SKILL.md +24 -0
- package/templates/cursor/skills/shared/testing/SKILL.md +24 -0
- package/templates/cursor/skills/shared/testing/orchestrator/SKILL.md +22 -0
- package/templates/cursor/skills/shared/validation/SKILL.md +56 -0
- package/templates/cursor/skills/shared/verbs/_dispatch-utils.md +90 -0
- package/templates/cursor/skills/shared/verbs/_lifecycle.md +87 -0
- package/templates/cursor/skills/shared/verbs/_object-skills.md +60 -0
- package/templates/cursor/skills/shared/verbs/check/orchestrator/SKILL.md +22 -0
- package/templates/cursor/skills/shared/verbs/check/orchestrator/contract.yaml +24 -0
- package/templates/cursor/skills/shared/verbs/create/orchestrator/SKILL.md +39 -0
- package/templates/cursor/skills/shared/verbs/create/orchestrator/contract.yaml +34 -0
- package/templates/cursor/skills/shared/verbs/fix/orchestrator/SKILL.md +33 -0
- package/templates/cursor/skills/shared/verbs/fix/orchestrator/contract.yaml +38 -0
- package/templates/cursor/skills/shared/verbs/release/orchestrator/SKILL.md +29 -0
- package/templates/cursor/skills/shared/verbs/release/orchestrator/contract.yaml +25 -0
- package/templates/cursor/skills/shared/verbs/remove/orchestrator/SKILL.md +25 -0
- package/templates/cursor/skills/shared/verbs/remove/orchestrator/contract.yaml +32 -0
- package/templates/cursor/skills/shared/verbs/review/orchestrator/SKILL.md +24 -0
- package/templates/cursor/skills/shared/verbs/review/orchestrator/contract.yaml +25 -0
- package/templates/cursor/skills/shared/verbs/test/orchestrator/SKILL.md +24 -0
- package/templates/cursor/skills/shared/verbs/test/orchestrator/contract.yaml +25 -0
- package/templates/cursor/skills/shared/verbs/update/orchestrator/SKILL.md +34 -0
- package/templates/cursor/skills/shared/verbs/update/orchestrator/contract.yaml +34 -0
- package/templates/cursor/skills/shared/verification/SKILL.md +28 -0
- package/templates/cursor/skills/shared/workflow/SKILL.md +25 -0
- package/templates/docs/agentic_architecture.md +131 -0
- package/templates/docs/architecture.md +5 -0
- package/templates/docs/master_rules.md +5 -0
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# Verb orchestrator utilities (internal)
|
|
2
|
+
|
|
3
|
+
Graph paths (`agents/`, `policies/`, `skills/`, `domains/`) are relative to **`.cursor/`**.
|
|
4
|
+
|
|
5
|
+
## Lifecycle (create / update / fix)
|
|
6
|
+
|
|
7
|
+
**Work SSOT:** [lifecycle/lifecycle.json](../../../aaac/lifecycle/lifecycle.json) `work_phases`
|
|
8
|
+
**Gates SSOT:** [governance/gates.json](../../../aaac/governance/gates.json)
|
|
9
|
+
**Runtime:** graph `verb_runtime` — composed on Run at dispatch
|
|
10
|
+
**Run protocol:** [run/SKILL.md](../../run/SKILL.md) + [_lifecycle.md](./_lifecycle.md)
|
|
11
|
+
|
|
12
|
+
Orchestrators execute phases from the Run `pending` queue. Do not skip gates unless user explicitly approves blocked run (record in Run `decisions[]`).
|
|
13
|
+
|
|
14
|
+
## Load policies (every orchestrator)
|
|
15
|
+
|
|
16
|
+
Read before any phase:
|
|
17
|
+
|
|
18
|
+
1. [.cursor/policies/master-rules.md](../../../policies/master-rules.md)
|
|
19
|
+
2. [.cursor/policies/implementation.md](../../../policies/implementation.md)
|
|
20
|
+
3. [.cursor/policies/mcp-and-deploy.md](../../../policies/mcp-and-deploy.md)
|
|
21
|
+
|
|
22
|
+
## Confidence gates
|
|
23
|
+
|
|
24
|
+
Before `execute`, [validation](../../validation/SKILL.md) must pass:
|
|
25
|
+
|
|
26
|
+
| Dimension | Min |
|
|
27
|
+
|-----------|-----|
|
|
28
|
+
| architecture | 0.9 |
|
|
29
|
+
| requirements | 0.8 |
|
|
30
|
+
| scope | 0.8 |
|
|
31
|
+
|
|
32
|
+
Below threshold → set Run `status: blocked`, `awaiting_approval: true`, **STOP**
|
|
33
|
+
|
|
34
|
+
## Object maturity
|
|
35
|
+
|
|
36
|
+
From `object_maturity.<object>` + `maturity_rules`:
|
|
37
|
+
|
|
38
|
+
| Level | Extra phases |
|
|
39
|
+
|-------|----------------|
|
|
40
|
+
| protected | impact_analysis, dependency_graph, rollback (mandatory) |
|
|
41
|
+
| critical | impact_analysis, dependency_graph |
|
|
42
|
+
| stable | impact_analysis on fix |
|
|
43
|
+
| evolving | verb lifecycle only |
|
|
44
|
+
|
|
45
|
+
## Load domain inventory
|
|
46
|
+
|
|
47
|
+
When `$DOMAIN` slug maps to `domains/<slug>/update/inventory/SKILL.md`:
|
|
48
|
+
|
|
49
|
+
1. Read inventory **first** (constraints, out-of-scope, file map)
|
|
50
|
+
2. Pass inventory constraints into discovery, investigation-lite/investigation, planning, validation, execution, verification
|
|
51
|
+
|
|
52
|
+
If inventory missing and command is `fix-bug` / `create-feature` / `update-module`:
|
|
53
|
+
|
|
54
|
+
- Run [module-authoring](../../module-authoring/SKILL.md) discovery to bootstrap domain, **or**
|
|
55
|
+
- Tell user to use generic verb command with intent
|
|
56
|
+
|
|
57
|
+
## Dependency graph
|
|
58
|
+
|
|
59
|
+
Before execute: [dependency-graph](../../dependency-graph/SKILL.md) resolves [dependencies.yaml](../../../aaac/dependencies.yaml) — not inventory alone.
|
|
60
|
+
|
|
61
|
+
## Load object skills
|
|
62
|
+
|
|
63
|
+
From [graph.yaml](../../../aaac/graph.yaml):
|
|
64
|
+
|
|
65
|
+
1. Read `commands.<cmd>.object`
|
|
66
|
+
2. Load every skill in `object_skills.<object>`
|
|
67
|
+
3. Load extra skills from `object_skill_verbs.<object>.<verb>` when present
|
|
68
|
+
|
|
69
|
+
See [_object-skills.md](./_object-skills.md) for verb-specific notes.
|
|
70
|
+
|
|
71
|
+
## Investigation depth
|
|
72
|
+
|
|
73
|
+
| Verb | Skill |
|
|
74
|
+
|------|-------|
|
|
75
|
+
| create, update | [investigation-lite](../../investigation-lite/SKILL.md) |
|
|
76
|
+
| fix, fix_mode | [investigation](../../investigation/SKILL.md) → [root-cause](../../root-cause/SKILL.md) |
|
|
77
|
+
|
|
78
|
+
Never skip investigation-lite on update because "change looks small."
|
|
79
|
+
|
|
80
|
+
## Pre-execute gate stack (not lifecycle work)
|
|
81
|
+
|
|
82
|
+
After `plan`, before `execute` — **gate** phases from [governance/gates.json](../../../aaac/governance/gates.json):
|
|
83
|
+
|
|
84
|
+
1. validate
|
|
85
|
+
2. impact_analysis
|
|
86
|
+
3. dependency_graph
|
|
87
|
+
4. fitness_functions
|
|
88
|
+
5. rollback (when required by maturity or impact)
|
|
89
|
+
|
|
90
|
+
On gate fail: block Run, await human approval. See [validation](../../validation/SKILL.md).
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Verb lifecycle (SSOT)
|
|
2
|
+
|
|
3
|
+
**Lifecycle = work.** **Gates = approval/checkpoints.** They are separate SSOTs, composed at runtime.
|
|
4
|
+
|
|
5
|
+
| SSOT | Path | Contains |
|
|
6
|
+
|------|------|----------|
|
|
7
|
+
| Work phases | [lifecycle/lifecycle.json](../../lifecycle/lifecycle.json) | `verbs.*.work_phases` |
|
|
8
|
+
| Gate stacks | [governance/gates.json](../../governance/gates.json) | `stacks.*` |
|
|
9
|
+
| Runtime (composed) | [graph.yaml](../../graph.yaml) `verb_runtime` | work through plan + gates + execute onward |
|
|
10
|
+
| Run | [run/schema.json](../../run/schema.json) | Primary execution object |
|
|
11
|
+
|
|
12
|
+
Phase id → skill mapping: **[lifecycle/phases.json](../../lifecycle/phases.json)**
|
|
13
|
+
|
|
14
|
+
Responsibility layers: **[layers.md](../../layers.md)**
|
|
15
|
+
|
|
16
|
+
## Mental model
|
|
17
|
+
|
|
18
|
+
```text
|
|
19
|
+
Run
|
|
20
|
+
work: discover → investigate* → plan
|
|
21
|
+
gates: validate → impact → deps → fitness → rollback
|
|
22
|
+
work: execute → verify → report
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Everything executes within a Run. Observability (`decisions`, `log`, `checkpoints`) lives on the Run — no standalone logging.
|
|
26
|
+
|
|
27
|
+
## Phase → skill map
|
|
28
|
+
|
|
29
|
+
| Phase | Kind | Skill |
|
|
30
|
+
|-------|------|-------|
|
|
31
|
+
| `discover` | work | discovery |
|
|
32
|
+
| `investigate_lite` | work | investigation-lite |
|
|
33
|
+
| `investigate` | work | investigation |
|
|
34
|
+
| `root_cause` | work | root-cause |
|
|
35
|
+
| `plan` | work | planning |
|
|
36
|
+
| `validate` | gate | validation |
|
|
37
|
+
| `impact_analysis` | gate | impact-analysis |
|
|
38
|
+
| `dependency_graph` | gate | dependency-graph |
|
|
39
|
+
| `fitness_functions` | gate | fitness-functions |
|
|
40
|
+
| `rollback` | gate | rollback |
|
|
41
|
+
| `execute` | work | execution |
|
|
42
|
+
| `verify` | work | testing + verification |
|
|
43
|
+
| `report` | work | reporting |
|
|
44
|
+
|
|
45
|
+
## Verb work phases (from lifecycle.json)
|
|
46
|
+
|
|
47
|
+
| Verb | Work | Gate stack |
|
|
48
|
+
|------|------|------------|
|
|
49
|
+
| create | discover → investigate_lite → plan → execute → verify → report | pre_execute |
|
|
50
|
+
| update | same | pre_execute |
|
|
51
|
+
| fix | discover → investigate → root_cause → plan → execute → verify → report | pre_execute |
|
|
52
|
+
| review | discover → plan → report | none |
|
|
53
|
+
| check | discover → report | pre_execute_minimal |
|
|
54
|
+
| test | discover → plan → verify → report | none |
|
|
55
|
+
| release | execute → verify → report | release |
|
|
56
|
+
| remove | same as update | pre_execute |
|
|
57
|
+
|
|
58
|
+
## Capability routing
|
|
59
|
+
|
|
60
|
+
Objects declare **capabilities** in ontology (`object_capabilities`). The registry resolves providers:
|
|
61
|
+
|
|
62
|
+
```text
|
|
63
|
+
object → capability → provider (skill | mcp | expert)
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
Graph `object_skills` includes **skill-type** providers only. MCP providers are recorded on Run `capabilities_resolved` and `decisions[]`. Do not hardcode provider names in orchestrators.
|
|
67
|
+
|
|
68
|
+
## Human approval
|
|
69
|
+
|
|
70
|
+
Gate failure or low confidence → Run:
|
|
71
|
+
|
|
72
|
+
```yaml
|
|
73
|
+
status: blocked
|
|
74
|
+
awaiting_approval: true
|
|
75
|
+
blocked_reason: "…"
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
STOP until user approves. Record approval in `decisions[]`.
|
|
79
|
+
|
|
80
|
+
## Escalation
|
|
81
|
+
|
|
82
|
+
If gate fails and user has not approved:
|
|
83
|
+
|
|
84
|
+
```text
|
|
85
|
+
STOP — awaiting approval
|
|
86
|
+
Run: {run_id}
|
|
87
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Object → skill routing (verb orchestrators)
|
|
2
|
+
|
|
3
|
+
Read `object` from graph `commands.<name>.object`. Load **capabilities** from `object_capabilities.<object>`, resolve to provider skills via [capabilities/registry.json](../../../aaac/capabilities/registry.json). Graph `object_skills` is the resolved output.
|
|
4
|
+
|
|
5
|
+
Extra capabilities per verb: `object_capability_verbs` in ontology (resolved to `object_skill_verbs` in graph).
|
|
6
|
+
|
|
7
|
+
Layers: **code → data → product → system**.
|
|
8
|
+
|
|
9
|
+
## Base map (`object_skills`)
|
|
10
|
+
|
|
11
|
+
| object | Layer | Focus skill(s) |
|
|
12
|
+
|--------|-------|----------------|
|
|
13
|
+
| function | code | (discovery only) |
|
|
14
|
+
| component | code | component, architecture |
|
|
15
|
+
| module | code | domain inventory when slug present |
|
|
16
|
+
| schema | data | schema |
|
|
17
|
+
| model | data | model, schema |
|
|
18
|
+
| migration | data | migration, schema |
|
|
19
|
+
| feature | product | workflow |
|
|
20
|
+
| workflow | product | workflow |
|
|
21
|
+
| integration | product | integration |
|
|
22
|
+
| app | system | architecture |
|
|
23
|
+
| domain | system | domain |
|
|
24
|
+
| architecture | system | architecture, documentation |
|
|
25
|
+
|
|
26
|
+
## Verb extras (`object_skill_verbs`)
|
|
27
|
+
|
|
28
|
+
| object | verb | Extra skills |
|
|
29
|
+
|--------|------|--------------|
|
|
30
|
+
| module | create | module-authoring |
|
|
31
|
+
| module | review | architecture |
|
|
32
|
+
| feature | create | module-authoring |
|
|
33
|
+
|
|
34
|
+
## Domain inventory (mandatory when slug resolves)
|
|
35
|
+
|
|
36
|
+
For **`fix`**, **`update`**, **`test`**, **`fix-bug`**, **`update-module`**, **`create-feature`**, **`test-module`**:
|
|
37
|
+
|
|
38
|
+
1. If `domains/<slug>/update/inventory/SKILL.md` exists → read **before** discovery
|
|
39
|
+
2. If missing → [module-authoring](../module-authoring/SKILL.md) bootstrap **or** ask user to pick a generic verb-object command
|
|
40
|
+
|
|
41
|
+
**Do not** load `module-authoring` on **`fix-*`** unless bootstrapping a missing domain.
|
|
42
|
+
|
|
43
|
+
## Resolver overrides
|
|
44
|
+
|
|
45
|
+
Domain resolvers in graph override generic verb paths for `update-module`, `update-component`, `create-feature`, `fix-bug`, `test-module`, `update-architecture`.
|
|
46
|
+
|
|
47
|
+
`fix-bug-by-slug` with unknown slug → `verb-fix` with `default_object: feature` per graph.
|
|
48
|
+
|
|
49
|
+
## Investigation depth
|
|
50
|
+
|
|
51
|
+
| Verb | Skill |
|
|
52
|
+
|------|-------|
|
|
53
|
+
| create, update | [investigation-lite](../investigation-lite/SKILL.md) |
|
|
54
|
+
| fix, fix_mode | [investigation](../investigation/SKILL.md) → [root-cause](../root-cause/SKILL.md) |
|
|
55
|
+
|
|
56
|
+
## Pre-execute gates
|
|
57
|
+
|
|
58
|
+
See [_lifecycle.md](./_lifecycle.md): validation → impact-analysis → dependency-graph → fitness-functions → rollback (when required).
|
|
59
|
+
|
|
60
|
+
Utilities: [_dispatch-utils.md](./_dispatch-utils.md)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-check-orchestrator
|
|
3
|
+
description: Orchestrates all check-* commands. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# check-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Readonly.** **Object** from graph. Domain optional for `check-function`.
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) first.
|
|
12
|
+
|
|
13
|
+
## Phases
|
|
14
|
+
|
|
15
|
+
1. **policies** — load `.cursor/policies/`
|
|
16
|
+
2. **scope** — restate question; narrow via domain slug, inventory, intent
|
|
17
|
+
3. **load_inventory** — when domain slug maps to inventory
|
|
18
|
+
4. **object_skills** — from graph `object_skills.<object>`
|
|
19
|
+
5. [check](../../check/SKILL.md) — swarm per check skill
|
|
20
|
+
6. [reporting](../../reporting/SKILL.md) — **Answer** (yes/no/partial) then **How**
|
|
21
|
+
|
|
22
|
+
No code changes. For test runs use `test-*`; for fixes use `fix-*`.
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
name: verb-check-orchestrator
|
|
2
|
+
purpose: Validate or inspect capability per check-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
report:
|
|
10
|
+
type: markdown
|
|
11
|
+
success_criteria:
|
|
12
|
+
- All policies loaded
|
|
13
|
+
- check swarm completed (3+ readonly agents)
|
|
14
|
+
- answer is yes, no, or partial with conditions
|
|
15
|
+
- evidence includes path:line citations
|
|
16
|
+
- no file edits
|
|
17
|
+
failure_conditions:
|
|
18
|
+
- code changes during check
|
|
19
|
+
dependencies:
|
|
20
|
+
skills: [check, reporting]
|
|
21
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
22
|
+
docs:
|
|
23
|
+
- docs/architecture.md
|
|
24
|
+
verification: []
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-create-orchestrator
|
|
3
|
+
description: Orchestrates all create-* commands. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# create-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Object** from graph `commands.<cmd>.object`.
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) and [_lifecycle.md](../_lifecycle.md) first.
|
|
12
|
+
|
|
13
|
+
Lifecycle: graph `verb_runtime.create` (work + gates on Run)
|
|
14
|
+
|
|
15
|
+
## Parse
|
|
16
|
+
|
|
17
|
+
- **Domain:** slug (required except `create-function` — domain optional)
|
|
18
|
+
- **Intent:** quoted — what to add
|
|
19
|
+
|
|
20
|
+
## Phases (deterministic — do not skip)
|
|
21
|
+
|
|
22
|
+
1. **policies** — load `.cursor/policies/`
|
|
23
|
+
2. **load_inventory** — when `domains/<slug>/update/inventory/SKILL.md` exists
|
|
24
|
+
3. **discover** — [discovery](../../discovery/SKILL.md) readonly
|
|
25
|
+
4. **investigate_lite** — [investigation-lite](../../investigation-lite/SKILL.md)
|
|
26
|
+
5. **plan** — [planning](../../planning/SKILL.md)
|
|
27
|
+
6. **validate** — [validation](../../validation/SKILL.md) — confidence gates
|
|
28
|
+
7. **impact_analysis** — [impact-analysis](../../impact-analysis/SKILL.md)
|
|
29
|
+
8. **dependency_graph** — [dependency-graph](../../dependency-graph/SKILL.md)
|
|
30
|
+
9. **fitness_functions** — [fitness-functions](../../fitness-functions/SKILL.md)
|
|
31
|
+
10. **rollback** — [rollback](../../rollback/SKILL.md) when object maturity protected or impact high
|
|
32
|
+
11. **execute** — [execution](../../execution/SKILL.md) + object_skills + module-authoring when listed
|
|
33
|
+
12. **verify** — [testing](../../testing/SKILL.md) + [verification](../../verification/SKILL.md)
|
|
34
|
+
13. **sync_inventory** — when domain inventory exists and execute ran
|
|
35
|
+
14. **report** — [reporting](../../reporting/SKILL.md)
|
|
36
|
+
|
|
37
|
+
Domain slugs with graph resolver use domain orchestrator instead (e.g. `create-feature` → `create-feature-by-slug`).
|
|
38
|
+
|
|
39
|
+
Gate failure → **STOP, REQUEST CLARIFICATION**
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
name: verb-create-orchestrator
|
|
2
|
+
purpose: Create new code, config, or docs per create-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
code_changes:
|
|
10
|
+
type: boolean
|
|
11
|
+
inventory_synced:
|
|
12
|
+
type: boolean
|
|
13
|
+
report:
|
|
14
|
+
type: markdown
|
|
15
|
+
success_criteria:
|
|
16
|
+
- All policies loaded before execute
|
|
17
|
+
- domain inventory loaded when domains/<slug>/update/inventory exists
|
|
18
|
+
- object skills and module-authoring loaded when graph requires
|
|
19
|
+
- governance/implementation followed for all edits
|
|
20
|
+
- fallow check_changed clean on touched files
|
|
21
|
+
failure_conditions:
|
|
22
|
+
- execute without approved plan
|
|
23
|
+
- skip module-authoring when object_skill_verbs lists it
|
|
24
|
+
dependencies:
|
|
25
|
+
skills: [discovery, planning, execution, testing, verification, reporting, module-authoring]
|
|
26
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
27
|
+
docs:
|
|
28
|
+
- docs/master_rules.md
|
|
29
|
+
- docs/architecture.md
|
|
30
|
+
- docs/design_system.md
|
|
31
|
+
verification:
|
|
32
|
+
- sync_inventory
|
|
33
|
+
- run_tests
|
|
34
|
+
- fallow_check_changed
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-fix-orchestrator
|
|
3
|
+
description: Orchestrates fix-* except fix-bug resolver paths. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# fix-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Object** from graph. `fix-bug` uses domain resolver (see [dispatch.md](../../../aaac/dispatch.md) for fallback).
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) and [_lifecycle.md](../_lifecycle.md) first.
|
|
12
|
+
|
|
13
|
+
Lifecycle: graph `verb_runtime.fix` (work + gates on Run)
|
|
14
|
+
|
|
15
|
+
## Phases (deterministic — do not skip)
|
|
16
|
+
|
|
17
|
+
1. **policies**
|
|
18
|
+
2. **load_inventory** — when domain inventory exists
|
|
19
|
+
3. **discover** — [discovery](../../discovery/SKILL.md) readonly
|
|
20
|
+
4. **investigate** — [investigation](../../investigation/SKILL.md) deep
|
|
21
|
+
5. **root_cause** — [root-cause](../../root-cause/SKILL.md)
|
|
22
|
+
6. **plan** — [planning](../../planning/SKILL.md)
|
|
23
|
+
7. **validate** — [validation](../../validation/SKILL.md)
|
|
24
|
+
8. **impact_analysis** — [impact-analysis](../../impact-analysis/SKILL.md)
|
|
25
|
+
9. **dependency_graph** — [dependency-graph](../../dependency-graph/SKILL.md)
|
|
26
|
+
10. **fitness_functions** — [fitness-functions](../../fitness-functions/SKILL.md)
|
|
27
|
+
11. **rollback** — [rollback](../../rollback/SKILL.md) when maturity protected/critical or blast_radius ≥ medium
|
|
28
|
+
12. **execute** — [execution](../../execution/SKILL.md)
|
|
29
|
+
13. **verify** — [testing](../../testing/SKILL.md) + [verification](../../verification/SKILL.md)
|
|
30
|
+
14. **sync_inventory**
|
|
31
|
+
15. **report** — [reporting](../../reporting/SKILL.md)
|
|
32
|
+
|
|
33
|
+
Gate failure → **STOP, REQUEST CLARIFICATION**
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
name: verb-fix-orchestrator
|
|
2
|
+
purpose: Repair broken code, config, or docs per fix-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
code_changes:
|
|
10
|
+
type: boolean
|
|
11
|
+
inventory_synced:
|
|
12
|
+
type: boolean
|
|
13
|
+
report:
|
|
14
|
+
type: markdown
|
|
15
|
+
success_criteria:
|
|
16
|
+
- All policies loaded before execute
|
|
17
|
+
- investigation completed before planning
|
|
18
|
+
- domain inventory loaded when domains/<slug>/update/inventory exists
|
|
19
|
+
- object skills from graph object_skills / object_skill_verbs loaded
|
|
20
|
+
- governance/implementation followed for all edits
|
|
21
|
+
- fallow check_changed clean on touched files
|
|
22
|
+
- user intent satisfied per verification
|
|
23
|
+
failure_conditions:
|
|
24
|
+
- execute without approved plan
|
|
25
|
+
- skip investigation phase
|
|
26
|
+
- skip governance/implementation on code changes
|
|
27
|
+
- skip domain inventory when slug resolves to inventory file
|
|
28
|
+
dependencies:
|
|
29
|
+
skills: [investigation, discovery, planning, execution, testing, verification, reporting]
|
|
30
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
31
|
+
docs:
|
|
32
|
+
- docs/master_rules.md
|
|
33
|
+
- docs/architecture.md
|
|
34
|
+
- docs/design_system.md
|
|
35
|
+
verification:
|
|
36
|
+
- sync_inventory
|
|
37
|
+
- run_tests
|
|
38
|
+
- fallow_check_changed
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-release-orchestrator
|
|
3
|
+
description: Orchestrates release-* commands. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# release-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Object** from graph. `release-app` → [platform-release](../../platform-release/orchestrator/SKILL.md) (full platform ship).
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) first.
|
|
12
|
+
|
|
13
|
+
## By object
|
|
14
|
+
|
|
15
|
+
| object | Behavior |
|
|
16
|
+
|--------|----------|
|
|
17
|
+
| app | platform-release orchestrator (Render, git, observability) |
|
|
18
|
+
| feature | Flag/experiment rollout checklist; PostHog when configured |
|
|
19
|
+
| integration | Integration smoke + env verification per [integration](../../integration/SKILL.md) |
|
|
20
|
+
|
|
21
|
+
## Phases (non-app)
|
|
22
|
+
|
|
23
|
+
1. **policies** — load `.cursor/policies/` including mcp-and-deploy
|
|
24
|
+
2. **object_skills** — from graph `object_skills.<object>`
|
|
25
|
+
3. [testing](../../testing/SKILL.md) + [verification](../../verification/SKILL.md)
|
|
26
|
+
4. [execution](../../execution/SKILL.md) only for deploy/config steps intent requests
|
|
27
|
+
5. [reporting](../../reporting/SKILL.md)
|
|
28
|
+
|
|
29
|
+
Valid release objects: `app`, `feature`, `integration`. Others rejected — see graph `invalid_pairs`.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
name: verb-release-orchestrator
|
|
2
|
+
purpose: Deploy or ship per release-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
report:
|
|
10
|
+
type: markdown
|
|
11
|
+
success_criteria:
|
|
12
|
+
- All policies loaded including mcp-and-deploy
|
|
13
|
+
- tests pass before deploy steps
|
|
14
|
+
- render.yaml blueprint respected (no manual infra creation)
|
|
15
|
+
- health checks verified for API releases
|
|
16
|
+
failure_conditions:
|
|
17
|
+
- deploy without verification
|
|
18
|
+
- manual Render service creation outside blueprint
|
|
19
|
+
dependencies:
|
|
20
|
+
skills: [testing, verification, execution, reporting]
|
|
21
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
22
|
+
docs:
|
|
23
|
+
- docs/architecture.md
|
|
24
|
+
verification:
|
|
25
|
+
- run_tests
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-remove-orchestrator
|
|
3
|
+
description: Orchestrates all remove-* commands. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# remove-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Object** from graph.
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) first.
|
|
12
|
+
|
|
13
|
+
## Phases
|
|
14
|
+
|
|
15
|
+
1. **policies** — load `.cursor/policies/`
|
|
16
|
+
2. **load_inventory** — when domain slug maps to inventory
|
|
17
|
+
3. [discovery](../../discovery/SKILL.md) — blast radius, dependents
|
|
18
|
+
4. **object_skills** — from graph `object_skills.<object>`
|
|
19
|
+
5. [remove](../../remove/SKILL.md) — confirm scope in report before edits
|
|
20
|
+
6. [execution](../../execution/SKILL.md) — deletions and doc/inventory updates
|
|
21
|
+
7. [testing](../../testing/SKILL.md) + [verification](../../verification/SKILL.md)
|
|
22
|
+
8. **sync_inventory** — when domain inventory exists
|
|
23
|
+
9. [reporting](../../reporting/SKILL.md)
|
|
24
|
+
|
|
25
|
+
`remove-app`: require intent to name explicit retirement scope; never delete auth/deploy SSOT without user confirmation.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
name: verb-remove-orchestrator
|
|
2
|
+
purpose: Delete or retire code, config, or docs per remove-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
code_changes:
|
|
10
|
+
type: boolean
|
|
11
|
+
inventory_synced:
|
|
12
|
+
type: boolean
|
|
13
|
+
report:
|
|
14
|
+
type: markdown
|
|
15
|
+
success_criteria:
|
|
16
|
+
- All policies loaded before execute
|
|
17
|
+
- blast radius documented before deletions
|
|
18
|
+
- governance/implementation followed
|
|
19
|
+
- fallow check_changed clean on touched files
|
|
20
|
+
failure_conditions:
|
|
21
|
+
- delete without scope confirmation in report
|
|
22
|
+
- remove auth/deploy SSOT without explicit user confirm
|
|
23
|
+
dependencies:
|
|
24
|
+
skills: [discovery, remove, execution, testing, verification, reporting]
|
|
25
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
26
|
+
docs:
|
|
27
|
+
- docs/master_rules.md
|
|
28
|
+
- docs/architecture.md
|
|
29
|
+
verification:
|
|
30
|
+
- sync_inventory
|
|
31
|
+
- run_tests
|
|
32
|
+
- fallow_check_changed
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-review-orchestrator
|
|
3
|
+
description: Orchestrates review-* except review-module and review-incident. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# review-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Readonly.** **Object** from graph.
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) first.
|
|
12
|
+
|
|
13
|
+
`review-module` → architecture orchestrator. `review-incident` → investigation orchestrator.
|
|
14
|
+
|
|
15
|
+
## Phases
|
|
16
|
+
|
|
17
|
+
1. **policies** — load `.cursor/policies/`
|
|
18
|
+
2. **load_inventory** — when domain slug maps to inventory
|
|
19
|
+
3. [discovery](../../discovery/SKILL.md) — focused scope
|
|
20
|
+
4. **object_skills** — from graph `object_skills.<object>` + `object_skill_verbs.<object>.review`
|
|
21
|
+
5. [architecture](../../architecture/SKILL.md) when object is `module`, `component`, `app`, or `architecture`
|
|
22
|
+
6. [reporting](../../reporting/SKILL.md) — findings prioritized critical vs suggestion
|
|
23
|
+
|
|
24
|
+
No code changes.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
name: verb-review-orchestrator
|
|
2
|
+
purpose: Analyze and report on code or docs per review-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
report:
|
|
10
|
+
type: markdown
|
|
11
|
+
success_criteria:
|
|
12
|
+
- All policies loaded
|
|
13
|
+
- domain inventory loaded when slug resolves
|
|
14
|
+
- object skills from graph loaded
|
|
15
|
+
- no file edits performed
|
|
16
|
+
- findings cite path:line evidence
|
|
17
|
+
failure_conditions:
|
|
18
|
+
- code changes without explicit user fix request
|
|
19
|
+
dependencies:
|
|
20
|
+
skills: [discovery, architecture, reporting]
|
|
21
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
22
|
+
docs:
|
|
23
|
+
- docs/master_rules.md
|
|
24
|
+
- docs/architecture.md
|
|
25
|
+
verification: []
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: verb-test-orchestrator
|
|
3
|
+
description: Orchestrates test-* except test-module resolver and test-function. Internal only.
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# test-* orchestrator
|
|
8
|
+
|
|
9
|
+
**Object** from graph. `test-module` → domain resolver. `test-function` → dedicated test-function orchestrator.
|
|
10
|
+
|
|
11
|
+
Read [_dispatch-utils.md](../_dispatch-utils.md) first.
|
|
12
|
+
|
|
13
|
+
## Phases
|
|
14
|
+
|
|
15
|
+
1. **policies** — load `.cursor/policies/`
|
|
16
|
+
2. **load_inventory** — when domain slug maps to inventory
|
|
17
|
+
3. [discovery](../../discovery/SKILL.md)
|
|
18
|
+
4. [planning](../../planning/SKILL.md) — which tests cover intent
|
|
19
|
+
5. **object_skills** — from graph `object_skills.<object>`
|
|
20
|
+
6. [testing](../../testing/SKILL.md); object `schema` → migration/type tests; `integration` → route tests
|
|
21
|
+
7. [verification](../../verification/SKILL.md)
|
|
22
|
+
8. [reporting](../../reporting/SKILL.md)
|
|
23
|
+
|
|
24
|
+
Fix failures only when intent requests it (then `execution` + governance/implementation).
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
name: verb-test-orchestrator
|
|
2
|
+
purpose: Verify behavior per test-* command
|
|
3
|
+
inputs:
|
|
4
|
+
domain:
|
|
5
|
+
required: false
|
|
6
|
+
intent:
|
|
7
|
+
required: true
|
|
8
|
+
outputs:
|
|
9
|
+
report:
|
|
10
|
+
type: markdown
|
|
11
|
+
success_criteria:
|
|
12
|
+
- All policies loaded
|
|
13
|
+
- domain inventory loaded when slug resolves
|
|
14
|
+
- relevant tests executed or gap reported
|
|
15
|
+
- fallow check_changed when files were fixed per intent
|
|
16
|
+
failure_conditions:
|
|
17
|
+
- claim pass without running tests when tests exist
|
|
18
|
+
dependencies:
|
|
19
|
+
skills: [discovery, planning, testing, verification, reporting]
|
|
20
|
+
policies: [master-rules, implementation, mcp-and-deploy]
|
|
21
|
+
docs:
|
|
22
|
+
- docs/master_rules.md
|
|
23
|
+
verification:
|
|
24
|
+
- run_tests
|
|
25
|
+
- fallow_check_changed
|