Introducing a new way to review your PRs.

Read the announcement

affaan-m / ecc

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

View on GitHub

30 documents · Updated Nov 20, 2026

overview

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/**, and rules/**.
  • 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