Knowledge Base updated: 2026-11-19
ECC knowledge base
ECC is an engineering-assistant toolkit combining installable agent capabilities, orchestration workflows, host integrations, evaluation tooling, and two operator control planes: a JavaScript dashboard/canvas surface and the Rust ECC2 terminal application.
Core capability content lives in agents/, commands/, skills/, contexts/, and rules/. Installation selection and persistent setup are defined by installer scripts and install manifests. Operational state is coordinated through work-item, session, worktree, GitHub, and host-hook integrations.
The repository's principal runtime surfaces are the Python LLM runtime, orchestration scripts and GitHub adapters, JavaScript control-plane utilities, ECC2's Rust TUI, and interactive UI-canvas command/server tooling.
flowchart TD
Install[Installer and manifests] --> Capabilities[Agents, commands, skills, contexts, rules]
Capabilities --> Hosts[Assistant hosts and plugins]
Capabilities --> Orchestration[Workflow orchestration]
Orchestration --> Worktrees[Worktrees and work items]
Orchestration --> GitHub[GitHub coordination]
Capabilities --> LLM[Python LLM runtime]
LLM --> Providers[Provider adapters]
LLM --> Tools[Prompt and tool execution]
Orchestration --> Eval[Evaluation harness]
Hosts --> Hooks[Host hooks and memory]
Orchestration --> Control[JavaScript control plane]
Control --> Canvas[UI canvas workspace]
Control --> Proximity[Agent proximity views]
Orchestration --> ECC2[ECC2 terminal control plane]
ECC2 --> Worktrees
Glossary
- ECC2 — Rust terminal control plane for concurrent engineering sessions and operator visibility.
- GateGuard — Hook-driven safety guidance and evidence flow for change operations.
- Pi Core — Curated distribution bundle of ECC commands and skills.
- UI canvas — Interactive server/editor workspace for work-item delivery and feedback.
- Context profile — Selectable package of repository guidance and compatible assistant-launch behavior.
Invariants
- Installation capability selection is manifest-driven; install component, module, and profile definitions are maintained under
install/**and their schemas. - Assistant behavior is supplied as declarative capability content rooted in
agents/**,commands/**,skills/**,contexts/**, andrules/**. - UI-canvas command behavior is paired with reusable skill guidance in commands/ui-canvas.md and
skills/ui-canvas/**. - GitHub automation policy is encoded in repository workflow definitions under
.github/workflows/**. - Host adaptation is configuration-led: plugin packaging is rooted at plugins/…/plugin.json, while Antigravity host events are declared in hooks/antigravity-hooks.json.
Routing table
install/**,scripts/install/**-> Installation and distributioninstall/**,scripts/install/**-> Installer orchestrationinstall/manifests/**,install/schemas/**,install/profiles/**-> Installation manifests and schemasagents/**,contexts/**,rules/**-> Agent catalog and promptsagents/**,commands/**-> Agent roles and command surfaceskills/**,contexts/**,rules/**-> Skills, contexts, and language rulespi-core/**,packages/pi-core/**-> Pi Core capability bundlescripts/orchestration/**,workflows/**,commands/**-> Orchestration and autonomous workflowsscripts/orchestration/**,scripts/worktrees/**,commands/**-> Workflow execution and worktreesscripts/work-items/**,scripts/loops/**,commands/**-> Work items, loops, and epicscommands/coordination-inventory*,scripts/lib/coordination-inventory/**,fixtures/**-> Coordination inventory and goals.github/workflows/**,commands/github*,scripts/github/**,config/native-coordination/**-> GitHub coordination and policyecc/**,llm/**,python/**-> LLM runtime and provider routingecc/providers/**,llm/providers/**,python/**/providers/**-> LLM providers and model selectionecc/prompts/**,ecc/tools/**,llm/prompts/**,llm/tools/**-> LLM prompts and tool executionskills/evaluation-harness/**,commands/evaluation-harness*,scripts/evaluation/**-> Evaluation harness and evidenceskills/evaluation-harness/**,commands/evaluation-harness*,scripts/lib/evaluation/**-> Evaluation gates, capsules, and replayecc2/**-> ECC2 terminal control planeecc2/src/session/**,ecc2/src/comms/**,ecc2/src/worktree/**,ecc2/src/config/**-> ECC2 sessions, communications, and worktreesecc2/src/tui/**,ecc2/src/observability/**,ecc2/src/notifications/**-> ECC2 observability, notifications, and TUIscripts/control-plane/**,dashboard/**, commands/ui-canvas.md,skills/ui-canvas/**-> Operator control plane and readinessscripts/lib/agent-proximity/**,scripts/control-plane/views/**,dashboard/**-> Control-plane views and agent proximity- commands/ui-canvas.md,
skills/ui-canvas/**,scripts/ui-canvas/**,ui-canvas/**-> UI canvas workspace plugins/**,hooks/**,integrations/**,compat/**-> Host integrations and plugin adaptershooks/**,scripts/hooks/**,scripts/memory/**-> Hooks, memory, and host eventsplugins/ecc/**,aura/**,compat/**-> Plugin packaging and Aura integrationcontext-profiles/**,profiles/**,commands/context*-> Context profiles and deliverycontext-profiles/**,profiles/**,scripts/context/**-> Context selection and retrievalskills/gateguard/**,hooks/**,scripts/gateguard/**-> GateGuard change safety