# rohitg00/pro-workflow architecture

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

- Interactive diagram: https://gitdiagram.com/rohitg00/pro-workflow
- Repository: https://github.com/rohitg00/pro-workflow

## Overview

Pro Workflow is an AI-coding workflow system built around persistent correction memory and research wikis. Its main user-to-result loop captures a correction as a learning, stores it in SQLite, then surfaces relevant learnings and wiki material in later sessions. Separate capabilities include wiki authoring and research, hybrid retrieval, multi-LLM deliberation, and skill optimization. The graph combines sampled implementation relationships with README-documented product flows; links for unsampled hooks and wiki internals are limited to those documented flows.

Main entry points: [`src/optimizer/trainer.ts`](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/trainer.ts) (Optimizer trainer), [`src/db/store.ts`](https://github.com/rohitg00/pro-workflow/blob/main/src/db/store.ts) (Learning store), [`scripts/prompt-submit.js`](https://github.com/rohitg00/pro-workflow/blob/main/scripts/prompt-submit.js) (Prompt injection), [`src/optimizer/reflect.ts`](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/reflect.ts) (Patch proposal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_memory["Session memory"]
  node_learn_capture["Capture correction<br/>[learn-capture.js]"]
  node_session_start["Session startup<br/>[session-start.js]"]
  node_prompt_submit["Prompt injection<br/>[prompt-submit.js]"]
  node_learning_store["Learning store<br/>[store.ts]"]
  node_sqlite[("SQLite store<br/>[index.ts]")]
  node_fts["Learning search<br/>[fts.ts]"]
end

subgraph group_wiki["Knowledge plane"]
  node_wiki_builder["Wiki authoring<br/>[wiki-cli.js]"]
  node_wiki_query["Wiki retrieval<br/>[query.js]"]
  node_research_loop["Auto research<br/>[research-loop.js]"]
  node_source_fetchers["Research sources"]
  node_embeddings["Vector retrieval<br/>[embeddings.ts]"]
  node_council["LLM council<br/>[council.js]"]
  node_wiki_viewer["Wiki viewer<br/>[render.js]"]
end

subgraph group_optimizer["Skill optimization"]
  node_optimizer_trainer["Optimizer trainer<br/>[trainer.ts]"]
  node_patch_aggregate["Patch aggregation<br/>[aggregate.ts]"]
  node_patch_apply["Patch application<br/>[apply.ts]"]
  node_patch_clip["Patch limits<br/>[clip.ts]"]
  node_optimizer_store["Run persistence<br/>[store.ts]"]
  node_reflect["Patch proposal<br/>[reflect.ts]"]
  node_slow_update["Slow update<br/>[slow.ts]"]
  node_validate["Skill evaluation<br/>[validate.ts]"]
  node_llm_client["LLM client<br/>[llm.ts]"]
  node_parse["Response parsing<br/>[parse.ts]"]
end

subgraph group_workflow["Workflow controls"]
  node_quality_hooks["Quality hooks"]
end

node_agent(("Coding agent"))
node_external_llm(("LLM providers"))
node_research_web(("Web and research APIs"))

node_agent -->|"submits correction"| node_learn_capture
node_learn_capture -.->|"saves learning"| node_learning_store
node_session_start -.->|"loads learnings"| node_learning_store
node_session_start -.->|"surfaces learnings"| node_agent
node_agent -.->|"submits prompt"| node_prompt_submit
node_prompt_submit -.->|"searches learnings"| node_fts
node_prompt_submit -.->|"injects wiki hits"| node_wiki_query
node_learning_store -->|"initializes database"| node_sqlite
node_fts -->|"searches records"| node_learning_store
node_agent -->|"authors wiki"| node_wiki_builder
node_agent -->|"queries wiki"| node_wiki_query
node_agent -->|"starts research"| node_research_loop
node_research_loop -->|"fetches sources"| node_source_fetchers
node_agent -.->|"requests hybrid search"| node_embeddings
node_embeddings -->|"requests embeddings"| node_external_llm
node_agent -->|"requests deliberation"| node_council
node_agent -->|"browses wiki"| node_wiki_viewer
node_optimizer_trainer -->|"persists run"| node_optimizer_store
node_optimizer_trainer -->|"aggregates patches"| node_patch_aggregate
node_optimizer_trainer -->|"applies patches"| node_patch_apply
node_optimizer_trainer -->|"limits patches"| node_patch_clip
node_optimizer_trainer -->|"proposes edits"| node_reflect
node_optimizer_trainer -->|"runs update"| node_slow_update
node_optimizer_trainer -->|"evaluates skill"| node_validate
node_reflect -->|"requests completion"| node_llm_client
node_reflect -->|"parses response"| node_parse
node_validate -->|"requests evaluation"| node_llm_client
node_validate -->|"parses outcomes"| node_parse
node_llm_client -->|"calls provider"| node_external_llm
node_agent -.->|"triggers safeguards"| node_quality_hooks

click node_learn_capture "https://github.com/rohitg00/pro-workflow/blob/main/scripts/learn-capture.js"
click node_session_start "https://github.com/rohitg00/pro-workflow/blob/main/scripts/session-start.js"
click node_prompt_submit "https://github.com/rohitg00/pro-workflow/blob/main/scripts/prompt-submit.js"
click node_learning_store "https://github.com/rohitg00/pro-workflow/blob/main/src/db/store.ts"
click node_sqlite "https://github.com/rohitg00/pro-workflow/blob/main/src/db/index.ts"
click node_fts "https://github.com/rohitg00/pro-workflow/blob/main/src/search/fts.ts"
click node_wiki_builder "https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-builder/scripts/wiki-cli.js"
click node_wiki_query "https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-query/scripts/query.js"
click node_research_loop "https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-research-loop/scripts/research-loop.js"
click node_source_fetchers "https://github.com/rohitg00/pro-workflow/tree/main/skills/wiki-research-loop/scripts/source-fetchers"
click node_embeddings "https://github.com/rohitg00/pro-workflow/blob/main/src/search/embeddings.ts"
click node_council "https://github.com/rohitg00/pro-workflow/blob/main/skills/llm-council/scripts/council.js"
click node_wiki_viewer "https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-viewer/scripts/render.js"
click node_optimizer_trainer "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/trainer.ts"
click node_patch_aggregate "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/aggregate.ts"
click node_patch_apply "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/apply.ts"
click node_patch_clip "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/clip.ts"
click node_optimizer_store "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/store.ts"
click node_reflect "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/reflect.ts"
click node_slow_update "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/slow.ts"
click node_validate "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/validate.ts"
click node_llm_client "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/llm.ts"
click node_parse "https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/parse.ts"
click node_quality_hooks "https://github.com/rohitg00/pro-workflow/tree/main/scripts"

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_learn_capture,node_session_start,node_prompt_submit,node_learning_store,node_sqlite,node_fts toneBlue
class node_wiki_builder,node_wiki_query,node_research_loop,node_source_fetchers,node_embeddings,node_council,node_wiki_viewer toneAmber
class node_optimizer_trainer,node_patch_aggregate,node_patch_apply,node_patch_clip,node_optimizer_store,node_reflect,node_slow_update,node_validate,node_llm_client,node_parse,node_research_web toneMint
class node_quality_hooks toneRose
class node_agent,node_external_llm toneIndigo
```

## Components

### Session memory

- [Capture correction](https://github.com/rohitg00/pro-workflow/blob/main/scripts/learn-capture.js): `scripts/learn-capture.js`
- [Session startup](https://github.com/rohitg00/pro-workflow/blob/main/scripts/session-start.js): `scripts/session-start.js`
- [Prompt injection](https://github.com/rohitg00/pro-workflow/blob/main/scripts/prompt-submit.js): `scripts/prompt-submit.js`
- [Learning store](https://github.com/rohitg00/pro-workflow/blob/main/src/db/store.ts): `src/db/store.ts`
- [SQLite store](https://github.com/rohitg00/pro-workflow/blob/main/src/db/index.ts): `src/db/index.ts`
- [Learning search](https://github.com/rohitg00/pro-workflow/blob/main/src/search/fts.ts): `src/search/fts.ts`

### Knowledge plane

- [Wiki authoring](https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-builder/scripts/wiki-cli.js): `skills/wiki-builder/scripts/wiki-cli.js`
- [Wiki retrieval](https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-query/scripts/query.js): `skills/wiki-query/scripts/query.js`
- [Auto research](https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-research-loop/scripts/research-loop.js): `skills/wiki-research-loop/scripts/research-loop.js`
- [Research sources](https://github.com/rohitg00/pro-workflow/tree/main/skills/wiki-research-loop/scripts/source-fetchers): `skills/wiki-research-loop/scripts/source-fetchers`
- [Vector retrieval](https://github.com/rohitg00/pro-workflow/blob/main/src/search/embeddings.ts): `src/search/embeddings.ts`
- [LLM council](https://github.com/rohitg00/pro-workflow/blob/main/skills/llm-council/scripts/council.js): `skills/llm-council/scripts/council.js`
- [Wiki viewer](https://github.com/rohitg00/pro-workflow/blob/main/skills/wiki-viewer/scripts/render.js): `skills/wiki-viewer/scripts/render.js`

### Skill optimization

- [Optimizer trainer](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/trainer.ts): `src/optimizer/trainer.ts`
- [Patch aggregation](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/aggregate.ts): `src/optimizer/aggregate.ts`
- [Patch application](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/apply.ts): `src/optimizer/apply.ts`
- [Patch limits](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/clip.ts): `src/optimizer/clip.ts`
- [Run persistence](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/store.ts): `src/optimizer/store.ts`
- [Patch proposal](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/reflect.ts): `src/optimizer/reflect.ts`
- [Slow update](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/slow.ts): `src/optimizer/slow.ts`
- [Skill evaluation](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/validate.ts): `src/optimizer/validate.ts`
- [LLM client](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/llm.ts): `src/optimizer/llm.ts`
- [Response parsing](https://github.com/rohitg00/pro-workflow/blob/main/src/optimizer/parse.ts): `src/optimizer/parse.ts`

### Workflow controls

- [Quality hooks](https://github.com/rohitg00/pro-workflow/tree/main/scripts): `scripts`

### Other components

- **Coding agent**
- **LLM providers**
- **Web and research APIs**

## Connections

- Coding agent → Capture correction: submits correction (evidence: `README.md`)
- Capture correction → Learning store: saves learning (evidence: `README.md`)
- Session startup → Learning store: loads learnings (evidence: `README.md`)
- Session startup → Coding agent: surfaces learnings (evidence: `README.md`)
- Coding agent → Prompt injection: submits prompt (evidence: `README.md`)
- Prompt injection → Learning search: searches learnings (evidence: `README.md`)
- Prompt injection → Wiki retrieval: injects wiki hits (evidence: `README.md`)
- Learning store → SQLite store: initializes database (evidence: `src/db/store.ts`)
- Learning search → Learning store: searches records (evidence: `src/search/fts.ts`)
- Coding agent → Wiki authoring: authors wiki (evidence: `README.md`)
- Coding agent → Wiki retrieval: queries wiki (evidence: `README.md`)
- Coding agent → Auto research: starts research (evidence: `README.md`)
- Auto research → Research sources: fetches sources (evidence: `README.md`)
- Coding agent → Vector retrieval: requests hybrid search (evidence: `README.md`)
- Vector retrieval → LLM providers: requests embeddings (evidence: `src/search/embeddings.ts`)
- Coding agent → LLM council: requests deliberation (evidence: `README.md`)
- Coding agent → Wiki viewer: browses wiki (evidence: `README.md`)
- Optimizer trainer → Run persistence: persists run (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Patch aggregation: aggregates patches (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Patch application: applies patches (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Patch limits: limits patches (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Patch proposal: proposes edits (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Slow update: runs update (evidence: `src/optimizer/trainer.ts`)
- Optimizer trainer → Skill evaluation: evaluates skill (evidence: `src/optimizer/trainer.ts`)
- Patch proposal → LLM client: requests completion (evidence: `src/optimizer/reflect.ts`)
- Patch proposal → Response parsing: parses response (evidence: `src/optimizer/reflect.ts`)
- Skill evaluation → LLM client: requests evaluation (evidence: `src/optimizer/validate.ts`)
- Skill evaluation → Response parsing: parses outcomes (evidence: `src/optimizer/validate.ts`)
- LLM client → LLM providers: calls provider (evidence: `src/optimizer/llm.ts`)
- Coding agent → Quality hooks: triggers safeguards (evidence: `README.md`)
