# warpdotdev/warp-factory-examples architecture

> Architecture diagram of the GitHub repository warpdotdev/warp-factory-examples, 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/warpdotdev/warp-factory-examples
- Repository: https://github.com/warpdotdev/warp-factory-examples

## Overview

This repository is a catalog of configurable Warp Factories examples, not a runtime application or library. The user workflow is to choose and customize an example, commit it to a GitHub repository, then configure Warp to sync its factory definition. The graph groups the documented example capabilities by purpose. Relationships are based on README statements; individual configuration files were not sampled, so internal agent and automation dispatch is not inferred.

Main entry points: [`examples`](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples) (Example catalog), [`examples/01-single-repo-quickstart/factory.yaml`](https://github.com/warpdotdev/warp-factory-examples/blob/main/examples/01-single-repo-quickstart/factory.yaml) (Factory definition), [`README.md`](https://github.com/warpdotdev/warp-factory-examples/blob/main/README.md) (Config check), [`examples/01-single-repo-quickstart`](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/01-single-repo-quickstart) (Issue to PR)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Factory setup"]
  node_catalog["Example catalog"]
  node_definition["Factory definition<br/>[factory.yaml]"]
  node_config_check["Config check<br/>[README.md]"]
end

subgraph group_workflows["Work intake workflows"]
  node_quickstart["Issue to PR"]
  node_sdlc["SDLC workflow"]
  node_slack_pr["Slack to PR"]
  node_linear_pr["Linear to PR"]
  node_jira_pr["Jira to PR"]
end

subgraph group_specialized["Specialized workflows"]
  node_review["Review only"]
  node_ui_check["UI verification"]
  node_monorepo["Monorepo changes"]
  node_services["Related services"]
  node_self_hosted["Self-hosted worker"]
end

subgraph group_resources["Factory resources"]
  node_agents["Agent definitions"]
  node_automations["Automation definitions"]
  node_runners["Runner definitions"]
  node_skills_scorers["Skills and scoring"]
end

node_user(("Factory author"))
node_github(("GitHub repository"))
node_warp{{"Warp Factories"}}

node_user -->|"chooses example"| node_catalog
node_catalog -->|"provides configuration"| node_definition
node_user -->|"customizes"| node_definition
node_user -->|"commits definition"| node_github
node_github -->|"hosts definition"| node_warp
node_warp -->|"sync requires"| node_config_check
node_catalog -->|"includes"| node_quickstart
node_catalog -->|"includes"| node_sdlc
node_catalog -->|"includes"| node_slack_pr
node_catalog -->|"includes"| node_linear_pr
node_catalog -->|"includes"| node_jira_pr
node_catalog -->|"includes"| node_review
node_catalog -->|"includes"| node_ui_check
node_catalog -->|"includes"| node_monorepo
node_catalog -->|"includes"| node_services
node_catalog -->|"includes"| node_self_hosted
node_definition -->|"configures resources"| node_agents
node_definition -->|"configures resources"| node_automations
node_definition -->|"configures resources"| node_runners
node_definition -->|"configures resources"| node_skills_scorers

click node_catalog "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples"
click node_definition "https://github.com/warpdotdev/warp-factory-examples/blob/main/examples/01-single-repo-quickstart/factory.yaml"
click node_config_check "https://github.com/warpdotdev/warp-factory-examples/blob/main/README.md"
click node_quickstart "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/01-single-repo-quickstart"
click node_sdlc "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr"
click node_slack_pr "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/08-slack-to-pr"
click node_linear_pr "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/10-linear-to-pr"
click node_jira_pr "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/11-jira-to-pr"
click node_review "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/04-code-review-only"
click node_ui_check "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/05-ui-verification"
click node_monorepo "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/24-monorepo-product"
click node_services "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/25-related-services"
click node_agents "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/00-warp-default-agents/agents"
click node_automations "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr/automations"
click node_runners "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr/runners"
click node_skills_scorers "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr"
click node_self_hosted "https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/07-self-hosted-worker"

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_catalog,node_definition,node_config_check toneBlue
class node_quickstart,node_sdlc,node_slack_pr,node_linear_pr,node_jira_pr toneAmber
class node_review,node_ui_check,node_monorepo,node_services,node_self_hosted toneMint
class node_agents,node_automations,node_runners,node_skills_scorers toneRose
class node_user,node_github,node_warp toneIndigo
```

## Components

### Factory setup

- [Example catalog](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples): `examples`
- [Factory definition](https://github.com/warpdotdev/warp-factory-examples/blob/main/examples/01-single-repo-quickstart/factory.yaml): `examples/01-single-repo-quickstart/factory.yaml`
- [Config check](https://github.com/warpdotdev/warp-factory-examples/blob/main/README.md): `README.md`

### Work intake workflows

- [Issue to PR](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/01-single-repo-quickstart): `examples/01-single-repo-quickstart`
- [SDLC workflow](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr): `examples/02-sdlc-issue-to-pr`
- [Slack to PR](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/08-slack-to-pr): `examples/08-slack-to-pr`
- [Linear to PR](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/10-linear-to-pr): `examples/10-linear-to-pr`
- [Jira to PR](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/11-jira-to-pr): `examples/11-jira-to-pr`

### Specialized workflows

- [Review only](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/04-code-review-only): `examples/04-code-review-only`
- [UI verification](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/05-ui-verification): `examples/05-ui-verification`
- [Monorepo changes](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/24-monorepo-product): `examples/24-monorepo-product`
- [Related services](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/25-related-services): `examples/25-related-services`
- [Self-hosted worker](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/07-self-hosted-worker): `examples/07-self-hosted-worker`

### Factory resources

- [Agent definitions](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/00-warp-default-agents/agents): `examples/00-warp-default-agents/agents`
- [Automation definitions](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr/automations): `examples/02-sdlc-issue-to-pr/automations`
- [Runner definitions](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr/runners): `examples/02-sdlc-issue-to-pr/runners`
- [Skills and scoring](https://github.com/warpdotdev/warp-factory-examples/tree/main/examples/02-sdlc-issue-to-pr): `examples/02-sdlc-issue-to-pr`

### Other components

- **Factory author**
- **GitHub repository**
- **Warp Factories**

## Connections

- Factory author → Example catalog: chooses example (evidence: `README.md`)
- Example catalog → Factory definition: provides configuration (evidence: `README.md`)
- Factory author → Factory definition: customizes (evidence: `README.md`)
- Factory author → GitHub repository: commits definition (evidence: `README.md`)
- GitHub repository → Warp Factories: hosts definition (evidence: `README.md`)
- Warp Factories → Config check: sync requires (evidence: `README.md`)
- Example catalog → Issue to PR: includes (evidence: `README.md`)
- Example catalog → SDLC workflow: includes (evidence: `README.md`)
- Example catalog → Slack to PR: includes (evidence: `README.md`)
- Example catalog → Linear to PR: includes (evidence: `README.md`)
- Example catalog → Jira to PR: includes (evidence: `README.md`)
- Example catalog → Review only: includes (evidence: `README.md`)
- Example catalog → UI verification: includes (evidence: `README.md`)
- Example catalog → Monorepo changes: includes (evidence: `README.md`)
- Example catalog → Related services: includes (evidence: `README.md`)
- Example catalog → Self-hosted worker: includes (evidence: `README.md`)
- Factory definition → Agent definitions: configures resources (evidence: `README.md`)
- Factory definition → Automation definitions: configures resources (evidence: `README.md`)
- Factory definition → Runner definitions: configures resources (evidence: `README.md`)
- Factory definition → Skills and scoring: configures resources (evidence: `README.md`)
