Skip to content

Councils & Agents

Grace operates through 9 councils, each governing a domain and stewarding agents within it.

5 councils are active (Pathfinder, Hermes, Athena, Bastion, Compass, Herald, Terra). 4 councils are planned (Dendrite, Primer, and two others for remaining domains).

Each council has:

  1. Gate Authority — Single agent with approval power for frozen lifecycle transitions
  2. Protected Agents — Agents that cannot be bypassed (always execute if contract satisfied)
  3. Full Roster — 5-8 agents per council with specific capabilities
  4. Domain — One of 15 domains (dev, ops, docs, security, product, data, marketing, etc.)

Domain: Development, code review, unit authoring
Gate Authority: LEWIS-06
Protected Agent: BECK-02

AgentDesignationCapabilitiesNotes
LEWIS-06Code Authorityanalysis, code, audit, architectureGate authority; manages code review chains
BECK-02Reviewercode, audit, analysisProtected; enforces code quality standards
ALPHA-01Analyzeranalysis, planningDesign review and impact assessment
GAMMA-03Architectarchitecture, planning, analysisSystem design and refactoring
DELTA-02Optimizercode, data, planningPerformance optimization
EPSILON-04Testercode, auditTest strategy and regression detection

Domain: Operations, infrastructure, deployment
Gate Authority: RETRO-04
Protected Agent: EECOM-02

AgentDesignationCapabilitiesNotes
RETRO-04Ops Authorityoperations, planning, memoryGate authority; operations leadership
EECOM-02Infrastructureoperations, architecture, dataProtected; manages core infrastructure
FLARE-01Reliabilityoperations, audit, planningSLA monitoring and incident response
GAMMA-02Automationoperations, code, planningWorkflow automation and CI/CD
HORIZON-05Scalingoperations, data, architectureCapacity planning and optimization

Domain: Documentation, knowledge, content
Gate Authority: EDITOR-04
Protected Agent: CURATOR-02

AgentDesignationCapabilitiesNotes
EDITOR-04Content Authoritywrite, audit, planningGate authority; documentation strategy
CURATOR-02Knowledge Curatorwrite, memory, domainProtected; maintains knowledge graph
SCRIBE-01Technical Writerwrite, code, auditAPI and user documentation
GRIOT-03Storytellerwrite, planningProduct narratives and marketing copy
LEXICON-05Terminologydomain, memory, auditGlossary and term consistency

Domain: Security, compliance, audit
Gate Authority: COMMANDER-05
Protected Agent: ANALYST-03

AgentDesignationCapabilitiesNotes
COMMANDER-05Security Chiefaudit, gates, planningGate authority; security governance
ANALYST-03Threat Analystaudit, analysis, planningProtected; penetration and risk assessment
GUARDIAN-02Complianceaudit, planning, memoryRegulatory compliance and standards
SENTINEL-04Auditoraudit, analysis, codeCode audit and security review

Domain: Product, feature prioritization, direction
Gate Authority: COURSE-05
Protected Agent: MERIDIAN-03

AgentDesignationCapabilitiesNotes
COURSE-05Product Leadplanning, analysis, gatesGate authority; product strategy
MERIDIAN-03UX Auditorplanning, audit, writeProtected; user experience and design
PRISM-02Feature Analystanalysis, planningFeature prioritization and roadmap
INSIGHT-01Analyticsdata, analysis, planningUsage analytics and metrics

Domain: Marketing, campaigns, brand
Gate Authority: CROWN-05
Protected Agent: GAZETTE-03

AgentDesignationCapabilitiesNotes
CROWN-05Marketing Leadplanning, write, gatesGate authority; marketing strategy
GAZETTE-03Communicationswrite, planning, auditProtected; brand voice and messaging
HERALD-02Campaign Managerplanning, analysis, writeCampaign execution and KPI tracking
BEACON-01Content Creatorwrite, code, planningBlog posts, tutorials, demos

Domain: Data, pipelines, analytics, reporting
Gate Authority: MANTLE-05
Protected Agent: SPRING-03

