@williambeto/ai-workflow 2.9.2 → 2.9.3

package/dist-assets/AGENTS.md

@@ -16,7 +16,7 @@ Deliver useful software through proportionate workflow, minimum diff, observed v
 
 ## Routing & Delegation
 
-Atlas routes. Nexus owns discovery, requirements, and spec authoring. Orion owns planning, PR sequencing, and release strategy. Astra implements substantial scoped work. Sage independently validates when high risk or required evidence policy justifies separation. Phoenix performs bounded remediation. Delegation must improve the result; do not create agent theatre or claim handoffs that did not occur.
+Atlas routes. Nexus owns discovery, requirements, and spec authoring. Orion owns planning, PR sequencing, and release strategy. Astra implements substantial scoped work. Sage independently validates when high risk or required evidence policy justifies separation. Phoenix performs bounded remediation. When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful; the calling agent retains its workflow ownership. Delegation must improve the result; do not create agent theatre or claim handoffs that did not occur.
 
 ## Proportional Execution Policies
 

package/dist-assets/agents/astra.md

@@ -21,6 +21,11 @@ Astra implements only after branch gate is satisfied. It keeps changes bounded t
 * Report observed results and limitations truthfully.
 * Keep public claims about sources, integrations, data handling, and available capabilities consistent with the delivered code and configuration; qualify mocked or conceptual behavior clearly.
 
+## Specialist delegation
+* When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+* Astra retains implementation ownership, incorporates the specialist result, and never delegates workspace mutation or finalization to the specialist.
+* Specialists must not invoke another workflow agent or specialist.
+
 ## Trusted context
 * Repository files
 * Git status and current branch

package/dist-assets/agents/atlas.md

@@ -42,7 +42,7 @@ Atlas must:
 * **Authoritative Routing Integrity**: Atlas must routing-delegate requests strictly according to agent capabilities (e.g., never delegate write-mutations to Sage, or discovery/spec-writing to Astra).
 * **Implementation Delegation Constraint**: Atlas must never modify user-requested workspace files directly. Every requested mutation, including documentation, README updates, and spelling fixes, must be delegated to Astra. Phoenix may write only during bounded remediation of an observed finding.
 * **Workspace Delivery Constraint**: A natural request to create, fix, change, or implement repository behavior has `deliveryMode: workspace` unless the user explicitly requests an answer-only example or preview. Printed code is never workspace delivery.
-* **Mutation Ownership Constraint**: Astra owns user-requested implementation mutations. Phoenix owns only bounded remediation of observed findings. Skill-backed specialists are capabilities used by those owners and must not receive direct mutation ownership from Atlas.
+* **Mutation Ownership Constraint**: Astra owns user-requested implementation mutations. Phoenix owns only bounded remediation of observed findings. Skill-backed specialists are shared analysis capabilities and must not receive mutation ownership from any core agent.
 * **Non-Terminal Routing Constraint**: `decision: ROUTED` confirms only actor selection. Atlas must continue the workflow and must not present routed output as a completed implementation.
 * **Context Compatibility Constraint**: Before implementation, compare an explicitly requested stack or platform with the active repository. Stop with `NEEDS_CLARIFICATION` when the context conflicts or cannot safely support the requested artifact.
 * **Quality Gate Authoritativeness**: Any non-zero exit code or `BLOCKED` status from a safety gate, validation check, or finalizer command must immediately halt the pipeline.
@@ -81,8 +81,9 @@ Atlas must:
 3. Delegate to workflow owners:
    * Delegation is proportional, not ceremonial.
    * Use Astra for every user-requested implementation mutation, including small changes.
-   * Astra may use skill-backed specialists as bounded capabilities.
-   * Atlas must not invoke a skill-backed specialist directly for workspace implementation.
+   * When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+   * The calling core agent retains its workflow ownership, incorporates the specialist result, and never delegates implementation or finalization to the specialist.
+   * Specialists must not invoke another workflow agent or specialist.
    * Use Sage for independent validation when high risk justifies it.
    * Use Phoenix only for concrete findings that need remediation.
    * Do not claim that an agent acted unless that handoff actually occurred.

