# ramani-viswanathan/iem-pm architecture

> Architecture diagram of the GitHub repository ramani-viswanathan/iem-pm, 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/ramani-viswanathan/iem-pm
- Repository: https://github.com/ramani-viswanathan/iem-pm

## Overview

IEM-PM is a Claude Code skill for evidence-based audits of project and PMO artifacts against standards supplied by the organization. Its principal workflow runs from baseline and charter preparation through evidence analysis, gap classification and root-origin tracing, scoring and synthesis, then deterministic validation and report generation. Python handles baseline inventory and the structured-output pipeline; Claude performs the audit judgment. README statements establish the broader workflow and capabilities; sampled source confirms selected script responsibilities and imports, but not every skill-stage transition.

Main entry points: [`skills/intelligence-engine/SKILL.md`](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md) (Audit state machine), [`skills/intelligence-engine/scripts/manifest_to_findings.py`](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/manifest_to_findings.py) (Findings canonicalizer), [`skills/intelligence-engine/scripts/baseline.py`](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/baseline.py) (Baseline inventory), [`skills/intelligence-engine/scripts/render.py`](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/render.py) (HTML and TXT reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Audit inputs"]
  node_standards[("Declared standards")]
  node_evidence[("Delivery artifacts")]
  node_baseline["Baseline inventory<br/>[baseline.py]"]
  node_knowledge_index["Knowledge index"]
end

subgraph group_reasoning["Audit reasoning"]
  node_charter["PMO data charter<br/>[charter-spec.md]"]
  node_skill["Audit state machine<br/>[SKILL.md]"]
  node_define_measure["Define and measure<br/>[SKILL.md]"]
  node_classify_trace["Classify and trace<br/>[SKILL.md]"]
  node_score_synthesize["Score and synthesize<br/>[SKILL.md]"]
  node_manifest["Audit manifest"]
end

subgraph group_pipeline["Deterministic pipeline"]
  node_canonicalize["Findings canonicalizer"]
  node_schema["Schema validator<br/>[schema.py]"]
  node_timing["Stage timing log<br/>[timing_log.py]"]
end

subgraph group_outputs["Audit outputs"]
  node_findings["Canonical findings"]
  node_report["HTML and TXT reports<br/>[render.py]"]
  node_limitation["Scope limitation notice"]
  node_report_assets["Report templates"]
end

node_operator(("Audit operator"))

node_operator -->|"provides baseline"| node_standards
node_operator -->|"provides artifacts"| node_evidence
node_operator -->|"runs skill"| node_skill
node_standards -->|"inventoried by"| node_baseline
node_baseline -->|"derives index"| node_knowledge_index
node_baseline -->|"scans directories"| node_knowledge_index
node_skill -->|"establishes charter"| node_charter
node_skill -->|"runs stages"| node_define_measure
node_skill -->|"runs stages"| node_classify_trace
node_skill -->|"runs stages"| node_score_synthesize
node_evidence -->|"examined against baseline"| node_define_measure
node_charter -->|"defines data meaning"| node_define_measure
node_score_synthesize -->|"writes manifest"| node_manifest
node_manifest -->|"parsed into findings"| node_canonicalize
node_canonicalize -->|"validates findings"| node_schema
node_canonicalize -->|"logs stage"| node_timing
node_canonicalize -->|"produces JSON"| node_findings
node_findings -->|"rendered as reports"| node_report
node_report -->|"logs stage"| node_timing
node_report -->|"uses template"| node_report_assets
node_skill -->|"may halt to notice"| node_limitation
node_limitation -->|"renders template"| node_report_assets

click node_standards "https://github.com/ramani-viswanathan/iem-pm/tree/master/skills/intelligence-engine/knowledge"
click node_evidence "https://github.com/ramani-viswanathan/iem-pm/tree/master/Audit"
click node_baseline "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/baseline.py"
click node_knowledge_index "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/derive_knowledge_index.py"
click node_charter "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/references/charter-spec.md"
click node_skill "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md"
click node_define_measure "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md"
click node_classify_trace "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md"
click node_score_synthesize "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md"
click node_manifest "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/assets/AUDIT_MANIFEST_template.md"
click node_canonicalize "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/manifest_to_findings.py"
click node_schema "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/schema.py"
click node_timing "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/timing_log.py"
click node_findings "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/findings.schema.json"
click node_report "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/render.py"
click node_limitation "https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/render_scope_limitation.py"
click node_report_assets "https://github.com/ramani-viswanathan/iem-pm/tree/master/skills/intelligence-engine/assets"

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_standards,node_evidence,node_baseline,node_knowledge_index toneBlue
class node_charter,node_skill,node_define_measure,node_classify_trace,node_score_synthesize,node_manifest toneAmber
class node_canonicalize,node_schema,node_timing toneMint
class node_findings,node_report,node_limitation,node_report_assets toneRose
class node_operator toneIndigo
```

## Components

### Audit inputs

- [Declared standards](https://github.com/ramani-viswanathan/iem-pm/tree/master/skills/intelligence-engine/knowledge): `skills/intelligence-engine/knowledge`
- [Delivery artifacts](https://github.com/ramani-viswanathan/iem-pm/tree/master/Audit): `Audit`
- [Baseline inventory](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/baseline.py): `skills/intelligence-engine/scripts/baseline.py`
- [Knowledge index](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/derive_knowledge_index.py): `skills/intelligence-engine/scripts/derive_knowledge_index.py`

### Audit reasoning

- [PMO data charter](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/references/charter-spec.md): `skills/intelligence-engine/references/charter-spec.md`
- [Audit state machine](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md): `skills/intelligence-engine/SKILL.md`
- [Define and measure](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md): `skills/intelligence-engine/SKILL.md`
- [Classify and trace](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md): `skills/intelligence-engine/SKILL.md`
- [Score and synthesize](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/SKILL.md): `skills/intelligence-engine/SKILL.md`
- [Audit manifest](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/assets/AUDIT_MANIFEST_template.md): `skills/intelligence-engine/assets/AUDIT_MANIFEST_template.md`

### Deterministic pipeline

- [Findings canonicalizer](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/manifest_to_findings.py): `skills/intelligence-engine/scripts/manifest_to_findings.py`
- [Schema validator](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/schema.py): `skills/intelligence-engine/scripts/schema.py`
- [Stage timing log](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/timing_log.py): `skills/intelligence-engine/scripts/timing_log.py`

### Audit outputs

- [Canonical findings](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/findings.schema.json): `skills/intelligence-engine/scripts/findings.schema.json`
- [HTML and TXT reports](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/render.py): `skills/intelligence-engine/scripts/render.py`
- [Scope limitation notice](https://github.com/ramani-viswanathan/iem-pm/blob/master/skills/intelligence-engine/scripts/render_scope_limitation.py): `skills/intelligence-engine/scripts/render_scope_limitation.py`
- [Report templates](https://github.com/ramani-viswanathan/iem-pm/tree/master/skills/intelligence-engine/assets): `skills/intelligence-engine/assets`

### Other components

- **Audit operator**

## Connections

- Audit operator → Declared standards: provides baseline (evidence: `README.md`)
- Audit operator → Delivery artifacts: provides artifacts (evidence: `README.md`)
- Audit operator → Audit state machine: runs skill (evidence: `README.md`)
- Declared standards → Baseline inventory: inventoried by (evidence: `skills/intelligence-engine/scripts/baseline.py`)
- Baseline inventory → Knowledge index: derives index (evidence: `skills/intelligence-engine/scripts/baseline.py`)
- Baseline inventory → Knowledge index: scans directories (evidence: `skills/intelligence-engine/scripts/derive_knowledge_index.py`)
- Audit state machine → PMO data charter: establishes charter (evidence: `README.md`)
- Audit state machine → Define and measure: runs stages (evidence: `README.md`)
- Audit state machine → Classify and trace: runs stages (evidence: `README.md`)
- Audit state machine → Score and synthesize: runs stages (evidence: `README.md`)
- Delivery artifacts → Define and measure: examined against baseline (evidence: `README.md`)
- PMO data charter → Define and measure: defines data meaning (evidence: `README.md`)
- Score and synthesize → Audit manifest: writes manifest (evidence: `README.md`)
- Audit manifest → Findings canonicalizer: parsed into findings (evidence: `skills/intelligence-engine/scripts/manifest_to_findings.py`)
- Findings canonicalizer → Schema validator: validates findings (evidence: `skills/intelligence-engine/scripts/manifest_to_findings.py`)
- Findings canonicalizer → Stage timing log: logs stage (evidence: `skills/intelligence-engine/scripts/manifest_to_findings.py`)
- Findings canonicalizer → Canonical findings: produces JSON (evidence: `README.md`)
- Canonical findings → HTML and TXT reports: rendered as reports (evidence: `README.md`)
- HTML and TXT reports → Stage timing log: logs stage (evidence: `skills/intelligence-engine/scripts/render.py`)
- HTML and TXT reports → Report templates: uses template (evidence: `README.md`)
- Audit state machine → Scope limitation notice: may halt to notice (evidence: `skills/intelligence-engine/scripts/render_scope_limitation.py`)
- Scope limitation notice → Report templates: renders template (evidence: `skills/intelligence-engine/scripts/render_scope_limitation.py`)
