AGENTS.md

1# EGC: Agent Catalog
2 
3Extended Global Context (EGC) is a production-grade, multi-agent system providing 61 specialized agents, 230+ skills, 77 commands to any compatible AI coding environment.
4 
5## Quick Start
6 
7Install once and get access to the full catalog:
8 
9```bash
10node scripts/install-apply.js --target egc
11```
12 
13## Project Structure
14 
15```
16agents/    : 61 specialized subagents
17skills/    : 230+ workflow skills and domain knowledge
18commands/  : 77 slash commands
19```
20 
21## Agents
22 
23Each agent in `agents/` is a Markdown file with YAML frontmatter declaring its name, description, model, and tools. Agents are loaded automatically by the EGC runtime and made available to the orchestrator.
24 
25### Available Agents
26 
27| Agent | Description |
28|-------|-------------|
29| a11y-architect | Accessibility Architect specializing in WCAG 2.2 compliance |
30| architect | System design and architecture guidance |
31| build-error-resolver | Diagnoses and resolves build and compilation errors |
32| chief-of-staff | High-level project coordination and planning |
33| code-architect | Code structure and design patterns |
34| code-explorer | Codebase navigation and understanding |
35| code-reviewer | Comprehensive code review and feedback |
36| code-simplifier | Refactoring and simplification guidance |
37| comment-analyzer | Code comment quality and documentation analysis |
38 
39And many more: see `agents/*.md` for the full list.
40 
41## Runtime
42 
43The EGC runtime routes tasks to the appropriate agent using the execution orchestrator, session manager, and tracer. Agents communicate via the LLM dispatcher, which supports Gemini, Claude, OpenAI, OpenRouter, and Ollama providers.
44 
45## MCP Servers
46 
47- `egc-guardian`: `validate_command`, `validate_write`, `reduce_context`, `orchestrate_task`
48- `egc-memory`: `get_state`, `update_state`, `store_decision`, `query_history`, `search_history`
49 
50Run `sh install.sh` to build the servers. Run `egc doctor` to verify they are registered and running.
51 
52## EGC Guardian Protocol — MANDATORY
53 
54These calls are automatic and non-negotiable. Never wait for the user to ask.
55 
56**Start of every task (non-trivial):** call `orchestrate_task({ prompt: "<task>" })`
57**Before every shell/Bash command:** call `validate_command({ command: "<cmd>" })`
58**Before every new file Write or Edit on a file not yet read:** call `validate_write({ filepath: "<path>" })`
59 
60Skipping any of these breaks the EGC contract. There are no exceptions for "simple" tasks.
61 
62<!-- egc:start -->
63## EGC Project Memory
64 
65<!-- egc:end -->
66