@ludecker/aaac 1.0.0

package/templates/cursor/skills/shared/verbs/update/orchestrator/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: verb-update-orchestrator
+description: Orchestrates update-* commands without dedicated resolver. Internal only.
+disable-model-invocation: true
+---
+
+# update-* orchestrator
+
+**Object** from graph. Resolvers win: `update-module`, `update-architecture`, `update-component` (alias: `update-design`).
+
+Read [_dispatch-utils.md](../_dispatch-utils.md) and [_lifecycle.md](../_lifecycle.md) first.
+
+Lifecycle: graph `verb_runtime.update` (work + gates on Run)
+
+## Phases (deterministic — do not skip)
+
+1. **policies**
+2. **load_inventory** — when domain inventory exists
+3. **discover** — [discovery](../../discovery/SKILL.md)
+4. **investigate_lite** — [investigation-lite](../../investigation-lite/SKILL.md) — **mandatory** (what exists, depends on, constraints)
+5. **plan** — [planning](../../planning/SKILL.md)
+6. **validate** — [validation](../../validation/SKILL.md)
+7. **impact_analysis** — [impact-analysis](../../impact-analysis/SKILL.md)
+8. **dependency_graph** — [dependency-graph](../../dependency-graph/SKILL.md)
+9. **fitness_functions** — [fitness-functions](../../fitness-functions/SKILL.md)
+10. **rollback** — [rollback](../../rollback/SKILL.md) when maturity protected or blast_radius high
+11. **execute** — [execution](../../execution/SKILL.md); `design_mode` when component + design resolver
+12. **verify** — [testing](../../testing/SKILL.md) + [verification](../../verification/SKILL.md)
+13. **sync_inventory**
+14. **report** — [reporting](../../reporting/SKILL.md)
+
+Intent `Sync inventory only` → inventory sync only, no execution.
+
+Gate failure → **STOP, REQUEST CLARIFICATION**

package/templates/cursor/skills/shared/verbs/update/orchestrator/contract.yaml

@@ -0,0 +1,34 @@
+name: verb-update-orchestrator
+purpose: Modify existing code, config, or docs per update-* command
+inputs:
+  domain:
+    required: false
+  intent:
+    required: true
+outputs:
+  code_changes:
+    type: boolean
+  inventory_synced:
+    type: boolean
+  report:
+    type: markdown
+success_criteria:
+  - All policies loaded before execute
+  - domain inventory loaded when domains/<slug>/update/inventory exists
+  - object skills from graph loaded
+  - governance/implementation followed for all edits
+  - fallow check_changed clean on touched files
+failure_conditions:
+  - execute without approved plan
+  - skip domain inventory when slug resolves to inventory file
+dependencies:
+  skills: [discovery, planning, execution, testing, verification, reporting]
+  policies: [master-rules, implementation, mcp-and-deploy]
+  docs:
+    - docs/master_rules.md
+    - docs/architecture.md
+    - docs/design_system.md
+verification:
+  - sync_inventory
+  - run_tests
+  - fallow_check_changed

package/templates/cursor/skills/shared/verification/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: shared-verification
+description: >-
+  Verifies AAAC intent met — contract success_criteria, inventory sync, behavior
+  spot-check, fitness re-score. Distinct from testing (green CI). Not user-facing.
+disable-model-invocation: true
+---
+
+# Shared verification
+
+## When
+
+After `testing`. Before `report`.
+
+## Checks
+
+- Orchestrator `contract.yaml` `success_criteria`
+- Graph `object_skills` / `object_skill_verbs` skills were loaded for command object + verb
+- User instruction satisfied (spot-check 2–3 behaviors in code or tests)
+- Domain constraints from inventory still hold
+- `sync_inventory` completed when `execute` ran (inventory date + file table current)
+- Out-of-scope areas untouched
+- **Fitness re-check:** abbreviated [fitness-functions](../fitness-functions/SKILL.md) score on touched scope — no new `fail` on security or layer_boundaries
+- Rollback plan from [rollback](../rollback/SKILL.md) still accurate if execute changed scope
+
+## Fail
+
+Stop and report gaps — do not claim success if tests pass but intent unmet.

package/templates/cursor/skills/shared/workflow/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: shared-workflow
+description: >-
+  Multi-step business processes and state machines. Object workflow. Not user-facing.
+disable-model-invocation: true
+---
+
+# Shared workflow
+
+## Scope
+
+- Explicit state machines (finite states, named transitions)
+- Orchestration across UI → API → jobs → external systems
+- Requirement engine, Q&A graphs, publish pipelines, release waves
+
+## Execution focus
+
+- Model invalid transitions; no timing assumptions
+- Idempotent async steps; cancellable where applicable
+- Log state transitions at debug level
+
+## Review / check focus
+
+- Can the process reach the intended end state?
+- Race conditions and overlapping requests

package/templates/docs/agentic_architecture.md