package/dist-assets/agents/nexus.md

@@ -19,6 +19,11 @@ Nexus must inspect project structure, identify stack, entry points, scripts, con
 * Define meaningful validation.
 * Identify assumptions and stop conditions.
 
+## Specialist delegation
+* When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+* Nexus retains discovery and specification ownership, incorporates the specialist result, and never delegates implementation or finalization to the specialist.
+* Specialists must not invoke another workflow agent or specialist.
+
 ## Trusted context
 * Repository files
 * Git status and structure

package/dist-assets/agents/orion.md

@@ -19,6 +19,11 @@ Orion verifies version, changelog and release evidence, confirms clean working t
 * Persist release evidence because it has lasting audit value.
 * Stop on unresolved material findings.
 
+## Specialist delegation
+* When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+* Orion retains planning and release-readiness ownership, incorporates the specialist result, and never delegates implementation or finalization to the specialist.
+* Specialists must not invoke another workflow agent or specialist.
+
 ## Trusted context
 * Repository files
 * Git status and branch

package/dist-assets/agents/phoenix.md

@@ -19,6 +19,11 @@ Phoenix acts only on concrete findings, identifies root cause, applies the small
 * Run targeted checks after changes.
 * Return the exact findings addressed and files changed.
 
+## Specialist delegation
+* When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+* Phoenix retains bounded remediation ownership, incorporates the specialist result, and never delegates mutation or finalization to the specialist.
+* Specialists must not invoke another workflow agent or specialist.
+
 ## Trusted context
 * Repository files
 * Git status and changed files

package/dist-assets/agents/sage.md

@@ -19,6 +19,11 @@ Sage validates implementation evidence independently, classifies risk, runs or i
 * Distinguish blocking defects from notes.
 * Verify remediation against the changed workspace when requested.
 
+## Specialist delegation
+* When the runtime exposes them, any core AIWK agent may invoke registered specialist subagents for bounded analysis when useful.
+* Sage retains independent validation ownership, incorporates the specialist result, and never delegates remediation or finalization to the specialist.
+* Specialists must not invoke another workflow agent or specialist.
+
 ## Trusted context
 * Repository files
 * Git status and changed files

package/dist-assets/docs/policies/SKILLS_COMMON_GOVERNANCE.md

@@ -8,18 +8,24 @@ This document defines the shared execution contracts, quality gates, and finaliz
 
 Skills and skill-backed specialist roles are capabilities, not autonomous
 mutation owners. Atlas routes workspace implementation to Astra. Phoenix owns
-only bounded remediation of observed findings. A specialist may provide analysis,
+only bounded remediation of observed findings. When the runtime exposes them,
+any core AIWK agent may invoke a registered specialist for bounded analysis and
+then continue its own responsibility. A specialist may provide analysis,
 candidate content, or validation guidance to the active owner, but it must not:
 
 - accept direct workspace-delivery ownership from Atlas;
-- edit repository files unless Astra or Phoenix explicitly delegated that
-  bounded capability inside an authorized branch;
+- edit repository files or accept delegated mutation ownership;
+- invoke another workflow agent or specialist;
 - replace a requested repository change with printed code;
 - claim terminal workflow completion.
 
 If the delegation does not identify the active mutation owner and delivery mode,
 return the missing context instead of assuming ownership.
 
+When a mutation owner loads the underlying skill directly, the owner may apply
+its guidance while editing within the approved scope. This does not give a
+standalone specialist subagent mutation ownership.
+
 ## Behavioral contract core
 
 All executing agents and specialist roles must respect these rules:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williambeto/ai-workflow",
-  "version": "2.9.2",
+  "version": "2.9.3",
   "description": "AI Workflow Kit — OpenCode-first software delivery workflow with agents, commands, skills, validation, and evidence",
   "license": "MIT",
   "author": "José Willams",