@ludecker/aaac 1.0.0 → 1.1.1

package/templates/cursor/aaac/graph.project.yaml

@@ -1,4 +1,127 @@
+resolvers:
+  update-module-by-slug:
+    map:
+      cms: cms-update
+      ui: ui-update
+      database: database-update
+      aaac: aaac-update
+  update-component-by-scope:
+    map:
+      cms: cms-design-update
+      ui: ui-design-update
+  create-feature-by-slug:
+    map:
+      cms: cms-create-feature
+      aaac: aaac-create-feature
+  fix-bug-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: feature
+  fix-domain-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: module
+  fix-component-by-scope:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+    default: verb-fix
+    default_object: component
+  fix-data-by-slug:
+    map:
+      database: database-fix-bug
+    default: database-fix-bug
+    default_object: schema
+  fix-integration-by-slug:
+    map:
+      cms: cms-fix-bug
+      ui: ui-fix-bug
+      database: database-fix-bug
+      aaac: aaac-fix-bug
+    default: verb-fix
+    default_object: integration
+  test-module-by-slug:
+    map:
+      cms: cms-test-module
+      ui: ui-test-module
+      database: database-test-module
+      aaac: aaac-test-module
+
 orchestrators:
+  cms-update:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  ui-update:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  database-update:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  cms-design-update:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    design_mode: true
+
+  ui-design-update:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    design_mode: true
+
+  cms-create-feature:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, module-authoring]
+    create_mode: true
+
+  cms-fix-bug:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  ui-fix-bug:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  database-fix-bug:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
   update-doc:
     path: skills/shared/documentation/orchestrator
     requires: [discovery, documentation, reporting]
@@ -7,7 +130,7 @@ orchestrators:
   review-incident:
     path: skills/shared/investigation/orchestrator
     requires: [discovery, investigation, reporting]
-    optional: [execution]
+    optional: [execution, ludecker-infrastructure]
 
   review-module:
     path: skills/shared/architecture/orchestrator
@@ -23,9 +146,73 @@ orchestrators:
     path: skills/shared/testing/orchestrator
     requires: [discovery, testing, verification, reporting]
 
+  cms-test-module:
+    domain: cms
+    path: domains/cms/update/orchestrator
+    inventory: domains/cms/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  ui-test-module:
+    domain: ui
+    path: domains/ui/update/orchestrator
+    inventory: domains/ui/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  database-test-module:
+    domain: database
+    path: domains/database/update/orchestrator
+    inventory: domains/database/update/inventory
+    requires: [testing, verification, reporting]
+    test_only: true
+
+  aaac-update:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, integration]
+    phases: [load_inventory, discover, investigate_lite, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  aaac-create-feature:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation-lite, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, module-authoring, integration]
+    create_mode: true
+
+  aaac-fix-bug:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting, integration]
+    fix_mode: true
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
+
+  aaac-test-module:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [testing, verification, reporting, integration]
+    test_only: true
+
+  aaac-publish:
+    domain: aaac
+    path: domains/aaac/update/orchestrator
+    inventory: domains/aaac/update/inventory
+    requires: [testing, verification, execution, reporting, integration]
+    publish_mode: true
+
+  write-article:
+    domain: content
+    path: domains/content/write/orchestrator
+    requires: [run, reporting]
+    workflow: write-article
+    phases: [parse, research_swarm, write, review, persist, report]
+
   release-app:
     path: skills/shared/platform-release/orchestrator
-    requires: [testing, verification, execution, reporting]
+    requires: [testing, verification, execution, reporting, ludecker-infrastructure]
 
   verb-create:
     path: skills/shared/verbs/create/orchestrator
@@ -38,6 +225,7 @@ orchestrators:
   verb-fix:
     path: skills/shared/verbs/fix/orchestrator
     requires: [discovery, investigation, root-cause, planning, validation, impact-analysis, dependency-graph, fitness-functions, rollback, execution, testing, verification, reporting]
+    phases: [load_inventory, discover, investigate_swarm, root_cause, plan, validate, impact_analysis, dependency_graph, fitness_functions, rollback, execute, verify, sync_inventory, report]
 
   verb-review:
     path: skills/shared/verbs/review/orchestrator
@@ -70,7 +258,7 @@ skills:
     depends: [governance/implementation]
   testing:
     path: skills/shared/testing
-    agents: [unit-test-run, fallow-check-changed]
+    agents: [unit-test-run, fallow-check-changed, fix-repro-verify]
   verification:
     path: skills/shared/verification
   reporting:
@@ -82,10 +270,19 @@ skills:
     path: skills/shared/documentation
   investigation:
     path: skills/shared/investigation
-  investigation-lite:
-    path: skills/shared/investigation-lite
+    agents:
+      - fix-repro
+      - fix-code-path
+      - fix-recent-changes
+      - fix-test-failures
+      - fix-regression-scope
+      - fix-runtime-evidence
+      - fix-inventory-confirm
   root-cause:
     path: skills/shared/root-cause
+    agents: [fix-hypothesis-validate]
+  investigation-lite:
+    path: skills/shared/investigation-lite
   validation:
     path: skills/shared/validation
   impact-analysis:
@@ -125,6 +322,18 @@ skills:
     path: skills/shared/platform-release
   governance/implementation:
     path: skills/shared/governance/implementation
+  ludecker-design-system:
+    path: skills/ludecker/design-system
+  ludecker-database-schema:
+    path: skills/ludecker/database-schema
+  ludecker-api-first:
+    path: skills/ludecker/api-first
+  ludecker-security:
+    path: skills/ludecker/security
+  ludecker-user-experience:
+    path: skills/ludecker/user-experience
+  ludecker-infrastructure:
+    path: skills/ludecker/infrastructure
 
 agents:
   discovery-inventory:
@@ -151,11 +360,34 @@ agents:
     path: agents/check-capability-trace.md
   impact-analysis:
     path: agents/impact-analysis.md
+  fix-repro:
+    path: agents/fix-repro.md
+  fix-code-path:
+    path: agents/fix-code-path.md
+  fix-recent-changes:
+    path: agents/fix-recent-changes.md
+  fix-test-failures:
+    path: agents/fix-test-failures.md
+  fix-regression-scope:
+    path: agents/fix-regression-scope.md
+  fix-runtime-evidence:
+    path: agents/fix-runtime-evidence.md
+  fix-inventory-confirm:
+    path: agents/fix-inventory-confirm.md
+  fix-repro-verify:
+    path: agents/fix-repro-verify.md
+  fix-hypothesis-validate:
+    path: agents/fix-hypothesis-validate.md
   release-git:
     path: agents/release-git.md
     wave: 1
     blocking: true
+  release-render:
+    path: agents/release-render.md
+    wave: 2
+    requires: [release-git]
 
 policies:
   - policies/master-rules.md
   - policies/implementation.md
+  - policies/mcp-and-deploy.md

package/templates/cursor/aaac/layers.md

@@ -19,7 +19,8 @@ Lifecycle Layer (work)
 
 Governance Layer (gates + rules)
 ├─ Gate stacks                 .cursor/aaac/governance/gates.json
-├─ Policies                    .cursor/policies/
+├─ Complexity SSOT             .cursor/aaac/complexity.yaml
+├─ Policies                    .cursor/policies/ (incl. minimal-complexity.md)
 ├─ Rules                       .cursor/rules/
 ├─ Dependencies                .cursor/aaac/dependencies.yaml
 ├─ Fitness functions           .cursor/aaac/fitness-functions.yaml
