Orchestration

Use orchestration to map SwarmVault roles onto either named providers or external commands that speak JSON over stdin/stdout.

Example

{
  "orchestration": {
    "maxParallelRoles": 2,
    "compilePostPass": true,
    "roles": {
      "research": {
        "executor": { "type": "provider", "provider": "primary" }
      },
      "audit": {
        "executor": { "type": "provider", "provider": "primary" }
      },
      "context": {
        "executor": { "type": "command", "command": ["./bin/context-agent"] }
      },
      "safety": {
        "executor": { "type": "provider", "provider": "primary" }
      }
    }
  }
}

Roles

  • research - Suggest follow-up questions and broader investigation directions
  • audit - Add advisory validation findings
  • context - Suggest cross-link and context updates
  • safety - Flag caveats, contradictions, and weaker claims

Current Integration Points

  • lint --deep
  • explore
  • optional compile post-pass

Important Constraint

Role executors are read-only. Any proposed markdown changes still land as approval bundles. SwarmVault remains the only writer to the vault.