Engineering Standard — Catalog Directory Index¶
Authority: BluCity-Docs Engineering Standard
Scope: Canonical inventories, registries, and composition catalogs across the Bluefly platform.
Rule: Kept strictly flat per estate operating model. All catalogs here are evergreen operational references; dated audits belong inledger/audits/, playbooks inPlaybooks/, and schemas instandards/schemas/.
1. Portfolio Registry Generated Catalogs¶
These catalogs are projected deterministically from Engineering-Standard/authority/Portfolio-Registry.yaml using python3 Engineering-Standard/authority/generate-catalogs.py. Never hand-edit these files.
| Document | Standard ID | Scope | Generation Source | Status |
|---|---|---|---|---|
| products.md | STD-CAT-007 |
Business products sold or operated by Bluefly | Portfolio-Registry.yaml |
Generated |
| packs.md | STD-CAT-003 |
Gas City capability packs (upstream & Bluefly) | Portfolio-Registry.yaml |
Generated |
| deployments.md | STD-CAT-002 |
Host environments and active project deployment mappings | Portfolio-Registry.yaml |
Generated |
| capabilities.md | STD-CAT-001 |
Platform and organizational capabilities inventory | Portfolio-Registry.yaml |
Generated |
| authorities.md | STD-CAT-006 |
Domain authorities and decision boundaries | Portfolio-Registry.yaml |
Generated |
| gitlab-repos.md | STD-CAT-008 |
Raw repository inventory across the blueflyio GitLab group |
Portfolio-Registry.yaml |
Generated |
2. Gas City / BluCity Composition Catalogs¶
Catalogs defining Bluefly's deployment of Gas City and Beads orchestration primitives.
| Document | Standard ID | Scope | Authority Class | Status |
|---|---|---|---|---|
| gc-catalog.md | STD-CAT-GC-001 |
Master catalog index and portfolio taxonomy (Mountain/Product/Convoy) | Bluefly Master Index | Evergreen |
| gc-agents.md | STD-CAT-GC-002 |
Organization and pack-level agent roles & 5-axis model | Bluefly Inventory | Evergreen |
| gc-cities.md | STD-CAT-GC-003 |
City topology, Split Storage, and Oracle runtime authority | Bluefly Inventory | Evergreen |
| gc-convoys.md | STD-CAT-GC-004 |
Convoy primitive, lifecycle mechanics, and metadata schema | Bluefly Inventory | Evergreen |
| gc-events.md | STD-CAT-GC-005 |
Canonical orchestration event vocabulary contracts | Bluefly Inventory | Evergreen |
| gc-formulas.md | STD-CAT-GC-006 |
Reusable formula DAGs and step graph conventions | Bluefly Inventory | Evergreen |
| gc-integrations.md | STD-CAT-GC-007 |
External MCP endpoints, providers, and adapters | Bluefly Inventory | Evergreen |
| gc-orders.md | STD-CAT-GC-008 |
Scheduled and event-driven formula trigger bindings | Bluefly Inventory | Evergreen |
| gc-rigs.md | STD-CAT-GC-009 |
Model B Git-backed work domain rigs & on-demand lifecycle | Bluefly Inventory | Evergreen |
3. Platform, Infrastructure & Technology Catalogs¶
Authoritative inventories of machine configurations, tools, identity, and dependencies.
| Document | Standard ID | Scope | Authority Class | Status |
|---|---|---|---|---|
| agent-identity-registry.yaml | STD-AGENT-ID-001 |
Machine data for autonomous agent service identities | Canonical Machine Data | Canonical |
| machine-identity-catalog.md | STD-CAT-ID-001 |
Machine service accounts and principal mappings | Canonical Inventory | Draft |
| ci-cd-variables.md | STD-CAT-010 |
Inherited group-level CI/CD pipeline variables | Canonical Inventory | Evergreen |
| drupal-ai-ecosystem.md | STD-CAT-DRUPAL-001 |
Drupal modules, themes, recipes, and upstream status | Canonical Inventory | Evergreen |
| factory-capability-matrix.md | STD-CAT-FAC-001 |
Factory operational execution and gate capabilities | Canonical Inventory | Canonical |
| failure-signature-catalog.md | STD-CAT-FAIL-001 |
Known operational defect signatures and recovery paths | Canonical Inventory | Evergreen |
| technologies.md | STD-CAT-TECH-001 |
Portfolio technology stack and library classifications | Canonical Inventory | Evergreen |
| tools.md | STD-CAT-TOOL-001 |
Engineering tools, utilities, and CLI dependencies | Canonical Inventory | Evergreen |
| upstream-links.md | STD-CAT-UPSTREAM-001 |
Official upstream authorities, portals, and specifications | Canonical Inventory | Evergreen |