Factory Capability Matrix¶
Authority: BLU — Factory Coordinator Scope: Bluefly-wide factory architecture: runtime layers, agent authorities, and capability gap backlog. Claim type: organizational engineering knowledge — queried from this document. Status: Active canonical.
1. Operating Architecture Contract¶
GAS_CITY_RUNTIME=YES
GASTOWN_RUNTIME=NO
GASTOWN_CONTROL_PLANE=NO
GASTOWN_PACK=OPTIONAL
Six Gas City primitives only:
Agent = WHO
Bead = WHAT
Formula = HOW
Rig = WHERE
Pack = CONFIGURES
Event = OBSERVE
| Layer | System | Role & Scope |
|---|---|---|
| Runtime & Orchestration | Gas City | Sole execution runtime (gc), session management, order scheduler, event bus. Six primitives. |
| Factory Operating OS | BluCity | Bluefly's Gas City composition (/opt/bluefly/blucity). Factory lifecycle, work routing, cross-rig orchestration. |
| Reusable Capability Packs | BluCity-Packs | Bluefly private Gas City Packs: formulas (V2), orders, prompts, policy bundles. |
| Domain Reusable Pack | DrupalWorks | Public reusable Gas City Pack for Drupal engineering. Domain-only; no private Bluefly dependencies. |
| Predecessor / Optional | Gas Town | NOT OUR RUNTIME. Optional source of reusable Pack configuration only. |
| Knowledge & Policy | BluCity-Docs | Canonical engineering standards, ADRs, playbooks. Referenced; never copied into projects. |
| Durable Work Ledger | Beads / Dolt | System of record for work items, status, dependencies (hq db, prefix bl). |
| Release & Provenance | GitLab | Source control, CI/CD, MR review, release branches, immutable audit trail. |
| Governed Context UI | ContextControl | Human/business context governance, provenance, approval surfaces, factory visibility. NOT a scheduler. |
| Reusable Agents/Skills/Plugins | AgenticTools | agentictools/agents, agentictools/skills, agentictools/plugins. Canonical authority for reusable agentic capability. |
| Authorization | ContractPlane / Cedar | Authorization policy. Not a secret store; not a scheduler. |
| Secrets | 1Password | Sole secret authority. AUTHENTICATE_ONCE=YES. |
2. Source Authority Matrix¶
ORGANIZATIONAL ENGINEERING KNOWLEDGE -> BluCity-Docs
PROJECT KNOWLEDGE -> project repository
WORK -> Gas City / Beads
SOURCE / MR / CI / RELEASE -> GitLab
AGENTS -> AgenticTools/agents
SKILLS -> AgenticTools/skills
PLUGINS -> AgenticTools/plugins
PRIVATE FACTORY PACKS -> BluCity-Packs
PUBLIC DRUPAL FACTORY PACK -> DrupalWorks
CITY DEPLOYMENT -> BluCity
GOVERNED HUMAN/BUSINESS CONTEXT UI -> ContextControl
AUTHORIZATION -> ContractPlane / Cedar
SECRETS -> 1Password
3. Agent Persona Authorities¶
| Agent | Responsibility | Canonical Domain | Key Primitives |
|---|---|---|---|
| BLU | Factory Coordinator | Convoy / Mountain visibility, cross-agent coordination, human escalation | gc mail, gc sling, bd list, gc status |
| MAYOR | Work & Runtime Coordinator | Beads ledger health, work routing, dependency graph, city health | bd update, bd ready, gc beads, dolt |
| REFINERY | Source & Delivery Lifecycle | Branch lifecycle, Gas City worktrees, GitLab MRs, CI, release merges | git, glab, worktree |
| WITNESS | Independent Verification | Acceptance proof, runtime verification, DoD validation, evidence sufficiency | bd sync, tests, verification receipts |
| HARBORMASTER | Knowledge & Context Governance | BluCity-Docs curation, authority mapping, project context economy, portable handoffs | STD-CONTEXT-001, qmd, doc audits |
| FOUNDRY | Reusable Capability Builder | Packs, Formulas (V2), Orders, Skills, upstream pack imports | blucity-packs, pack.toml, formula |
| SENTINEL | Security & Policy | Secret hygiene, .env enforcement, authorization boundaries, Cedar gates |
cedar, op, secret scanners |
| OPENCLAW | Communications & Transport | Notification transport, webhook adapters, messaging gateways | OpenClaw gateway, event listeners |
4. Prioritized Capability Gap Backlog¶
| Priority | Family | Capability | Owner Agent | Primitive | Current State | Bead |
|---|---|---|---|---|---|---|
| P0 | Runtime Hygiene | Decommission gastown-gateway crash loop on Oracle |
MAYOR | Host Service | Crash loop NRestarts>48k; mask service | bc-lm6m |
| P0 | Security | .env.op / 1Password reference enforcement on every MR |
SENTINEL | Formula / Order | Not enforced in CI | — |
| P1 | GC Health | City Topology & Rig Status Audit | MAYOR | Formula | Missing Formula | bc-1guz |
| P1 | Worktrees | Worktree Convergence & Pruning post-merge | REFINERY | Order → Formula | Manual; automate | — |
| P1 | Source | GitLab Merge & Release Gate Enforcement | REFINERY | Order → Formula | Semi-automated | — |
| P1 | Context | BluCity-Docs & Repository Context Architecture Convergence | HARBORMASTER | Formula | In progress | bc-i046 |
| P2 | Evidence | Work Verification Receipt Generation | WITNESS | Formula | Manual receipt generation | — |
| P2 | Policy | Policy Drift & Authority Duplication Scanner | HARBORMASTER | Formula | Missing Formula | — |
5. Conflict Resolution Protocol (§1 Claim-Scoped Authority)¶
When two sources disagree, classify the claim type first:
CLAIM=
CLAIM_TYPE= # runtime | implementation | policy | product | upstream-platform
AUTHORITATIVE_SOURCE=
CONFLICTING_SOURCE=
OBSERVED_VALUE=
EXPECTED_VALUE=
CLASSIFICATION= # RUNTIME_DRIFT | SOURCE_DRIFT | DOCUMENTATION_DRIFT | POLICY_NONCONFORMANCE | STALE_PROJECTION
REMEDIATION_OWNER=
BEAD=
Do not average conflicting sources. Do not let observation silently override policy.