# thetpainghmoo/acme-software-factory architecture

> Architecture diagram of the GitHub repository thetpainghmoo/acme-software-factory, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thetpainghmoo/acme-software-factory
- Repository: https://github.com/thetpainghmoo/acme-software-factory

## Overview

Acme Software Factory is a suite of independently runnable products, not a single application. Its documented workflows are project inception (optional Primer evidence through Prelude to a Helix workspace) and existing-project delivery (Projects handoff through Issues to Helix, review evidence, and human merge). Identity, Observability, Steering, and Intel have distinct cross-cutting roles. This view is based on the README; subproject source was not sampled, so edges describe documented contracts rather than inspected implementation calls.

Main entry points: [`acme-steering`](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-steering) (Acme Steering), [`helix`](https://github.com/thetpainghmoo/acme-software-factory/tree/main/helix) (Helix workflows), [`acme-issues`](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-issues) (Acme Issues), [`acme-projects`](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-projects) (Acme Projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inception["Project inception"]
  node_primer["Primer knowledge"]
  node_prelude["Prelude inception"]
end

subgraph group_delivery["Implementation delivery"]
  node_helix["Helix workflows"]
  node_target["Target repository"]
  node_projects["Acme Projects"]
  node_issues["Acme Issues"]
end

subgraph group_crosscut["Cross-cutting services"]
  node_identity["Acme Identity"]
  node_observability["Acme Observability"]
  node_steering["Acme Steering"]
  node_intel["Acme Intel"]
end

subgraph group_suite["Suite support"]
  node_todo["Acme Todo"]
end

node_human(("Human operator"))

node_primer -->|"provides optional evidence"| node_prelude
node_prelude -->|"exports bootstrap"| node_helix
node_helix -->|"implements in"| node_target
node_human -->|"explores features"| node_projects
node_projects -->|"hands off ready work"| node_issues
node_human -->|"starts implementation"| node_issues
node_issues -->|"triggers workflow"| node_helix
node_helix -->|"reports lifecycle and review"| node_issues
node_human -->|"reviews and merges"| node_issues
node_identity -.->|"supplies shared credentials"| node_primer
node_identity -.->|"supplies shared credentials"| node_prelude
node_identity -.->|"supplies shared credentials"| node_helix
node_identity -.->|"supplies shared credentials"| node_issues
node_identity -.->|"supplies shared credentials"| node_projects
node_observability -->|"pulls allowlisted facts"| node_projects
node_observability -->|"pulls allowlisted facts"| node_issues
node_observability -->|"pulls allowlisted facts"| node_helix
node_prelude -->|"sends lifecycle events"| node_steering
node_helix -->|"sends lifecycle events"| node_steering
node_issues -->|"sends lifecycle events"| node_steering
node_projects -->|"sends lifecycle events"| node_steering
node_steering -->|"invokes approved export"| node_prelude
node_steering -->|"invokes approved submission"| node_projects
node_steering -->|"invokes approved trigger"| node_issues
node_steering -->|"invokes approved recovery"| node_helix
node_intel -.->|"proposes reviewed findings"| node_primer
node_human -->|"decides interventions"| node_steering
node_human -.->|"reviews findings"| node_intel
node_todo -->|"exercises workflows"| node_helix

click node_primer "https://github.com/thetpainghmoo/acme-software-factory/tree/main/primer"
click node_prelude "https://github.com/thetpainghmoo/acme-software-factory/tree/main/prelude"
click node_helix "https://github.com/thetpainghmoo/acme-software-factory/tree/main/helix"
click node_projects "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-projects"
click node_issues "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-issues"
click node_identity "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-identity"
click node_observability "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-obs"
click node_steering "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-steering"
click node_intel "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-intel"
click node_todo "https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-todo"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_primer,node_prelude toneBlue
class node_helix,node_target,node_projects,node_issues toneAmber
class node_identity,node_observability,node_steering,node_intel toneMint
class node_todo toneRose
class node_human toneIndigo
```

## Components

### Project inception

- [Primer knowledge](https://github.com/thetpainghmoo/acme-software-factory/tree/main/primer): `primer`
- [Prelude inception](https://github.com/thetpainghmoo/acme-software-factory/tree/main/prelude): `prelude`

### Implementation delivery

- [Helix workflows](https://github.com/thetpainghmoo/acme-software-factory/tree/main/helix): `helix`
- **Target repository**
- [Acme Projects](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-projects): `acme-projects`
- [Acme Issues](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-issues): `acme-issues`

### Cross-cutting services

- [Acme Identity](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-identity): `acme-identity`
- [Acme Observability](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-obs): `acme-obs`
- [Acme Steering](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-steering): `acme-steering`
- [Acme Intel](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-intel): `acme-intel`

### Suite support

- [Acme Todo](https://github.com/thetpainghmoo/acme-software-factory/tree/main/acme-todo): `acme-todo`

### Other components

- **Human operator**

## Connections

- Primer knowledge → Prelude inception: provides optional evidence (evidence: `README.md`)
- Prelude inception → Helix workflows: exports bootstrap (evidence: `README.md`)
- Helix workflows → Target repository: implements in (evidence: `README.md`)
- Human operator → Acme Projects: explores features (evidence: `README.md`)
- Acme Projects → Acme Issues: hands off ready work (evidence: `README.md`)
- Human operator → Acme Issues: starts implementation (evidence: `README.md`)
- Acme Issues → Helix workflows: triggers workflow (evidence: `README.md`)
- Helix workflows → Acme Issues: reports lifecycle and review (evidence: `README.md`)
- Human operator → Acme Issues: reviews and merges (evidence: `README.md`)
- Acme Identity → Primer knowledge: supplies shared credentials (evidence: `README.md`)
- Acme Identity → Prelude inception: supplies shared credentials (evidence: `README.md`)
- Acme Identity → Helix workflows: supplies shared credentials (evidence: `README.md`)
- Acme Identity → Acme Issues: supplies shared credentials (evidence: `README.md`)
- Acme Identity → Acme Projects: supplies shared credentials (evidence: `README.md`)
- Acme Observability → Acme Projects: pulls allowlisted facts (evidence: `README.md`)
- Acme Observability → Acme Issues: pulls allowlisted facts (evidence: `README.md`)
- Acme Observability → Helix workflows: pulls allowlisted facts (evidence: `README.md`)
- Prelude inception → Acme Steering: sends lifecycle events (evidence: `README.md`)
- Helix workflows → Acme Steering: sends lifecycle events (evidence: `README.md`)
- Acme Issues → Acme Steering: sends lifecycle events (evidence: `README.md`)
- Acme Projects → Acme Steering: sends lifecycle events (evidence: `README.md`)
- Acme Steering → Prelude inception: invokes approved export (evidence: `README.md`)
- Acme Steering → Acme Projects: invokes approved submission (evidence: `README.md`)
- Acme Steering → Acme Issues: invokes approved trigger (evidence: `README.md`)
- Acme Steering → Helix workflows: invokes approved recovery (evidence: `README.md`)
- Acme Intel → Primer knowledge: proposes reviewed findings (evidence: `README.md`)
- Human operator → Acme Steering: decides interventions (evidence: `README.md`)
- Human operator → Acme Intel: reviews findings (evidence: `README.md`)
- Acme Todo → Helix workflows: exercises workflows (evidence: `README.md`)
