# ai-unified-process/marketplace architecture

> Architecture diagram of the GitHub repository ai-unified-process/marketplace, 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/ai-unified-process/marketplace
- Repository: https://github.com/ai-unified-process/marketplace

## Overview

AI Unified Process Marketplace packages a requirements-first development workflow as portable agent plugins and skills. Its main journey turns product intent into reviewed requirements, domain and use-case artifacts, then implementation and traceable tests, before acceptance and handover artifacts. Stack plugins provide technology-specific construction; spec review and next-step guidance support the workflow throughout. The README documents the stages and handoffs; the tree exposes selected skill scripts and the Werkstatt runner, not the full plugin implementation, so most workflow edges reflect documented behavior.

Main entry points: [`aiup-core/skills/use-case-spec/scripts/validate_use_case.py`](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/use-case-spec/scripts/validate_use_case.py) (Use-case specs), [`pipelines/werkstatt/werkstatt.py`](https://github.com/ai-unified-process/marketplace/blob/main/pipelines/werkstatt/werkstatt.py) (Werkstatt automation), [`aiup-core/skills`](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills) (Use-case diagram), [`aiup-core/skills/test-case/scripts/bpmn_paths.py`](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/test-case/scripts/bpmn_paths.py) (Test journeys)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inception["Inception"]
  node_requirements["Requirements"]
end

subgraph group_elaboration["Elaboration"]
  node_entity_model["Entity model"]
  node_stack["Stack selection"]
  node_use_case_diagram["Use-case diagram"]
  node_business_process["Business process<br/>[bpmn_layout.py]"]
end

subgraph group_construction["Construction"]
  node_use_case_spec["Use-case specs"]
  node_implementation["Implementation"]
  node_test_case["Test journeys<br/>[bpmn_paths.py]"]
  node_test_automation["Automated tests"]
  node_coverage["Coverage audit<br/>[coverage_report.py]"]
end

subgraph group_transition["Transition"]
  node_acceptance["Acceptance protocol"]
  node_user_guide["User guide<br/>[guide_anchor.py]"]
  node_release_notes["Release notes"]
end

subgraph group_support["Workflow support"]
  node_spec_review["Spec review<br/>[spec_lint.py]"]
  node_next_step["Next-step guidance"]
  node_werkstatt["Werkstatt automation<br/>[werkstatt.py]"]
end

node_developer(("Product team"))

node_developer -->|"defines vision"| node_requirements
node_requirements -->|"informs"| node_entity_model
node_entity_model -->|"precedes"| node_stack
node_stack -->|"sets context"| node_use_case_diagram
node_use_case_diagram -->|"guides"| node_use_case_spec
node_use_case_diagram -.->|"may elaborate"| node_business_process
node_use_case_spec -->|"guides"| node_implementation
node_use_case_spec -->|"traces into"| node_test_case
node_test_case -->|"automates journey"| node_test_automation
node_implementation -->|"is audited by"| node_coverage
node_test_automation -->|"is audited by"| node_coverage
node_test_case -->|"supplies cases"| node_acceptance
node_use_case_spec -->|"supplies content"| node_user_guide
node_use_case_spec -->|"tracks completion"| node_release_notes
node_spec_review -->|"reviews"| node_use_case_spec
node_next_step -->|"identifies next"| node_use_case_spec
node_werkstatt -->|"runs lint"| node_spec_review
node_werkstatt -->|"runs construction"| node_implementation
node_werkstatt -->|"audits result"| node_coverage

click node_requirements "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_entity_model "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_stack "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_use_case_diagram "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_business_process "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/business-process/scripts/bpmn_layout.py"
click node_use_case_spec "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/use-case-spec/scripts/validate_use_case.py"
click node_implementation "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_test_case "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/test-case/scripts/bpmn_paths.py"
click node_test_automation "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_coverage "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/use-case-coverage/scripts/coverage_report.py"
click node_acceptance "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_user_guide "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/user-guide/scripts/guide_anchor.py"
click node_release_notes "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_spec_review "https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/spec-review/scripts/spec_lint.py"
click node_next_step "https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills"
click node_werkstatt "https://github.com/ai-unified-process/marketplace/blob/main/pipelines/werkstatt/werkstatt.py"

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_requirements toneBlue
class node_entity_model,node_stack,node_use_case_diagram,node_business_process toneAmber
class node_use_case_spec,node_implementation,node_test_case,node_test_automation,node_coverage toneMint
class node_acceptance,node_user_guide,node_release_notes toneRose
class node_spec_review,node_next_step,node_werkstatt,node_developer toneIndigo
```

## Components

### Inception

- [Requirements](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`

### Elaboration

- [Entity model](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Stack selection](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Use-case diagram](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Business process](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/business-process/scripts/bpmn_layout.py): `aiup-core/skills/business-process/scripts/bpmn_layout.py`

### Construction

- [Use-case specs](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/use-case-spec/scripts/validate_use_case.py): `aiup-core/skills/use-case-spec/scripts/validate_use_case.py`
- [Implementation](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Test journeys](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/test-case/scripts/bpmn_paths.py): `aiup-core/skills/test-case/scripts/bpmn_paths.py`
- [Automated tests](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Coverage audit](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/use-case-coverage/scripts/coverage_report.py): `aiup-core/skills/use-case-coverage/scripts/coverage_report.py`

### Transition

- [Acceptance protocol](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [User guide](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/user-guide/scripts/guide_anchor.py): `aiup-core/skills/user-guide/scripts/guide_anchor.py`
- [Release notes](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`

### Workflow support

- [Spec review](https://github.com/ai-unified-process/marketplace/blob/main/aiup-core/skills/spec-review/scripts/spec_lint.py): `aiup-core/skills/spec-review/scripts/spec_lint.py`
- [Next-step guidance](https://github.com/ai-unified-process/marketplace/tree/main/aiup-core/skills): `aiup-core/skills`
- [Werkstatt automation](https://github.com/ai-unified-process/marketplace/blob/main/pipelines/werkstatt/werkstatt.py): `pipelines/werkstatt/werkstatt.py`

### Other components

- **Product team**

## Connections

- Product team → Requirements: defines vision (evidence: `README.md`)
- Requirements → Entity model: informs (evidence: `README.md`)
- Entity model → Stack selection: precedes (evidence: `README.md`)
- Stack selection → Use-case diagram: sets context (evidence: `README.md`)
- Use-case diagram → Use-case specs: guides (evidence: `README.md`)
- Use-case diagram → Business process: may elaborate (evidence: `README.md`)
- Use-case specs → Implementation: guides (evidence: `README.md`)
- Use-case specs → Test journeys: traces into (evidence: `README.md`)
- Test journeys → Automated tests: automates journey (evidence: `README.md`)
- Implementation → Coverage audit: is audited by (evidence: `README.md`)
- Automated tests → Coverage audit: is audited by (evidence: `README.md`)
- Test journeys → Acceptance protocol: supplies cases (evidence: `README.md`)
- Use-case specs → User guide: supplies content (evidence: `README.md`)
- Use-case specs → Release notes: tracks completion (evidence: `README.md`)
- Spec review → Use-case specs: reviews (evidence: `README.md`)
- Next-step guidance → Use-case specs: identifies next (evidence: `README.md`)
- Werkstatt automation → Spec review: runs lint (evidence: `README.md`)
- Werkstatt automation → Implementation: runs construction (evidence: `README.md`)
- Werkstatt automation → Coverage audit: audits result (evidence: `README.md`)
