# jekoch4274/agentic-workflows architecture

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

- Interactive diagram: https://gitdiagram.com/jekoch4274/agentic-workflows
- Repository: https://github.com/jekoch4274/agentic-workflows

## Overview

agentic-workflows is a Markdown-based GitHub Copilot planning toolkit, not a runtime application. Its principal workflow turns an idea into a reviewed feature spec and stories, then GitHub Issues; agents and prompts guide each step, with human confirmation before writing. Separate review, operations, bug-reporting, and PR-description capabilities support the broader AI SDLC. The README documents these relationships, but no source excerpts were supplied, so the graph shows documented flows only.

Main entry points: [`.github/copilot-instructions.md`](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/copilot-instructions.md) (Project instructions), [`.github/agents/product-owner.md`](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/product-owner.md) (Product owner), [`.github/agents/designer.md`](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/designer.md) (Designer), [`.github/agents/platform-engineer.md`](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/platform-engineer.md) (Platform template)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Copilot agents"]
  node_product_owner["Product owner<br/>[product-owner.md]"]
  node_architect["Architect<br/>[architect.md]"]
  node_designer["Designer<br/>[designer.md]"]
  node_quality["Quality engineer"]
  node_security["Security engineer"]
  node_developer["Developer template<br/>[developer.md]"]
  node_platform["Platform template"]
  node_context["Project instructions"]
end

subgraph group_prompts["Prompt workflows"]
  node_create_feature["Feature prompt<br/>[create-feature.md]"]
  node_create_stories["Stories prompt<br/>[create-stories.md]"]
  node_create_issues["Issues prompt<br/>[create-issues.md]"]
  node_design_prompt["Design review"]
  node_bug_prompt["Bug report<br/>[create-bug.md]"]
  node_sync_prompt["Issue sync<br/>[issue-sync.md]"]
  node_ops_prompt["Operations<br/>[operations.md]"]
  node_pr_prompt["PR description"]
end

subgraph group_artifacts["Planning artifacts"]
  node_feature_doc["Feature spec"]
  node_story_doc["User stories<br/>[STORY_TEMPLATE.md]"]
  node_bug_doc["Bug report<br/>[BUG_TEMPLATE.md]"]
end

subgraph group_reviews["SDLC reviews"]
  node_reviewed_plan["Approved plan"]
end

node_user(("Project user"))
node_copilot["Copilot Chat"]
node_github_issues[("GitHub Issues")]

node_user -->|"describes idea"| node_copilot
node_copilot -->|"invokes"| node_product_owner
node_product_owner -->|"guides drafting"| node_create_feature
node_create_feature -->|"writes"| node_feature_doc
node_feature_doc -->|"provides feature"| node_create_stories
node_create_stories -->|"writes stories"| node_story_doc
node_story_doc -->|"provides stories"| node_create_issues
node_create_issues -->|"creates issues"| node_github_issues
node_user -->|"requests review"| node_design_prompt
node_design_prompt -->|"guides review"| node_designer
node_designer -->|"reviews design"| node_reviewed_plan
node_architect -->|"reviews feasibility"| node_reviewed_plan
node_platform -->|"reviews platform"| node_reviewed_plan
node_quality -->|"reviews testability"| node_reviewed_plan
node_security -->|"reviews risks"| node_reviewed_plan
node_reviewed_plan -->|"guides implementation"| node_developer
node_reviewed_plan -->|"guides implementation"| node_platform
node_bug_prompt -->|"creates report"| node_bug_doc
node_sync_prompt -->|"syncs numbers"| node_github_issues
node_ops_prompt -->|"supports runbooks"| node_user
node_pr_prompt -->|"generates PR body"| node_user
node_context -->|"provides context"| node_product_owner
node_context -->|"provides context"| node_architect
node_context -->|"provides context"| node_designer
node_context -->|"provides context"| node_quality
node_context -->|"provides context"| node_security
node_context -->|"provides context"| node_developer
node_context -->|"provides context"| node_platform

