# tpavanipradeep/everything-claude-code architecture

> Architecture diagram of the GitHub repository tpavanipradeep/everything-claude-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tpavanipradeep/everything-claude-code
- Repository: https://github.com/tpavanipradeep/everything-claude-code

## Overview

ECC is an AI-agent harness performance system: it installs cross-harness configuration and provides runtime hooks, session continuity, learning, security, and orchestration tools. A principal workflow is a harness session starting with prior context and project information, then persisting session learnings at session end for later reuse. The graph also shows session inspection, skill improvement/evolution, installation, and worktree orchestration. Relationships among sampled files follow their imports or calls; README-supported capabilities with unsampled implementations are shown with documented or unverified links.

Main entry points: [`scripts/lib/skill-evolution`](https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/lib/skill-evolution) (Skill Evolution), [`scripts/lib/state-store/index.js`](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/index.js) (State Store), [`scripts/session-inspect.js`](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/session-inspect.js) (Session Inspector), [`scripts/install-plan.js`](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/install-plan.js) (Install Planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation & Setup"]
  node_installer["Install CLI<br/>[install-apply.js]"]
  node_installplan["Install Planning<br/>[install-plan.js]"]
  node_manifests["Install Manifests"]
  node_targetregistry["Harness Targets<br/>[registry.js]"]
end

subgraph group_runtime["Harness Runtime"]
  node_hooks["Runtime Hooks"]
  node_sessionstart["Session Start<br/>[session-start.js]"]
  node_sessionend["Session End<br/>[session-end.js]"]
  node_projectdetect["Project Detection<br/>[project-detect.js]"]
  node_packagemanager["Package Manager<br/>[package-manager.js]"]
  node_skillscontent["Agent Skills"]
end

subgraph group_sessions["Sessions &amp; Learning"]
  node_sessioncli["Session Commands<br/>[sessions-cli.js]"]
  node_sessionmanager["Session Files<br/>[session-manager.js]"]
  node_adapterregistry["Session Adapters<br/>[registry.js]"]
  node_canonical["Canonical Sessions"]
  node_statestore[("State Store<br/>[index.js]")]
  node_skillimprove["Skill Improvement"]
  node_skillevolution["Skill Evolution"]
  node_scripts_lib_state_migrations["State Migrations<br/>[migrations.js]"]
  node_scripts_lib_state_queries["State Queries<br/>[queries.js]"]
  node_scripts_lib_state_schema["State Schema<br/>[schema.js]"]
  node_scripts_lib_skill_health["Skill Health<br/>[health.js]"]
  node_scripts_lib_skill_provenance["Skill Provenance<br/>[provenance.js]"]
  node_scripts_lib_skill_tracker["Skill Tracker<br/>[tracker.js]"]
  node_scripts_lib_skill_versioning["Skill Versioning<br/>[versioning.js]"]
end

subgraph group_orchestration["Agent Orchestration"]
  node_worktreecli["Worktree CLI"]
  node_worktreeengine["Worktree Orchestrator"]
  node_statuscli["Orchestration Status"]
end

subgraph group_insights["Analysis &amp; Security"]
  node_inspector["Session Inspector<br/>[session-inspect.js]"]
  node_audit["Harness Audit<br/>[harness-audit.js]"]
  node_security["Security Monitoring"]
end

node_user(("Developer"))
node_harness(("Agent Harness"))

node_user -.->|"runs setup"| node_installer
node_installer -.->|"uses plan"| node_installplan
node_installplan -.->|"loads manifests"| node_manifests
node_installplan -.->|"selects targets"| node_targetregistry
node_harness -.->|"starts session"| node_sessionstart
node_sessionstart -->|"detects project"| node_projectdetect
node_sessionstart -->|"detects manager"| node_packagemanager
node_harness -.->|"ends response"| node_sessionend
node_sessionend -.->|"persists summary"| node_sessionmanager
node_sessioncli -->|"uses state store"| node_statestore
node_adapterregistry -->|"registers adapter"| node_canonical
node_canonical -->|"reads and writes"| node_statestore
node_statestore -->|"applies migrations"| node_scripts_lib_state_migrations
node_statestore -->|"creates query API"| node_scripts_lib_state_queries
node_statestore -->|"validates entities"| node_scripts_lib_state_schema
node_inspector -->|"inspects targets"| node_adapterregistry
node_inspector -->|"evaluates skills"| node_skillimprove
node_inspector -.->|"inspects health"| node_skillevolution
node_skillevolution -->|"tracks health"| node_scripts_lib_skill_health
node_skillevolution -->|"reads provenance"| node_scripts_lib_skill_provenance
node_skillevolution -->|"reads tracking"| node_scripts_lib_skill_tracker
node_skillevolution -->|"reads versions"| node_scripts_lib_skill_versioning
node_user -->|"plans workers"| node_worktreecli
node_worktreecli -->|"builds and executes"| node_worktreeengine
node_user -->|"checks progress"| node_statuscli
node_statuscli -->|"inspects session"| node_adapterregistry
node_user -.->|"audits harness"| node_audit
node_harness -.->|"dispatches events"| node_hooks
node_hooks -.->|"supports scanning"| node_security
node_harness -.->|"uses skills"| node_skillscontent

click node_installer "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/install-apply.js"
click node_installplan "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/install-plan.js"
click node_manifests "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/install-manifests.js"
click node_targetregistry "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/install-targets/registry.js"
click node_hooks "https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/hooks"
click node_sessionstart "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/session-start.js"
click node_sessionend "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/session-end.js"
click node_projectdetect "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/project-detect.js"
click node_packagemanager "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/package-manager.js"
click node_sessioncli "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/sessions-cli.js"
click node_sessionmanager "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-manager.js"
click node_adapterregistry "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-adapters/registry.js"
click node_canonical "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-adapters/canonical-session.js"
click node_statestore "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/index.js"
click node_skillimprove "https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/lib/skill-improvement"
click node_skillevolution "https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/lib/skill-evolution"
click node_worktreecli "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/orchestrate-worktrees.js"
click node_worktreeengine "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/tmux-worktree-orchestrator.js"
click node_statuscli "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/orchestration-status.js"
click node_inspector "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/session-inspect.js"
click node_audit "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/harness-audit.js"
click node_security "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/insaits-security-monitor.py"
click node_skillscontent "https://github.com/tpavanipradeep/everything-claude-code/tree/main/skills"
click node_scripts_lib_state_migrations "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/migrations.js"
click node_scripts_lib_state_queries "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/queries.js"
click node_scripts_lib_state_schema "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/schema.js"
click node_scripts_lib_skill_health "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/health.js"
click node_scripts_lib_skill_provenance "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/provenance.js"
click node_scripts_lib_skill_tracker "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/tracker.js"
click node_scripts_lib_skill_versioning "https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/versioning.js"

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_installer,node_installplan,node_manifests,node_targetregistry toneBlue
class node_hooks,node_sessionstart,node_sessionend,node_projectdetect,node_packagemanager,node_skillscontent toneAmber
class node_sessioncli,node_sessionmanager,node_adapterregistry,node_canonical,node_statestore,node_skillimprove,node_skillevolution,node_scripts_lib_state_migrations,node_scripts_lib_state_queries,node_scripts_lib_state_schema,node_scripts_lib_skill_health,node_scripts_lib_skill_provenance,node_scripts_lib_skill_tracker,node_scripts_lib_skill_versioning toneMint
class node_worktreecli,node_worktreeengine,node_statuscli toneRose
class node_inspector,node_audit,node_security,node_user,node_harness toneIndigo
```

## Components

### Installation & Setup

- [Install CLI](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/install-apply.js): `scripts/install-apply.js`
- [Install Planning](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/install-plan.js): `scripts/install-plan.js`
- [Install Manifests](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/install-manifests.js): `scripts/lib/install-manifests.js`
- [Harness Targets](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/install-targets/registry.js): `scripts/lib/install-targets/registry.js`

### Harness Runtime

- [Runtime Hooks](https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/hooks): `scripts/hooks`
- [Session Start](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/session-start.js): `scripts/hooks/session-start.js`
- [Session End](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/session-end.js): `scripts/hooks/session-end.js`
- [Project Detection](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/project-detect.js): `scripts/lib/project-detect.js`
- [Package Manager](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/package-manager.js): `scripts/lib/package-manager.js`
- [Agent Skills](https://github.com/tpavanipradeep/everything-claude-code/tree/main/skills): `skills`

### Sessions & Learning

- [Session Commands](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/sessions-cli.js): `scripts/sessions-cli.js`
- [Session Files](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-manager.js): `scripts/lib/session-manager.js`
- [Session Adapters](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-adapters/registry.js): `scripts/lib/session-adapters/registry.js`
- [Canonical Sessions](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/session-adapters/canonical-session.js): `scripts/lib/session-adapters/canonical-session.js`
- [State Store](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/index.js): `scripts/lib/state-store/index.js`
- [Skill Improvement](https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/lib/skill-improvement): `scripts/lib/skill-improvement`
- [Skill Evolution](https://github.com/tpavanipradeep/everything-claude-code/tree/main/scripts/lib/skill-evolution): `scripts/lib/skill-evolution`
- [State Migrations](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/migrations.js): `scripts/lib/state-store/migrations.js`
- [State Queries](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/queries.js): `scripts/lib/state-store/queries.js`
- [State Schema](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/state-store/schema.js): `scripts/lib/state-store/schema.js`
- [Skill Health](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/health.js): `scripts/lib/skill-evolution/health.js`
- [Skill Provenance](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/provenance.js): `scripts/lib/skill-evolution/provenance.js`
- [Skill Tracker](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/tracker.js): `scripts/lib/skill-evolution/tracker.js`
- [Skill Versioning](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/skill-evolution/versioning.js): `scripts/lib/skill-evolution/versioning.js`

### Agent Orchestration

- [Worktree CLI](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/orchestrate-worktrees.js): `scripts/orchestrate-worktrees.js`
- [Worktree Orchestrator](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/lib/tmux-worktree-orchestrator.js): `scripts/lib/tmux-worktree-orchestrator.js`
- [Orchestration Status](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/orchestration-status.js): `scripts/orchestration-status.js`

### Analysis & Security

- [Session Inspector](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/session-inspect.js): `scripts/session-inspect.js`
- [Harness Audit](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/harness-audit.js): `scripts/harness-audit.js`
- [Security Monitoring](https://github.com/tpavanipradeep/everything-claude-code/blob/main/scripts/hooks/insaits-security-monitor.py): `scripts/hooks/insaits-security-monitor.py`

### Other components

- **Developer**
- **Agent Harness**

## Connections

- Developer → Install CLI: runs setup (evidence: `README.md`)
- Install CLI → Install Planning: uses plan
- Install Planning → Install Manifests: loads manifests
- Install Planning → Harness Targets: selects targets
- Agent Harness → Session Start: starts session (evidence: `README.md`)
- Session Start → Project Detection: detects project (evidence: `scripts/hooks/session-start.js`)
- Session Start → Package Manager: detects manager (evidence: `scripts/hooks/session-start.js`)
- Agent Harness → Session End: ends response (evidence: `README.md`)
- Session End → Session Files: persists summary
- Session Commands → State Store: uses state store (evidence: `scripts/sessions-cli.js`)
- Session Adapters → Canonical Sessions: registers adapter (evidence: `scripts/lib/session-adapters/registry.js`)
- Canonical Sessions → State Store: reads and writes (evidence: `scripts/lib/session-adapters/canonical-session.js`)
- State Store → State Migrations: applies migrations (evidence: `scripts/lib/state-store/index.js`)
- State Store → State Queries: creates query API (evidence: `scripts/lib/state-store/index.js`)
- State Store → State Schema: validates entities (evidence: `scripts/lib/state-store/index.js`)
- Session Inspector → Session Adapters: inspects targets (evidence: `scripts/session-inspect.js`)
- Session Inspector → Skill Improvement: evaluates skills (evidence: `scripts/session-inspect.js`)
- Session Inspector → Skill Evolution: inspects health
- Skill Evolution → Skill Health: tracks health (evidence: `scripts/lib/skill-evolution/health.js`)
- Skill Evolution → Skill Provenance: reads provenance (evidence: `scripts/lib/skill-evolution/health.js`)
- Skill Evolution → Skill Tracker: reads tracking (evidence: `scripts/lib/skill-evolution/health.js`)
- Skill Evolution → Skill Versioning: reads versions (evidence: `scripts/lib/skill-evolution/health.js`)
- Developer → Worktree CLI: plans workers (evidence: `scripts/orchestrate-worktrees.js`)
- Worktree CLI → Worktree Orchestrator: builds and executes (evidence: `scripts/orchestrate-worktrees.js`)
- Developer → Orchestration Status: checks progress (evidence: `scripts/orchestration-status.js`)
- Orchestration Status → Session Adapters: inspects session (evidence: `scripts/orchestration-status.js`)
- Developer → Harness Audit: audits harness (evidence: `README.md`)
- Agent Harness → Runtime Hooks: dispatches events (evidence: `README.md`)
- Runtime Hooks → Security Monitoring: supports scanning
- Agent Harness → Agent Skills: uses skills (evidence: `README.md`)