# caon1ma/project_flow architecture

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

- Interactive diagram: https://gitdiagram.com/caon1ma/project_flow
- Repository: https://github.com/caon1ma/project_flow

## Overview

ProjectFlow is a single-file agent skill, not a standalone runtime. A user prompts an agent to use the skill; the agent examines a target codebase and produces a Mermaid execution-flow document with annotated methods, explained edges, and accompanying notes. The README documents this workflow and the skill’s intended contents, but no skill source excerpt was provided, so internal analysis steps are not expanded.

Main entry points: [`skills/project-flow/SKILL.md`](https://github.com/caon1ma/project_flow/blob/main/skills/project-flow/SKILL.md) (ProjectFlow skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_agent["Agent harness"]
node_skill["ProjectFlow skill<br/>[SKILL.md]"]
node_target["Target codebase"]
node_flow["Flow document"]

node_user -->|"prompts flow mapping"| node_agent
node_agent -->|"uses skill"| node_skill
node_agent -->|"reads code"| node_target
node_agent -->|"writes diagram and notes"| node_flow

click node_skill "https://github.com/caon1ma/project_flow/blob/main/skills/project-flow/SKILL.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_user toneBlue
class node_agent,node_target,node_flow toneIndigo
class node_skill toneTeal
```

## Components

### Other components

- **User**
- **Agent harness**
- [ProjectFlow skill](https://github.com/caon1ma/project_flow/blob/main/skills/project-flow/SKILL.md): `skills/project-flow/SKILL.md`
- **Target codebase**
- **Flow document**

## Connections

- User → Agent harness: prompts flow mapping (evidence: `README.md`)
- Agent harness → ProjectFlow skill: uses skill (evidence: `README.md`)
- Agent harness → Target codebase: reads code (evidence: `README.md`)
- Agent harness → Flow document: writes diagram and notes (evidence: `README.md`)
