# phuryn/pm-brain architecture

> Architecture diagram of the GitHub repository phuryn/pm-brain, 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/phuryn/pm-brain
- Repository: https://github.com/phuryn/pm-brain
- Video tour (about a minute): https://gitdiagram.com/phuryn/pm-brain/video

## Overview

PM Brain is a Claude Code skill that bootstraps and maintains a local, Markdown-based product-management knowledge base. The main loop captures an artifact, preserves its original, synthesizes it, propagates evidence into durable product context, and periodically reviews that context. The graph follows documented capabilities and relationships in the README; source excerpts were unavailable, so command-level implementation details and undocumented calls are not inferred.

Main entry points: [`.claude/skills/pm-brain/scaffold/.claude/commands/ingest.md`](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/ingest.md) (Ingest), [`.claude/skills/pm-brain/scaffold/.claude/commands/review.md`](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/review.md) (Weekly review), [`.claude/skills/pm-brain/scaffold/knowledge`](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/knowledge) (Product knowledge), [`.claude/skills/pm-brain/scaffold/hypotheses`](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/hypotheses) (Hypotheses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skill["Skill lifecycle"]
  node_skill["PM Brain skill<br/>[SKILL.md]"]
  node_scaffold["Brain scaffold<br/>[scaffold]"]
end

subgraph group_commands["PM workflows"]
  node_ingest["Ingest<br/>[ingest.md]"]
  node_prep["Prep brief<br/>[prep.md]"]
  node_review["Weekly review<br/>[review.md]"]
  node_ideate["Ideation<br/>[ideate.md]"]
  node_risk["Risk scan<br/>[risk.md]"]
  node_plan["Plan draft<br/>[plan.md]"]
  node_decide["Decision<br/>[decide.md]"]
  node_hypothesize["Hypothesize<br/>[hypothesize.md]"]
  node_strategy["Strategy check<br/>[strategy-check.md]"]
end

subgraph group_state["Brain data"]
  node_source[("Original sources<br/>[source]")]
  node_ingestion[("Syntheses<br/>[ingestion]")]
  node_knowledge[("Product knowledge<br/>[knowledge]")]
  node_hypotheses[("Hypotheses<br/>[hypotheses]")]
  node_decisions[("Decision records<br/>[decisions]")]
  node_stakeholders[("Stakeholders<br/>[stakeholders]")]
end

node_pm(("Product manager"))
node_claude(("Claude Code"))

node_pm -->|"invokes skill"| node_claude
node_claude -->|"loads"| node_skill
node_skill -->|"bootstraps"| node_scaffold
node_pm -->|"submits artifact"| node_ingest
node_ingest -->|"preserves original"| node_source
node_ingest -->|"writes synthesis"| node_ingestion
node_ingest -->|"propagates signal"| node_knowledge
node_ingest -->|"propagates signal"| node_hypotheses
node_ingest -->|"propagates signal"| node_decisions
node_ingest -->|"propagates signal"| node_stakeholders
node_pm -->|"requests brief"| node_prep
node_prep -->|"reads context"| node_stakeholders
node_pm -->|"requests sweep"| node_review
node_review -->|"reviews brain"| node_knowledge
node_review -->|"reviews brain"| node_hypotheses
node_review -->|"reviews brain"| node_decisions
node_review -->|"reviews brain"| node_stakeholders
node_pm -->|"requests directions"| node_ideate
node_ideate -->|"loads context"| node_knowledge
node_ideate -->|"loads context"| node_hypotheses
node_pm -->|"requests scan"| node_risk
node_risk -->|"drafts stubs"| node_hypotheses
node_pm -->|"requests plan"| node_plan
node_plan -->|"uses context"| node_knowledge
node_pm -->|"invokes command"| node_decide
node_pm -->|"invokes command"| node_hypothesize
node_pm -->|"invokes command"| node_strategy

click node_skill "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/SKILL.md"
click node_scaffold "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold"
click node_ingest "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/ingest.md"
click node_prep "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/prep.md"
click node_review "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/review.md"
click node_ideate "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/ideate.md"
click node_risk "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/risk.md"
click node_plan "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/plan.md"
click node_decide "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/decide.md"
click node_hypothesize "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/hypothesize.md"
click node_strategy "https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/strategy-check.md"
click node_source "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/source"
click node_ingestion "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/ingestion"
click node_knowledge "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/knowledge"
click node_hypotheses "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/hypotheses"
click node_decisions "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/decisions"
click node_stakeholders "https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/stakeholders"

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_skill,node_scaffold toneBlue
class node_ingest,node_prep,node_review,node_ideate,node_risk,node_plan,node_decide,node_hypothesize,node_strategy toneAmber
class node_source,node_ingestion,node_knowledge,node_hypotheses,node_decisions,node_stakeholders toneMint
class node_pm,node_claude toneIndigo
```

## Components

### Skill lifecycle

- [PM Brain skill](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/SKILL.md): `.claude/skills/pm-brain/SKILL.md`
- [Brain scaffold](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold): `.claude/skills/pm-brain/scaffold`

### PM workflows

- [Ingest](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/ingest.md): `.claude/skills/pm-brain/scaffold/.claude/commands/ingest.md`
- [Prep brief](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/prep.md): `.claude/skills/pm-brain/scaffold/.claude/commands/prep.md`
- [Weekly review](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/review.md): `.claude/skills/pm-brain/scaffold/.claude/commands/review.md`
- [Ideation](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/ideate.md): `.claude/skills/pm-brain/scaffold/.claude/commands/ideate.md`
- [Risk scan](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/risk.md): `.claude/skills/pm-brain/scaffold/.claude/commands/risk.md`
- [Plan draft](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/plan.md): `.claude/skills/pm-brain/scaffold/.claude/commands/plan.md`
- [Decision](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/decide.md): `.claude/skills/pm-brain/scaffold/.claude/commands/decide.md`
- [Hypothesize](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/hypothesize.md): `.claude/skills/pm-brain/scaffold/.claude/commands/hypothesize.md`
- [Strategy check](https://github.com/phuryn/pm-brain/blob/main/.claude/skills/pm-brain/scaffold/.claude/commands/strategy-check.md): `.claude/skills/pm-brain/scaffold/.claude/commands/strategy-check.md`

### Brain data

- [Original sources](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/source): `.claude/skills/pm-brain/scaffold/source`
- [Syntheses](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/ingestion): `.claude/skills/pm-brain/scaffold/ingestion`
- [Product knowledge](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/knowledge): `.claude/skills/pm-brain/scaffold/knowledge`
- [Hypotheses](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/hypotheses): `.claude/skills/pm-brain/scaffold/hypotheses`
- [Decision records](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/decisions): `.claude/skills/pm-brain/scaffold/decisions`
- [Stakeholders](https://github.com/phuryn/pm-brain/tree/main/.claude/skills/pm-brain/scaffold/stakeholders): `.claude/skills/pm-brain/scaffold/stakeholders`

### Other components

- **Product manager**
- **Claude Code**

## Connections

- Product manager → Claude Code: invokes skill (evidence: `README.md`)
- Claude Code → PM Brain skill: loads (evidence: `README.md`)
- PM Brain skill → Brain scaffold: bootstraps (evidence: `README.md`)
- Product manager → Ingest: submits artifact (evidence: `README.md`)
- Ingest → Original sources: preserves original (evidence: `README.md`)
- Ingest → Syntheses: writes synthesis (evidence: `README.md`)
- Ingest → Product knowledge: propagates signal (evidence: `README.md`)
- Ingest → Hypotheses: propagates signal (evidence: `README.md`)
- Ingest → Decision records: propagates signal (evidence: `README.md`)
- Ingest → Stakeholders: propagates signal (evidence: `README.md`)
- Product manager → Prep brief: requests brief (evidence: `README.md`)
- Prep brief → Stakeholders: reads context (evidence: `README.md`)
- Product manager → Weekly review: requests sweep (evidence: `README.md`)
- Weekly review → Product knowledge: reviews brain (evidence: `README.md`)
- Weekly review → Hypotheses: reviews brain (evidence: `README.md`)
- Weekly review → Decision records: reviews brain (evidence: `README.md`)
- Weekly review → Stakeholders: reviews brain (evidence: `README.md`)
- Product manager → Ideation: requests directions (evidence: `README.md`)
- Ideation → Product knowledge: loads context (evidence: `README.md`)
- Ideation → Hypotheses: loads context (evidence: `README.md`)
- Product manager → Risk scan: requests scan (evidence: `README.md`)
- Risk scan → Hypotheses: drafts stubs (evidence: `README.md`)
- Product manager → Plan draft: requests plan (evidence: `README.md`)
- Plan draft → Product knowledge: uses context (evidence: `README.md`)
- Product manager → Decision: invokes command (evidence: `README.md`)
- Product manager → Hypothesize: invokes command (evidence: `README.md`)
- Product manager → Strategy check: invokes command (evidence: `README.md`)