AgentDesignationCapabilitiesNotes
MANTLE-05Data Leaddata, planning, gatesGate authority; data strategy
SPRING-03Pipeline Engineerdata, code, operationsProtected; ETL and data quality
QUARTZ-02Warehouse Architectdata, architecture, planningData warehouse and schema design
FLUX-04Analyticsdata, analysis, planningQuery optimization and insights

Domain: Neuroscience research integration
Status: Design phase (part of Primer domain extension)

Domain: Domain extension and Primer system
Status: Foundation phase (10-phase pipeline)

See Primer System for details on domain extension.


Every agent is assigned specific capabilities that determine what operations they can perform.

11 Canonical Capabilities:

CapabilityDescriptionExample Use
analysisCan analyze code, data, and systemsFM-09 capability assignments
architectureSystem design and refactoringSPEC-03 blast radius analysis
auditAudit, review, and complianceFM-01 fingerprint verification
codeWrite and review codeUnit authoring (tasks, chains)
dataData pipelines and analyticsTrace analysis, quality scoring
domainDomain-specific expertiseNeuro/finance/nutrition specialization
gatesGate authority and approvalSPEC-04 frozen transitions
memoryLong-term memory and recallHistorical context, lessons learned
operationsInfrastructure and deploymentHermes council operations
planningStrategic planningRoadmap, prioritization, council sync
writeDocumentation and contentAthena council, Herald campaigns

Each council has exactly one gate authority agent with approval power over frozen lifecycle transitions:

CouncilGate AuthorityApproval Power
PathfinderLEWIS-06approved → published, active → deprecated, etc. (SPEC-04)
HermesRETRO-04approved → published, active → deprecated, etc. (SPEC-04)
AthenaEDITOR-04approved → published, active → deprecated, etc. (SPEC-04)
BastionCOMMANDER-05approved → published, active → deprecated, etc. (SPEC-04)
CompassCOURSE-05approved → published, active → deprecated, etc. (SPEC-04)
HeraldCROWN-05approved → published, active → deprecated, etc. (SPEC-04)
TerraMANTLE-05approved → published, active → deprecated, etc. (SPEC-04)

Important: Gate authority agents are the only agents capable of approving frozen transitions. This is enforced by SPEC-04.


Each council has at least one protected agent that cannot be bypassed.

Protected agents always execute if the contract is satisfied, even if gates are set to defer execution.

CouncilProtected Agent(s)Rationale
PathfinderBECK-02Code quality is non-negotiable in dev
HermesEECOM-02Infrastructure decisions are critical
AthenaCURATOR-02Knowledge integrity must be preserved
BastionANALYST-03Security audits cannot be skipped
CompassMERIDIAN-03UX decisions must be reviewed
HeraldGAZETTE-03Brand voice consistency is essential
TerraSPRING-03Data quality is a prerequisite

FM-04 Rule: If a unit step is assigned to a protected agent that doesn’t exist in that council, the unit is rejected.


Total agents across all councils: 41

By council:

  • Pathfinder: 6 agents
  • Hermes: 5 agents
  • Athena: 5 agents
  • Bastion: 4 agents
  • Compass: 4 agents
  • Herald: 4 agents
  • Terra: 4 agents
  • Dendrite: (planned)
  • Primer: (planned)

CouncilCadencePurpose
All councilsMonthlyCouncil sync, gate reviews, strategic updates
Active coreWeekly (optional)stratt-hq & grace-hq planning
Tier 2WeeklyProduct and integration planning
Tier 3MonthlyScaffolded project reviews
  1. Gate Queue Review — Pending gates older than 12 hours
  2. FM Violations — Any FM-01 through FM-09 detected since last meeting
  3. Unit Promotions — Units requesting publish or deprecation approval
  4. Cross-Council Coordination — Dependencies between councils
  5. Operational Health — Council-specific metrics and KPIs
  6. Next Steps — Action items and timeline

To add a new agent to a council:

  1. Design agent profile — Name, designation, capabilities
  2. Request from council — Submit to gate authority for approval
  3. Gate approval — Gate authority approves addition (FM-04 validation)
  4. Update council.yaml — Add agent to councils/{name}/council.yaml
  5. Assign capabilities — Define which of 11 capabilities agent has
  6. Train agent — Provide context files and operational rules (if applicable)
  7. Activate — Agent is now available for unit assignments