# rh-ai-quickstart/agentic-software-factory architecture

> Architecture diagram of the GitHub repository rh-ai-quickstart/agentic-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/rh-ai-quickstart/agentic-software-factory
- Repository: https://github.com/rh-ai-quickstart/agentic-software-factory

## Overview

This repository demonstrates an agentic software factory: users submit requirements through a spec-collector UI, Scribe turns them into GitHub issues, Developer implements labeled issues as pull requests, and Review checks those changes against their originating specifications. Fixer and Rummager provide separate operational-response branches for pipeline failures and application-log errors. The README documents these product-level connections; sampled agent excerpts show orchestration and gateway use, but do not expose every integration implementation.

Main entry points: [`apps/llama-stack-kube-github`](https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github) (Llama Stack gateway), [`apps/spec-collector/server.js`](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/server.js) (Spec collector), [`apps/spec-collector/public/app.js`](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/public/app.js) (Collector UI), [`apps/scribe-agent/src/scribe_agent/main.py`](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/scribe-agent/src/scribe_agent/main.py) (Scribe agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Specification intake"]
  node_collector["Spec collector<br/>[server.js]"]
  node_collector_ui["Collector UI<br/>[app.js]"]
  node_requirements[("Requirements volume")]
  node_scribe["Scribe agent<br/>[main.py]"]
end

subgraph group_delivery["Issue to merge"]
  node_developer["Developer agent<br/>[main.py]"]
  node_review["Review agent<br/>[main.py]"]
end

subgraph group_operations["Operational response"]
  node_fixer["Fixer agent<br/>[main.py]"]
  node_rummager["Rummager agent<br/>[main.py]"]
end

subgraph group_gateway["AI gateway"]
  node_gateway_service["Llama Stack gateway"]
  node_github_mcp["GitHub MCP"]
  node_kubernetes_mcp["Kubernetes MCP"]
end

subgraph group_platform["Shared platform"]
  node_github["GitHub repository"]
  node_cluster["OpenShift cluster"]
  node_tekton["Tekton PipelineRuns"]
  node_app_logs["Application logs"]
  node_vllm["vLLM inference"]
end

node_user(("Product owner"))

node_user -->|"submits requirements"| node_collector_ui
node_collector_ui -->|"saves specification"| node_collector
node_collector -->|"writes files"| node_requirements
node_requirements -->|"reads mounted files"| node_scribe
node_scribe -->|"creates issues via"| node_gateway_service
node_developer -->|"uses for implementation"| node_gateway_service
node_review -->|"checks and merges via"| node_gateway_service
node_fixer -->|"queries and opens fixes via"| node_gateway_service
node_rummager -->|"investigates and files via"| node_gateway_service
node_gateway_service -->|"invokes tools"| node_github_mcp
node_gateway_service -->|"invokes tools"| node_kubernetes_mcp
node_gateway_service -->|"requests inference"| node_vllm
node_github_mcp -->|"accesses repository"| node_github
node_kubernetes_mcp -->|"queries resources"| node_cluster
node_cluster -->|"hosts pipeline runs"| node_tekton
node_cluster -->|"provides pod logs"| node_app_logs

click node_collector "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/server.js"
click node_collector_ui "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/public/app.js"
click node_scribe "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/scribe-agent/src/scribe_agent/main.py"
click node_developer "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/developer-agent/src/developer_agent/main.py"
click node_review "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/review-agent/src/review_agent/main.py"
click node_fixer "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/fixer-agent/src/fixer_agent/main.py"
click node_rummager "https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/rummager-agent/src/rummager_agent/main.py"
click node_gateway_service "https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github"
click node_github_mcp "https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github"
click node_kubernetes_mcp "https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github"

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_collector,node_collector_ui,node_requirements,node_scribe toneBlue
class node_developer,node_review toneAmber
class node_fixer,node_rummager toneMint
class node_gateway_service,node_github_mcp,node_kubernetes_mcp toneRose
class node_github,node_cluster,node_tekton,node_app_logs,node_vllm,node_user toneIndigo
```

## Components

### Specification intake

- [Spec collector](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/server.js): `apps/spec-collector/server.js`
- [Collector UI](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/spec-collector/public/app.js): `apps/spec-collector/public/app.js`
- **Requirements volume**
- [Scribe agent](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/scribe-agent/src/scribe_agent/main.py): `apps/scribe-agent/src/scribe_agent/main.py`

### Issue to merge

- [Developer agent](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/developer-agent/src/developer_agent/main.py): `apps/developer-agent/src/developer_agent/main.py`
- [Review agent](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/review-agent/src/review_agent/main.py): `apps/review-agent/src/review_agent/main.py`

### Operational response

- [Fixer agent](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/fixer-agent/src/fixer_agent/main.py): `apps/fixer-agent/src/fixer_agent/main.py`
- [Rummager agent](https://github.com/rh-ai-quickstart/agentic-software-factory/blob/main/apps/rummager-agent/src/rummager_agent/main.py): `apps/rummager-agent/src/rummager_agent/main.py`

### AI gateway

- [Llama Stack gateway](https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github): `apps/llama-stack-kube-github`
- [GitHub MCP](https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github): `apps/llama-stack-kube-github`
- [Kubernetes MCP](https://github.com/rh-ai-quickstart/agentic-software-factory/tree/main/apps/llama-stack-kube-github): `apps/llama-stack-kube-github`

### Shared platform

- **GitHub repository**
- **OpenShift cluster**
- **Tekton PipelineRuns**
- **Application logs**
- **vLLM inference**

### Other components

- **Product owner**

## Connections

- Product owner → Collector UI: submits requirements (evidence: `README.md`)
- Collector UI → Spec collector: saves specification (evidence: `README.md`)
- Spec collector → Requirements volume: writes files (evidence: `README.md`)
- Requirements volume → Scribe agent: reads mounted files (evidence: `README.md`)
- Scribe agent → Llama Stack gateway: creates issues via (evidence: `README.md`)
- Developer agent → Llama Stack gateway: uses for implementation (evidence: `README.md`)
- Review agent → Llama Stack gateway: checks and merges via (evidence: `README.md`)
- Fixer agent → Llama Stack gateway: queries and opens fixes via (evidence: `README.md`)
- Rummager agent → Llama Stack gateway: investigates and files via (evidence: `README.md`)
- Llama Stack gateway → GitHub MCP: invokes tools (evidence: `README.md`)
- Llama Stack gateway → Kubernetes MCP: invokes tools (evidence: `README.md`)
- Llama Stack gateway → vLLM inference: requests inference (evidence: `README.md`)
- GitHub MCP → GitHub repository: accesses repository (evidence: `README.md`)
- Kubernetes MCP → OpenShift cluster: queries resources (evidence: `README.md`)
- OpenShift cluster → Tekton PipelineRuns: hosts pipeline runs (evidence: `README.md`)
- OpenShift cluster → Application logs: provides pod logs (evidence: `README.md`)