click node_product_owner "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/product-owner.md"
click node_architect "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/architect.md"
click node_designer "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/designer.md"
click node_quality "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/quality-engineer.md"
click node_security "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/security-engineer.md"
click node_developer "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/developer.md"
click node_platform "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/platform-engineer.md"
click node_context "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/copilot-instructions.md"
click node_create_feature "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-feature.md"
click node_create_stories "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-stories.md"
click node_create_issues "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-issues.md"
click node_design_prompt "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/design-considerations.md"
click node_bug_prompt "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-bug.md"
click node_sync_prompt "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/issue-sync.md"
click node_ops_prompt "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/operations.md"
click node_pr_prompt "https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/pr-description-generator.md"
click node_feature_doc "https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/FEATURE_TEMPLATE.md"
click node_story_doc "https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/STORY_TEMPLATE.md"
click node_bug_doc "https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/BUG_TEMPLATE.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_product_owner,node_architect,node_designer,node_quality,node_security,node_developer,node_platform,node_context,node_user toneBlue
class node_create_feature,node_create_stories,node_create_issues,node_design_prompt,node_bug_prompt,node_sync_prompt,node_ops_prompt,node_pr_prompt,node_github_issues toneAmber
class node_feature_doc,node_story_doc,node_bug_doc toneMint
class node_reviewed_plan toneRose
class node_copilot toneIndigo
```

## Components

### Copilot agents

- [Product owner](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/product-owner.md): `.github/agents/product-owner.md`
- [Architect](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/architect.md): `.github/agents/architect.md`
- [Designer](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/designer.md): `.github/agents/designer.md`
- [Quality engineer](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/quality-engineer.md): `.github/agents/quality-engineer.md`
- [Security engineer](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/security-engineer.md): `.github/agents/security-engineer.md`
- [Developer template](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/developer.md): `.github/agents/developer.md`
- [Platform template](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/agents/platform-engineer.md): `.github/agents/platform-engineer.md`
- [Project instructions](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/copilot-instructions.md): `.github/copilot-instructions.md`

### Prompt workflows

- [Feature prompt](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-feature.md): `.github/prompts/create-feature.md`
- [Stories prompt](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-stories.md): `.github/prompts/create-stories.md`
- [Issues prompt](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-issues.md): `.github/prompts/create-issues.md`
- [Design review](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/design-considerations.md): `.github/prompts/design-considerations.md`
- [Bug report](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/create-bug.md): `.github/prompts/create-bug.md`
- [Issue sync](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/issue-sync.md): `.github/prompts/issue-sync.md`
- [Operations](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/operations.md): `.github/prompts/operations.md`
- [PR description](https://github.com/jekoch4274/agentic-workflows/blob/main/.github/prompts/pr-description-generator.md): `.github/prompts/pr-description-generator.md`

### Planning artifacts

- [Feature spec](https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/FEATURE_TEMPLATE.md): `docs/templates/FEATURE_TEMPLATE.md`
- [User stories](https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/STORY_TEMPLATE.md): `docs/templates/STORY_TEMPLATE.md`
- [Bug report](https://github.com/jekoch4274/agentic-workflows/blob/main/docs/templates/BUG_TEMPLATE.md): `docs/templates/BUG_TEMPLATE.md`

### SDLC reviews

- **Approved plan**

### Other components

- **Project user**
- **Copilot Chat**
- **GitHub Issues**

## Connections

- Project user → Copilot Chat: describes idea (evidence: `README.md`)
- Copilot Chat → Product owner: invokes (evidence: `README.md`)
- Product owner → Feature prompt: guides drafting (evidence: `README.md`)
- Feature prompt → Feature spec: writes (evidence: `README.md`)
- Feature spec → Stories prompt: provides feature (evidence: `README.md`)
- Stories prompt → User stories: writes stories (evidence: `README.md`)
- User stories → Issues prompt: provides stories (evidence: `README.md`)
- Issues prompt → GitHub Issues: creates issues (evidence: `README.md`)
- Project user → Design review: requests review (evidence: `README.md`)
- Design review → Designer: guides review (evidence: `README.md`)
- Designer → Approved plan: reviews design (evidence: `README.md`)
- Architect → Approved plan: reviews feasibility (evidence: `README.md`)
- Platform template → Approved plan: reviews platform (evidence: `README.md`)
- Quality engineer → Approved plan: reviews testability (evidence: `README.md`)
- Security engineer → Approved plan: reviews risks (evidence: `README.md`)
- Approved plan → Developer template: guides implementation (evidence: `README.md`)
- Approved plan → Platform template: guides implementation (evidence: `README.md`)
- Bug report → Bug report: creates report (evidence: `README.md`)
- Issue sync → GitHub Issues: syncs numbers (evidence: `README.md`)
- Operations → Project user: supports runbooks (evidence: `README.md`)
- PR description → Project user: generates PR body (evidence: `README.md`)
- Project instructions → Product owner: provides context (evidence: `README.md`)
- Project instructions → Architect: provides context (evidence: `README.md`)
- Project instructions → Designer: provides context (evidence: `README.md`)
- Project instructions → Quality engineer: provides context (evidence: `README.md`)
- Project instructions → Security engineer: provides context (evidence: `README.md`)
- Project instructions → Developer template: provides context (evidence: `README.md`)
- Project instructions → Platform template: provides context (evidence: `README.md`)