# eimg/acme-software-factory architecture

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

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

## Overview

Acme Software Factory is a suite of independently runnable products, not a single application. Its principal paths are new-project inception (optional Primer evidence, Prelude bootstrap, then Helix workspace setup) and existing-project delivery (Projects exploration, Issues handoff, Helix implementation, review evidence, and human merge). Identity, Observability, Steering, and Intel provide distinct cross-cutting capabilities. The relationships shown are documented in the README; subproject source was not available in the supplied tree, so internal calls and unshown integration details are omitted.

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

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inception["Project Inception"]
  node_primer["Primer"]
  node_prelude["Prelude"]
end

subgraph group_delivery["Work Delivery"]
  node_helix["Helix"]
  node_issues["Acme Issues"]
  node_projects["Acme Projects"]
end

subgraph group_crosscut["Cross-Cutting Products"]
  node_identity["Acme Identity"]
  node_obs["Acme Observability"]
  node_steering["Acme Steering"]
  node_intel["Acme Intel"]
end

subgraph group_target["Target Application"]
  node_todo["Acme Todo"]
end

node_user(("Human"))

node_user -.->|"seeks evidence"| node_primer
node_primer -.->|"provides evidence"| node_prelude
node_user -->|"starts inception"| node_prelude
node_prelude -->|"exports bootstrap"| node_helix
node_user -->|"explores features"| node_projects
node_projects -->|"hands off issue"| node_issues
node_user -->|"starts implementation"| node_issues
node_issues -->|"triggers work"| node_helix
node_helix -->|"implements in"| node_todo
node_helix -->|"reports evidence"| node_issues
node_user -->|"reviews and merges"| node_issues
node_identity -.->|"authenticates"| node_primer
node_identity -.->|"authenticates"| node_prelude
node_identity -.->|"authenticates"| node_helix
node_identity -.->|"authenticates"| node_issues
node_identity -.->|"authenticates"| node_projects
node_obs -.->|"projects facts"| node_primer
node_obs -.->|"projects facts"| node_prelude
node_obs -.->|"projects facts"| node_helix
node_obs -.->|"projects facts"| node_issues
node_obs -.->|"projects facts"| node_projects
node_prelude -.->|"notifies lifecycle"| node_steering
node_helix -.->|"notifies lifecycle"| node_steering
node_issues -.->|"notifies lifecycle"| node_steering
node_projects -.->|"notifies lifecycle"| node_steering
node_steering -.->|"invokes export"| node_prelude
node_steering -.->|"invokes submission"| node_projects
node_steering -.->|"invokes trigger"| node_issues
node_steering -.->|"invokes recovery"| node_helix
node_intel -.->|"proposes findings"| node_primer
node_intel -.->|"proposes policy"| node_steering

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

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_issues,node_projects toneAmber
class node_identity,node_obs,node_steering,node_intel toneMint
class node_todo toneRose
class node_user toneIndigo
```

## Components

### Project Inception

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

### Work Delivery

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

### Cross-Cutting Products

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

### Target Application

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

### Other components

- **Human**

## Connections

- Human → Primer: seeks evidence (evidence: `README.md`)
- Primer → Prelude: provides evidence (evidence: `README.md`)
- Human → Prelude: starts inception (evidence: `README.md`)
- Prelude → Helix: exports bootstrap (evidence: `README.md`)
- Human → Acme Projects: explores features (evidence: `README.md`)
- Acme Projects → Acme Issues: hands off issue (evidence: `README.md`)
- Human → Acme Issues: starts implementation (evidence: `README.md`)
- Acme Issues → Helix: triggers work (evidence: `README.md`)
- Helix → Acme Todo: implements in (evidence: `README.md`)
- Helix → Acme Issues: reports evidence (evidence: `README.md`)
- Human → Acme Issues: reviews and merges (evidence: `README.md`)
- Acme Identity → Primer: authenticates (evidence: `README.md`)
- Acme Identity → Prelude: authenticates (evidence: `README.md`)
- Acme Identity → Helix: authenticates (evidence: `README.md`)
- Acme Identity → Acme Issues: authenticates (evidence: `README.md`)
- Acme Identity → Acme Projects: authenticates (evidence: `README.md`)
- Acme Observability → Primer: projects facts (evidence: `README.md`)
- Acme Observability → Prelude: projects facts (evidence: `README.md`)
- Acme Observability → Helix: projects facts (evidence: `README.md`)
- Acme Observability → Acme Issues: projects facts (evidence: `README.md`)
- Acme Observability → Acme Projects: projects facts (evidence: `README.md`)
- Prelude → Acme Steering: notifies lifecycle (evidence: `README.md`)
- Helix → Acme Steering: notifies lifecycle (evidence: `README.md`)
- Acme Issues → Acme Steering: notifies lifecycle (evidence: `README.md`)
- Acme Projects → Acme Steering: notifies lifecycle (evidence: `README.md`)
- Acme Steering → Prelude: invokes export (evidence: `README.md`)
- Acme Steering → Acme Projects: invokes submission (evidence: `README.md`)
- Acme Steering → Acme Issues: invokes trigger (evidence: `README.md`)
- Acme Steering → Helix: invokes recovery (evidence: `README.md`)
- Acme Intel → Primer: proposes findings (evidence: `README.md`)
- Acme Intel → Acme Steering: proposes policy (evidence: `README.md`)