@@ -0,0 +1,131 @@
+# Agentic Architecture as Code (AAAC)
+
+## In one sentence
+
+> **Commands are the public API. Skills, agents, tools, rules, and documentation are private implementation details.**
+
+You express intent; the architecture determines execution.
+
+Installed by [{{PROJECT_NAME}}](https://ludecker.com) — generic AAAC kernel for Cursor.
+
+---
+
+## Part 1 — For everyone
+
+### What you do
+
+> **Call a command. The system figures out the rest.**
+
+Ask: *What do I want?* Then type:
+
+```text
+/<verb>-<object> <domain> "<intent>"
+```
+
+| Part | Meaning | Example |
+|------|---------|---------|
+| Command | Kind of work | `update-module` |
+| Domain | Which bounded context | `api` |
+| Intent | Goal in plain language | `"Add pagination to list endpoint"` |
+
+### Commands (AAAC v1)
+
+| Command | When to use |
+|---------|-------------|
+| `update-module` | Change an existing bounded module |
+| `update-doc` | Update architecture documentation (no code) |
+| `create-feature` | Add a new capability |
+| `fix-bug` | Fix broken behavior |
+| `review-module` | Quality/architecture review (no code) |
+| `review-incident` | Investigate deploy or production issue |
+| `test-module` | Test and verify a module |
+| `test-function` | Test a user journey |
+| `release-app` | Phased release (git → deploy) |
+
+Verb×object matrix commands (`create-component`, `check-schema`, …) route through shared verb orchestrators. See [`.cursor/aaac/ontology.md`](../.cursor/aaac/ontology.md).
+
+### Examples
+
+```text
+/update-module api "Add rate limiting middleware"
+/fix-bug "Checkout fails on empty cart"
+/update-doc architecture "Document domain boundaries"
+/review-module api "Check layer boundaries and size budgets"
+/test-function "Sign-up to welcome email journey"
+/release-app production "Ship with typecheck"
+```
+
+### What you should not need to know
+
+skill, agent, subagent, tool, workflow, graph, orchestrator — infrastructure only.
+
+---
+
+## Part 2 — Appendix (maintainers)
+
+### Install and regenerate
+
+```bash
+npx @ludecker/aaac@latest init
+# or
+pnpm dlx @ludecker/aaac@latest init
+```
+
+After changing ontology or project wiring:
+
+```bash
+npx @ludecker/aaac@latest generate
+# or
+pnpm dlx @ludecker/aaac@latest generate
+```
+
+### Adding a product domain
+
+1. Create `.cursor/domains/<slug>/update/orchestrator/` (SKILL.md + contract.yaml)
+2. Create `.cursor/domains/<slug>/update/inventory/` (file map + constraints)
+3. Add resolver entries to `.cursor/aaac/graph.project.yaml`
+4. Add `command_overrides` to `.cursor/aaac/ontology.json` if slug-based routing is needed
+5. Regenerate graph and commands (see above)
+
+### Responsibility layers
+
+Full map: [`.cursor/aaac/layers.md`](../.cursor/aaac/layers.md)
+
+```text
+User Layer          → Commands
+Control Layer       → Ontology, Dispatch, Graph
+Lifecycle Layer     → work phases (lifecycle.json)
+Governance Layer    → gate stacks (gates.json), policies, fitness
+Run Layer           → Run manifest (state + observability)
+Execution Layer     → Orchestrators, pipeline skills, capabilities, agents
+Contracts Layer     → command + skill contracts
+Knowledge Layer     → {{DOCS_ROOT}}/
+```
+
+**SSOT:** [`.cursor/aaac/graph.yaml`](../.cursor/aaac/graph.yaml)
+
+**Dispatch:** [`.cursor/aaac/dispatch.md`](../.cursor/aaac/dispatch.md)
+
+### Directory layout
+
+```text
+.cursor/
+  commands/          # thin routers (public)
+  aaac/              # ontology, graph, generators config
+  domains/<slug>/update/
+    orchestrator/
+    inventory/
+  skills/shared/     # pipeline + verb orchestrators
+  agents/            # subagent prompt specs
+  policies/          # inherited governance
+{{DOCS_ROOT}}/
+  agentic_architecture.md
+  master_rules.md    # your project rules (create if missing)
+  architecture.md    # your system map (create if missing)
+```
+
+### Release swarm (`release-app`)
+
+Wave 1: `release-git` (blocking). Configure deploy agents in `graph.project.yaml` for your host.
+
+Orchestrator: [`.cursor/skills/shared/platform-release/orchestrator`](../.cursor/skills/shared/platform-release/orchestrator/SKILL.md)

package/templates/docs/architecture.md

@@ -0,0 +1,5 @@
+# Architecture
+
+Describe your system map: layers, modules, data flow, and deployment.
+
+AAAC policies reference this file. Replace this stub with your project architecture.

package/templates/docs/master_rules.md

@@ -0,0 +1,5 @@
+# Master rules
+
+Define your project’s non-negotiable architecture and implementation rules here.
+
+AAAC orchestrators load this file via `.cursor/policies/master-rules.md`. Replace this stub with your team’s rules.