Skip to content

Agents

Jump to bottom
Josemalyson Oliveira edited this page Jun 27, 2026 · 1 revision

Agents

Agent registry and v4.0 roadmap.

Overview

HES defines 28 agents in .hes/agents/registry.json:

  • 9 Phase agents — One for each workflow phase
  • 14 System agents — Cross-cutting concerns
  • 5 Roadmap stubs — v4.0 multi-agent architecture

Phase Agents

Agent Phase Skill File Purpose
harness-agent ALL SKILL.md Main orchestrator
discovery-agent DISCOVERY 01-discovery.md Business rules elicitation
spec-agent SPEC 02-spec.md BDD scenarios
design-agent DESIGN 03-design.md Architecture decisions
data-agent DATA 04-data.md Data modeling
test-agent RED 05-tests.md Test-first implementation
impl-agent GREEN 06-implementation.md Code implementation
security-agent SECURITY 10-security.md Security scanning
review-agent REVIEW 07-review.md Code review

System Agents

Agent Skill File Purpose
auto-install auto-install.md Auto-install HES
error-recovery error-recovery.md Error diagnosis & recovery
harness-health harness-health.md Coverage diagnostics
legacy legacy.md Legacy project onboarding
refactor refactor.md Safe refactoring
report report.md Batch learning reports
session-manager session-manager.md Session lifecycle
issue-create 09-issue-create.md GitHub Issue creation
progressive-analysis 08-progressive-analysis.md Large codebase analysis
delegation tool-dispatch.md Tool dispatch
registry agent-registry.md Registry reference
security (manual) 10-security.md Manual security scan
eval 11-eval.md Evaluation harness
harness-test 12-harness-tests.md Harness self-testing

v4.0 Roadmap Agents

planner.md (v3.6)

Purpose: Task decomposition

Status: Stub

Target: Q2 2026

Features:

  • Decompose features into tasks
  • Generate execution-plan.json
  • Task dependency graph

orchestrator.md (v3.7)

Purpose: Parallel agent fleet

Status: Stub

Target: Q3 2026

Features:

  • Dispatch agents in parallel
  • Manage Git worktrees
  • Coordinate execution

harness-evolver.md (v3.8)

Purpose: Auto-evolution of harness

Status: Stub

Target: Q4 2026

Features:

  • Analyze events.log
  • Apply trust policy
  • Auto-improve skill files

optimizer.md (v3.9)

Purpose: Code optimization for agent readability

Status: Stub

Target: Q1 2027

Features:

  • 5 optimization transformations
  • Post-optimization validation gate

reviewer.md (v4.0)

Purpose: Autonomous PR review

Status: Stub

Target: Q2 2027

Features:

  • 5-dimension review
  • GitHub/GitLab integration
  • Sandbox testing

Agent Registry Format

{
  "agents": [
    {
      "agent": "discovery-agent",
      "type": "phase",
      "skill_file": "skills/01-discovery.md",
      "trigger": "/hes discovery",
      "phase": "DISCOVERY",
      "status": "stable"
    }
  ]
}

Agent Types

Type Description
phase Phase-specific agent
system Cross-cutting concern
stub Not yet implemented

Agent Triggers

Agents are triggered by:

  1. Commands — /hes <command>
  2. Phase transitions — Automatic on phase change
  3. Errors — Automatic on error detection
  4. Scheduled — Periodic health checks

Last updated: June 2026

Clone this wiki locally