Skip to content

Agents

Aegis Spec coordinates a team of specialists. Each agent does one thing and does it well. None of them try to do everything.

The central orchestrator (Aegis Spec itself) coordinates who enters when, in what order, and at what pace. But you can also trigger any agent directly when you need to.

Required agents

These are part of the main pipeline. The orchestrator runs them in the right sequence.

Agent Phase Analogy Role
Aegis Spec Orchestration The orchestra conductor Coordinates all agents, saves checkpoints, guides the user
Scout Reconnaissance The real estate agent Maps the surface: folders, languages, frameworks, dependencies, entry points
Archaeologist Excavation The excavator Deep module-by-module analysis: algorithms, flows, data structures
Detective Interpretation Sherlock Holmes Extracts implicit business rules, ADRs, state machines, permissions
Architect Interpretation The cartographer Synthesizes everything into C4 diagrams, ERD, and integration map
Writer Generation The notary Generates SDD specs, OpenAPI, and user stories with code traceability

Optional agents

Installed by default, but can be triggered independently at any time.

Agent Analogy When to use
Reviewer The spec reviewer After the Writer: critically reviews specs and validates gaps
Visor The forensic illustrator When screenshots of the system are available
Data Master The geologist When DDL, migrations, or ORM models are available
Design System The stylist When CSS files, themes, or interface screenshots are available
Keeper The notary at your shoulder After every code change — keeps specs synchronized with the code

Translators (input adapters)

Use when the legacy "code" is not source code, but a structured artifact like a visual workflow. Generates an SDD spec and prepares the state for the main pipeline to take over.

Agent Analogy When to use
N8N Translator The certified translator When you have an N8N workflow exported as JSON and want to document it as a spec or port to Python 
/aegis → orchestrates everything automatically

Or manually, if you prefer to control each step:

Scout → Archaeologist (N sessions) → Detective → Architect → Writer → Reviewer

Optional at any phase:
Visor · Data Master · Design System