# akoliteza/hermes-agent-idea-workflow architecture

> Architecture diagram of the GitHub repository akoliteza/hermes-agent-idea-workflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akoliteza/hermes-agent-idea-workflow
- Repository: https://github.com/akoliteza/hermes-agent-idea-workflow

## Overview

Hermes Agent Idea Workflow is a pre-build specification toolset, not a coding system. Its principal workflow turns a user’s idea into staged Markdown artifacts, then reviews and hands off the build-ready specification to a separate execution workflow. The graph follows capabilities and artifact relationships documented in the README; source excerpts were unavailable, so it does not infer internal calls beyond those descriptions.

Main entry points: [`idea-superpowers-suite/SKILL.md`](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/SKILL.md) (Idea workflow), [`idea-to-design-doc/SKILL.md`](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-design-doc/SKILL.md) (Design document), [`idea-to-implementation-doc/SKILL.md`](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-implementation-doc/SKILL.md) (Implementation spec), [`idea-superpowers-suite/references/interview-question-bank.md`](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/references/interview-question-bank.md) (Guided interview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Idea capture"]
  node_suite["Idea workflow<br/>[SKILL.md]"]
  node_interview["Guided interview"]
  node_lite["Lite idea note"]
  node_full["Full idea package"]
  node_examples["Handoff examples"]
end

subgraph group_specification["Product specification"]
  node_design["Design document<br/>[SKILL.md]"]
  node_ui["UI design brief<br/>[SKILL.md]"]
  node_implementation["Implementation spec<br/>[SKILL.md]"]
end

subgraph group_handoff["Review and handoff"]
  node_handoff_template["Handoff template"]
  node_handoff["Build handoff"]
  node_review["Spec review<br/>[SKILL.md]"]
end

node_user(("Idea owner"))
node_superpowers(("Superpowers workflow"))

node_user -->|"provides idea"| node_suite
node_suite -->|"uses questions"| node_interview
node_suite -->|"captures lite"| node_lite
node_suite -->|"starts full package"| node_full
node_suite -->|"guides design stage"| node_design
node_design -.->|"may add UI brief"| node_ui
node_design -->|"informs implementation spec"| node_implementation
node_implementation -->|"uses template"| node_handoff_template
node_implementation -->|"produces handoff"| node_handoff
node_suite -->|"provides review gate"| node_review
node_review -->|"reviews specification"| node_handoff
node_handoff -->|"feeds build workflow"| node_superpowers
node_suite -->|"provides examples"| node_examples

click node_suite "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/SKILL.md"
click node_interview "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/references/interview-question-bank.md"
click node_full "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/templates/idea-package-readme-template.md"
click node_design "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-design-doc/SKILL.md"
click node_ui "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-ui-design-brief/SKILL.md"
click node_implementation "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-implementation-doc/SKILL.md"
click node_handoff_template "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-implementation-doc/templates/agent-build-handoff-template.md"
click node_review "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/SKILL.md"
click node_examples "https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/references/example-saas-web-app-build-handoff.md"

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_suite,node_interview,node_lite,node_full,node_examples toneBlue
class node_design,node_ui,node_implementation toneAmber
class node_handoff_template,node_handoff,node_review toneMint
class node_user,node_superpowers toneIndigo
```

## Components

### Idea capture

- [Idea workflow](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/SKILL.md): `idea-superpowers-suite/SKILL.md`
- [Guided interview](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/references/interview-question-bank.md): `idea-superpowers-suite/references/interview-question-bank.md`
- **Lite idea note**
- [Full idea package](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/templates/idea-package-readme-template.md): `idea-superpowers-suite/templates/idea-package-readme-template.md`
- [Handoff examples](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/references/example-saas-web-app-build-handoff.md): `idea-superpowers-suite/references/example-saas-web-app-build-handoff.md`

### Product specification

- [Design document](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-design-doc/SKILL.md): `idea-to-design-doc/SKILL.md`
- [UI design brief](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-ui-design-brief/SKILL.md): `idea-to-ui-design-brief/SKILL.md`
- [Implementation spec](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-implementation-doc/SKILL.md): `idea-to-implementation-doc/SKILL.md`

### Review and handoff

- [Handoff template](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-to-implementation-doc/templates/agent-build-handoff-template.md): `idea-to-implementation-doc/templates/agent-build-handoff-template.md`
- **Build handoff**
- [Spec review](https://github.com/akoliteza/hermes-agent-idea-workflow/blob/main/idea-superpowers-suite/SKILL.md): `idea-superpowers-suite/SKILL.md`

### Other components

- **Idea owner**
- **Superpowers workflow**

## Connections

- Idea owner → Idea workflow: provides idea
- Idea workflow → Guided interview: uses questions
- Idea workflow → Lite idea note: captures lite
- Idea workflow → Full idea package: starts full package
- Idea workflow → Design document: guides design stage
- Design document → UI design brief: may add UI brief
- Design document → Implementation spec: informs implementation spec
- Implementation spec → Handoff template: uses template
- Implementation spec → Build handoff: produces handoff
- Idea workflow → Spec review: provides review gate
- Spec review → Build handoff: reviews specification
- Build handoff → Superpowers workflow: feeds build workflow
- Idea workflow → Handoff examples: provides examples