@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.
Files changed (110) hide show
  1. package/README.md +60 -0
  2. package/package.json +38 -0
  3. package/src/cli.mjs +138 -0
  4. package/src/generators/generate-commands.mjs +165 -0
  5. package/src/generators/generate-graph-commands.mjs +63 -0
  6. package/src/generators/generate-graph.mjs +242 -0
  7. package/src/lib/copy.mjs +36 -0
  8. package/src/lib/install.mjs +76 -0
  9. package/src/lib/paths.mjs +54 -0
  10. package/templates/cursor/aaac/capabilities/registry.json +106 -0
  11. package/templates/cursor/aaac/contract-schema.md +66 -0
  12. package/templates/cursor/aaac/contracts/commands/create-module.yaml +28 -0
  13. package/templates/cursor/aaac/contracts/commands/fix-bug.yaml +32 -0
  14. package/templates/cursor/aaac/contracts/commands/update-module.yaml +28 -0
  15. package/templates/cursor/aaac/contracts/skills/impact-analysis.yaml +17 -0
  16. package/templates/cursor/aaac/contracts/skills/investigation-lite.yaml +17 -0
  17. package/templates/cursor/aaac/contracts/skills/investigation.yaml +17 -0
  18. package/templates/cursor/aaac/contracts/skills/validation.yaml +14 -0
  19. package/templates/cursor/aaac/dependencies.yaml +14 -0
  20. package/templates/cursor/aaac/dispatch.md +135 -0
  21. package/templates/cursor/aaac/fitness-functions.yaml +34 -0
  22. package/templates/cursor/aaac/governance/gates.json +39 -0
  23. package/templates/cursor/aaac/graph.project.yaml +161 -0
  24. package/templates/cursor/aaac/layers.md +93 -0
  25. package/templates/cursor/aaac/lifecycle/lifecycle.json +78 -0
  26. package/templates/cursor/aaac/lifecycle/phases.json +19 -0
  27. package/templates/cursor/aaac/ontology.json +219 -0
  28. package/templates/cursor/aaac/ontology.md +90 -0
  29. package/templates/cursor/aaac/project.config.json +3 -0
  30. package/templates/cursor/aaac/run/RUN.md +72 -0
  31. package/templates/cursor/aaac/run/schema.json +83 -0
  32. package/templates/cursor/aaac/state/checkpoints/README.md +20 -0
  33. package/templates/cursor/agents/boundary-review.md +11 -0
  34. package/templates/cursor/agents/check-capability-trace.md +18 -0
  35. package/templates/cursor/agents/dependency-analysis.md +11 -0
  36. package/templates/cursor/agents/discovery-boundaries.md +11 -0
  37. package/templates/cursor/agents/discovery-inventory.md +14 -0
  38. package/templates/cursor/agents/discovery-ssot.md +11 -0
  39. package/templates/cursor/agents/fallow-check-changed.md +9 -0
  40. package/templates/cursor/agents/impact-analysis.md +22 -0
  41. package/templates/cursor/agents/plan-layer-map.md +11 -0
  42. package/templates/cursor/agents/plan-state-machines.md +11 -0
  43. package/templates/cursor/agents/release-git.md +36 -0
  44. package/templates/cursor/agents/system-decomposition.md +11 -0
  45. package/templates/cursor/agents/unit-test-run.md +19 -0
  46. package/templates/cursor/policies/implementation.md +8 -0
  47. package/templates/cursor/policies/master-rules.md +7 -0
  48. package/templates/cursor/skills/shared/api/SKILL.md +26 -0
  49. package/templates/cursor/skills/shared/architecture/SKILL.md +25 -0
  50. package/templates/cursor/skills/shared/architecture/orchestrator/SKILL.md +21 -0
  51. package/templates/cursor/skills/shared/architecture/refactor-analysis.md +302 -0
  52. package/templates/cursor/skills/shared/check/SKILL.md +47 -0
  53. package/templates/cursor/skills/shared/component/SKILL.md +24 -0
  54. package/templates/cursor/skills/shared/dependency-graph/SKILL.md +38 -0
  55. package/templates/cursor/skills/shared/discovery/SKILL.md +29 -0
  56. package/templates/cursor/skills/shared/documentation/SKILL.md +21 -0
  57. package/templates/cursor/skills/shared/documentation/orchestrator/SKILL.md +26 -0
  58. package/templates/cursor/skills/shared/documentation/orchestrator/contract.yaml +20 -0
  59. package/templates/cursor/skills/shared/documentation/write-arch-doc.md +168 -0
  60. package/templates/cursor/skills/shared/domain/SKILL.md +24 -0
  61. package/templates/cursor/skills/shared/execution/SKILL.md +34 -0
  62. package/templates/cursor/skills/shared/fitness-functions/SKILL.md +42 -0
  63. package/templates/cursor/skills/shared/governance/implementation/SKILL.md +424 -0
  64. package/templates/cursor/skills/shared/impact-analysis/SKILL.md +44 -0
  65. package/templates/cursor/skills/shared/integration/SKILL.md +22 -0
  66. package/templates/cursor/skills/shared/investigation/SKILL.md +46 -0
  67. package/templates/cursor/skills/shared/investigation/orchestrator/SKILL.md +22 -0
  68. package/templates/cursor/skills/shared/investigation-lite/SKILL.md +38 -0
  69. package/templates/cursor/skills/shared/migration/SKILL.md +22 -0
  70. package/templates/cursor/skills/shared/model/SKILL.md +22 -0
  71. package/templates/cursor/skills/shared/module-authoring/SKILL.md +29 -0
  72. package/templates/cursor/skills/shared/module-authoring/authoring-template.md +9 -0
  73. package/templates/cursor/skills/shared/planning/SKILL.md +30 -0
  74. package/templates/cursor/skills/shared/platform-release/SKILL.md +46 -0
  75. package/templates/cursor/skills/shared/platform-release/orchestrator/SKILL.md +51 -0
  76. package/templates/cursor/skills/shared/platform-release/orchestrator/contract.yaml +29 -0
  77. package/templates/cursor/skills/shared/platform-release/ship-procedure.md +31 -0
  78. package/templates/cursor/skills/shared/remove/SKILL.md +28 -0
  79. package/templates/cursor/skills/shared/reporting/SKILL.md +43 -0
  80. package/templates/cursor/skills/shared/rollback/SKILL.md +46 -0
  81. package/templates/cursor/skills/shared/root-cause/SKILL.md +24 -0
  82. package/templates/cursor/skills/shared/run/SKILL.md +64 -0
  83. package/templates/cursor/skills/shared/schema/SKILL.md +24 -0
  84. package/templates/cursor/skills/shared/testing/SKILL.md +24 -0
  85. package/templates/cursor/skills/shared/testing/orchestrator/SKILL.md +22 -0
  86. package/templates/cursor/skills/shared/validation/SKILL.md +56 -0
  87. package/templates/cursor/skills/shared/verbs/_dispatch-utils.md +90 -0
  88. package/templates/cursor/skills/shared/verbs/_lifecycle.md +87 -0
  89. package/templates/cursor/skills/shared/verbs/_object-skills.md +60 -0
  90. package/templates/cursor/skills/shared/verbs/check/orchestrator/SKILL.md +22 -0
  91. package/templates/cursor/skills/shared/verbs/check/orchestrator/contract.yaml +24 -0
  92. package/templates/cursor/skills/shared/verbs/create/orchestrator/SKILL.md +39 -0
  93. package/templates/cursor/skills/shared/verbs/create/orchestrator/contract.yaml +34 -0
  94. package/templates/cursor/skills/shared/verbs/fix/orchestrator/SKILL.md +33 -0
  95. package/templates/cursor/skills/shared/verbs/fix/orchestrator/contract.yaml +38 -0
  96. package/templates/cursor/skills/shared/verbs/release/orchestrator/SKILL.md +29 -0
  97. package/templates/cursor/skills/shared/verbs/release/orchestrator/contract.yaml +25 -0
  98. package/templates/cursor/skills/shared/verbs/remove/orchestrator/SKILL.md +25 -0
  99. package/templates/cursor/skills/shared/verbs/remove/orchestrator/contract.yaml +32 -0
  100. package/templates/cursor/skills/shared/verbs/review/orchestrator/SKILL.md +24 -0
  101. package/templates/cursor/skills/shared/verbs/review/orchestrator/contract.yaml +25 -0
  102. package/templates/cursor/skills/shared/verbs/test/orchestrator/SKILL.md +24 -0
  103. package/templates/cursor/skills/shared/verbs/test/orchestrator/contract.yaml +25 -0
  104. package/templates/cursor/skills/shared/verbs/update/orchestrator/SKILL.md +34 -0
  105. package/templates/cursor/skills/shared/verbs/update/orchestrator/contract.yaml +34 -0
  106. package/templates/cursor/skills/shared/verification/SKILL.md +28 -0
  107. package/templates/cursor/skills/shared/workflow/SKILL.md +25 -0
  108. package/templates/docs/agentic_architecture.md +131 -0
  109. package/templates/docs/architecture.md +5 -0
  110. 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