@@ -35,6 +36,8 @@ Execution Layer
 ├─ Verb orchestrators          .cursor/skills/shared/verbs/*/orchestrator/
 ├─ Shared pipeline skills      .cursor/skills/shared/
 ├─ Capability registry         .cursor/aaac/capabilities/registry.json
+├─ Capability promotion rules  .cursor/aaac/capabilities/promotion-rules.json
+├─ Capability stats (derived)  .cursor/aaac/state/capability-stats.json
 ├─ Agent specs                 .cursor/agents/
 
 Knowledge Layer
@@ -56,6 +59,7 @@ Contracts Layer (cross-cutting)
 | Graph | Control | Execution routing |
 | Lifecycle | Lifecycle | **Work** phase configuration |
 | Gate stacks | Governance | **Approval** checkpoints |
+| Complexity | Governance | Reuse-first, score limits (create/update/fix) |
 | Run | Run | Primary execution object; state + observability |
 | Domain orchestrators | Execution | Domain coordination |
 | Shared pipeline skills | Execution | Phase execution |
@@ -85,6 +89,7 @@ Policies → Ontology → Graph → Create Run
 → Lifecycle (work) + Gates (composed into Run.pending)
 → Orchestrator → Capabilities resolved (recorded on Run)
 → Execute phases → Update Run → Report
+→ Run completes → capability-evidence.mjs → update capability-stats.json + evaluate promotion
 ```
 
 ## Deprecated

package/templates/cursor/aaac/lifecycle/lifecycle.json

@@ -27,7 +27,7 @@
     "fix": {
       "work_phases": [
         "discover",
-        "investigate",
+        "investigate_swarm",
         "root_cause",
         "plan",
         "execute",
@@ -74,5 +74,45 @@
   "escalation": {
     "on_gate_fail": "STOP_REQUEST_CLARIFICATION",
     "on_human_approval_required": "blocked"
+  },
+  "workflows": {
+    "write-article": {
+      "description": "CMS content swarm — exception command, not verb×object matrix",
+      "work_phases": [
+        "parse",
+        "research_swarm",
+        "write",
+        "review",
+        "persist",
+        "report"
+      ],
+      "gate_stack": null
+    },
+    "fix-module": {
+      "description": "Domain module repair — resolver + full fix swarm",
+      "work_phases": [
+        "discover",
+        "investigate_swarm",
+        "root_cause",
+        "plan",
+        "execute",
+        "verify",
+        "report"
+      ],
+      "gate_stack": "pre_execute"
+    },
+    "fix-bug": {
+      "description": "Alias workflow for defect repair — same as fix-module",
+      "work_phases": [
+        "discover",
+        "investigate_swarm",
+        "root_cause",
+        "plan",
+        "execute",
+        "verify",
+        "report"
+      ],
+      "gate_stack": "pre_execute"
+    }
   }
 }

package/templates/cursor/aaac/lifecycle/phases.json

@@ -5,6 +5,7 @@
     "discover": { "skill": "discovery", "readonly": true },
     "investigate_lite": { "skill": "investigation-lite", "readonly": true },
     "investigate": { "skill": "investigation", "readonly": true },
+    "investigate_swarm": { "skill": "investigation", "readonly": true },
     "root_cause": { "skill": "root-cause", "readonly": true },
     "plan": { "skill": "planning" },
     "validate": { "skill": "validation", "gate": true },

package/templates/cursor/aaac/observability/telemetry.yaml

@@ -0,0 +1,63 @@
+# AAAC telemetry — observability on Run
+
+version: 2
+
+description: >-
+  All observability attaches to the Run manifest (run/schema.json).
+  No standalone markdown logs.
+
+run_manifest: aaac/state/runs/{run_id}/run.json
+
+log_on:
+  - command_parsed
+  - run_created
+  - run_resumed
+  - graph_resolved
+  - phase_start
+  - phase_complete
+  - gate_pass
+  - gate_fail
+  - gate_blocked
+  - human_approval_required
+  - human_approval_received
+  - capability_resolved
+  - evidence_aggregated
+  - capability_promoted
+  - evidence_aggregation_failed
+  - skill_loaded
+  - doc_loaded
+  - agent_spawned
+  - execute_start
+  - execute_complete
+  - run_completed
+  - run_failed
+
+run_fields:
+  decisions: routing, capability, gate outcomes, user approvals
+  log: phase and skill events (see schema log_entry)
+  checkpoints: resume points with artifact refs
+  artifacts: plan, investigation, impact, fitness, rollback, report
+  gates.results: per-gate pass/fail
+
+required_log_fields:
+  - at
+  - run_id
+  - phase
+  - phase_kind
+  - event
+  - detail
+
+required_decision_fields:
+  - at
+  - phase
+  - decision
+  - reason
+  - evidence
+
+questions_answered:
+  - Why did it do this?
+  - Which skill ran?
+  - Which docs were loaded?
+  - Why was a route chosen?
+  - Which capabilities resolved to which providers?
+  - Why is the run blocked?

package/templates/cursor/aaac/observability/verb-debug.yaml

@@ -0,0 +1,170 @@
+# AAAC verb-specific debug profiles — expected phases and log events
+
+version: 1
+
+create:
+  description: Create verbs — discover → investigate_lite → plan → gates → execute → verify → report.
+  phases:
+    - discover
+    - investigate_lite
+    - plan
+    - validate
+    - impact_analysis
+    - dependency_graph
+    - fitness_functions
+    - rollback
+    - execute
+    - verify
+    - report
+  swarm_minimums:
+    discover: 4
+  expected_events:
+    discover:
+      - command_parsed
+      - run_created
+      - graph_resolved
+      - phase_start
+      - agent_spawned
+      - phase_complete
+    investigate_lite:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+    plan:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+    validate:
+      - phase_start
+      - gate_pass
+      - phase_complete
+    execute:
+      - phase_start
+      - execute_start
+      - edit_allowed
+      - execute_complete
+      - phase_complete
+
+update:
+  description: Update verbs mirror create — discover → investigate_lite → plan → gates → execute.
+  phases:
+    - discover
+    - investigate_lite
+    - plan
+    - validate
+    - impact_analysis
+    - dependency_graph
+    - fitness_functions
+    - rollback
+    - execute
+    - verify
+    - report
+  swarm_minimums:
+    discover: 4
+  expected_events:
+    discover:
+      - command_parsed
+      - run_created
+      - graph_resolved
+      - phase_start
+      - agent_spawned
+      - phase_complete
+    investigate_lite:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+    plan:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+    validate:
+      - phase_start
+      - gate_pass
+      - phase_complete
+    execute:
+      - phase_start
+      - execute_start
+      - edit_allowed
+      - execute_complete
+      - phase_complete
+
+fix:
+  description: Fix verbs — investigate_swarm → root_cause → plan → gates → execute → verify_fix swarm.
+  phases:
+    - discover
+    - investigate_swarm
+    - root_cause
+    - plan
+    - validate
+    - impact_analysis
+    - dependency_graph
+    - fitness_functions
+    - rollback
+    - execute
+    - verify
+    - report
+  swarm_minimums:
+    discover: 4
+    investigate_swarm: 7
+    verify: 3
+  expected_events:
+    discover:
+      - command_parsed
+      - run_created
+      - graph_resolved
+      - phase_start
+      - agent_spawned
+      - phase_complete
+    investigate_swarm:
+      - phase_start
+      - agent_spawned
+      - skill_loaded
+      - phase_complete
+    root_cause:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+    verify:
+      - phase_start
+      - agent_spawned
+      - phase_complete
+    execute:
+      - phase_start
+      - execute_start
+      - edit_allowed
+      - edit_denied
+      - execute_complete
+      - phase_complete
+
+check:
+  description: Check verbs — readonly discover → gates → report (no execute).
+  phases:
+    - discover
+    - validate
+    - impact_analysis
+    - dependency_graph
+    - fitness_functions
+    - report
+  swarm_minimums:
+    discover: 4
+    check_swarm: 3
+  expected_events:
+    discover:
+      - command_parsed
+      - run_created
+      - graph_resolved
+      - phase_start
+      - agent_spawned
+      - phase_complete
+    validate:
+      - phase_start
+      - gate_pass
+      - phase_complete
+    report:
+      - phase_start
+      - skill_loaded
+      - phase_complete
+  readonly: true
+  notes: >-
+    Orchestrator runs check_swarm (3 explore agents) during discover.
+    Edits always denied — no execute phase.

package/templates/cursor/aaac/ontology.json

@@ -122,6 +122,13 @@
     "requirements": 0.8,
     "scope": 0.8
   },
+  "complexity_ref": "aaac/complexity.yaml",
+  "complexity_strategy": {
+    "optimization": "capability_per_complexity",
+    "default_verb_when_ambiguous": "update",
+    "mutating_verbs": ["create", "update", "fix"],
+    "priority": ["reuse", "extend", "modify", "create"]
+  },
   "object_maturity": {
     "function": "evolving",
     "component": "evolving",
@@ -214,6 +221,8 @@
     "create-form": "create-component",
     "update-page": "update-component",
     "review-flow": "review-workflow",
-    "update-flow": "update-workflow"
+    "update-flow": "update-workflow",
+    "module-fix": "fix-module",
+    "bug-fix": "fix-bug"
   }
 }

package/templates/cursor/aaac/run/RUN.md

@@ -2,6 +2,8 @@
 
 **Every AAAC command executes within a Run.** There is no standalone lifecycle execution or standalone logging.
 
+**Hook enforcement:** [.cursor/hooks.json](../../hooks.json) + [enforcement.json](../enforcement.json) block code edits until `execute`. Registry: [runtime-registry.json](../runtime-registry.json).
+
 Schema: [schema.json](schema.json)
 
 ## Create Run (dispatch step 2.5 — after graph resolve, before orchestrator)

package/templates/cursor/aaac/run/schema.json

@@ -22,6 +22,8 @@
     "checkpoints": [],
     "log": [],
     "capabilities_resolved": {},
+    "capability_evidence_processed": false,
+    "capability_evidence_outcomes": [],
     "confidence": {
       "architecture": null,
       "requirements": null,
@@ -71,6 +73,15 @@
     "rollback",
     "report"
   ],
+  "plan_complexity_fields": [
+    "requirement_map",
+    "complexity_score",
+    "complexity_breakdown",
+    "reuse",
+    "modify",
+    "create",
+    "rejected_alternatives"
+  ],
   "resume": {
     "read_manifest": "state/runs/{run_id}/run.json",
     "continue_from": "phase field when status running or blocked with user approval"