# phoroth/agentic architecture

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

- Interactive diagram: https://gitdiagram.com/phoroth/agentic
- Repository: https://github.com/phoroth/agentic

## Overview

AGENTIC is a cross-harness agent operating system built around a large skill vault, specialized subagents, and plugin bundles. Its documented user workflow is an engineering lifecycle: plan, test, implement, review, verify, persist architectural knowledge, sync it to a visual vault, and learn from the session. The graph preserves those stages and major advertised capabilities, while distinguishing documented workflow links from the few internal calls visible in sampled source. Many skill and plugin internals were not sampled, so their relationships are not inferred.

Main entry points: [`skills`](https://github.com/phoroth/agentic/tree/main/skills) (Plan work), [`plugins`](https://github.com/phoroth/agentic/tree/main/plugins) (Plugin bundles), [`skills/007/scripts`](https://github.com/phoroth/agentic/tree/main/skills/007/scripts) (AgentShield scanning), [`skills/context-agent/scripts/context_manager.py`](https://github.com/phoroth/agentic/blob/main/skills/context-agent/scripts/context_manager.py) (Context manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_planner["Plan work"]
  node_tdd["TDD workflow"]
  node_implementation["Implement"]
  node_review["Code review"]
  node_verification["Verification"]
  node_subagents["Subagent squads"]
end

subgraph group_memory["Memory and learning"]
  node_contextcli["Context manager<br/>[context_manager.py]"]
  node_contextmodules["Context processing"]
  node_graphify[("Graphify memory")]
  node_obsidian["Obsidian sync"]
  node_learning["Continuous learning<br/>[instinct-cli.py]"]
end

subgraph group_capabilities["Skills and plugins"]
  node_skillvault["Domain skills"]
  node_pluginbundles["Plugin bundles"]
  node_science["Science tools"]
  node_uiinstaller["UI skill installer<br/>[init.ts]"]
end

subgraph group_security["Safety and governance"]
  node_agentshield["AgentShield scanning"]
  node_securityconfig["Security configuration<br/>[config.py]"]
end

node_engineer(("Engineer"))

node_engineer -->|"requests work"| node_planner
node_planner -->|"plans tests"| node_tdd
node_tdd -->|"guides implementation"| node_implementation
node_implementation -->|"submits changes"| node_review
node_review -->|"requests verification"| node_verification
node_verification -->|"records decisions"| node_graphify
node_graphify -->|"syncs task graphs"| node_obsidian
node_obsidian -->|"feeds lessons"| node_learning
node_planner -->|"uses workers"| node_subagents
node_engineer -->|"applies domain skills"| node_skillvault
node_skillvault -->|"bundles capabilities"| node_pluginbundles
node_pluginbundles -->|"includes tools"| node_science
node_engineer -->|"requests security scan"| node_agentshield
node_agentshield -.->|"uses configuration"| node_securityconfig
node_contextcli -->|"orchestrates context"| node_contextmodules
node_engineer -->|"installs skill"| node_uiinstaller

click node_planner "https://github.com/phoroth/agentic/tree/main/skills"
click node_tdd "https://github.com/phoroth/agentic/tree/main/skills"
click node_implementation "https://github.com/phoroth/agentic/tree/main/skills"
click node_review "https://github.com/phoroth/agentic/tree/main/skills"
click node_verification "https://github.com/phoroth/agentic/tree/main/skills"
click node_subagents "https://github.com/phoroth/agentic/tree/main/plugins/ecc"
click node_skillvault "https://github.com/phoroth/agentic/tree/main/skills"
click node_pluginbundles "https://github.com/phoroth/agentic/tree/main/plugins"
click node_science "https://github.com/phoroth/agentic/tree/main/plugins/science/skills"
click node_contextcli "https://github.com/phoroth/agentic/blob/main/skills/context-agent/scripts/context_manager.py"
click node_contextmodules "https://github.com/phoroth/agentic/tree/main/skills/context-agent/scripts"
click node_graphify "https://github.com/phoroth/agentic/tree/main/skills"
click node_obsidian "https://github.com/phoroth/agentic/tree/main/skills"
click node_learning "https://github.com/phoroth/agentic/blob/main/plugins/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py"
click node_agentshield "https://github.com/phoroth/agentic/tree/main/skills/007/scripts"
click node_securityconfig "https://github.com/phoroth/agentic/blob/main/skills/007/scripts/config.py"
click node_uiinstaller "https://github.com/phoroth/agentic/blob/main/skills/ui-ux-pro-max-skill/cli/src/commands/init.ts"

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_planner,node_tdd,node_implementation,node_review,node_verification,node_subagents toneBlue
class node_contextcli,node_contextmodules,node_graphify,node_obsidian,node_learning toneAmber
class node_skillvault,node_pluginbundles,node_science,node_uiinstaller toneMint
class node_agentshield,node_securityconfig toneRose
class node_engineer toneIndigo
```

## Components

### Agent workflow

- [Plan work](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [TDD workflow](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Implement](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Code review](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Verification](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Subagent squads](https://github.com/phoroth/agentic/tree/main/plugins/ecc): `plugins/ecc`

### Memory and learning

- [Context manager](https://github.com/phoroth/agentic/blob/main/skills/context-agent/scripts/context_manager.py): `skills/context-agent/scripts/context_manager.py`
- [Context processing](https://github.com/phoroth/agentic/tree/main/skills/context-agent/scripts): `skills/context-agent/scripts`
- [Graphify memory](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Obsidian sync](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Continuous learning](https://github.com/phoroth/agentic/blob/main/plugins/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py): `plugins/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py`

### Skills and plugins

- [Domain skills](https://github.com/phoroth/agentic/tree/main/skills): `skills`
- [Plugin bundles](https://github.com/phoroth/agentic/tree/main/plugins): `plugins`
- [Science tools](https://github.com/phoroth/agentic/tree/main/plugins/science/skills): `plugins/science/skills`
- [UI skill installer](https://github.com/phoroth/agentic/blob/main/skills/ui-ux-pro-max-skill/cli/src/commands/init.ts): `skills/ui-ux-pro-max-skill/cli/src/commands/init.ts`

### Safety and governance

- [AgentShield scanning](https://github.com/phoroth/agentic/tree/main/skills/007/scripts): `skills/007/scripts`
- [Security configuration](https://github.com/phoroth/agentic/blob/main/skills/007/scripts/config.py): `skills/007/scripts/config.py`

### Other components

- **Engineer**

## Connections

- Engineer → Plan work: requests work (evidence: `README.md`)
- Plan work → TDD workflow: plans tests (evidence: `README.md`)
- TDD workflow → Implement: guides implementation (evidence: `README.md`)
- Implement → Code review: submits changes (evidence: `README.md`)
- Code review → Verification: requests verification (evidence: `README.md`)
- Verification → Graphify memory: records decisions (evidence: `README.md`)
- Graphify memory → Obsidian sync: syncs task graphs (evidence: `README.md`)
- Obsidian sync → Continuous learning: feeds lessons (evidence: `README.md`)
- Plan work → Subagent squads: uses workers (evidence: `README.md`)
- Engineer → Domain skills: applies domain skills (evidence: `README.md`)
- Domain skills → Plugin bundles: bundles capabilities (evidence: `README.md`)
- Plugin bundles → Science tools: includes tools (evidence: `README.md`)
- Engineer → AgentShield scanning: requests security scan (evidence: `README.md`)
- AgentShield scanning → Security configuration: uses configuration
- Context manager → Context processing: orchestrates context (evidence: `skills/context-agent/scripts/context_manager.py`)
- Engineer → UI skill installer: installs skill
