Skills

Skills

Overview of all HES skill files.

---

Skill File Structure

skills/
├── 00-bootstrap.md          # Initial project setup
├── 01-discovery.md          # Business rules elicitation
├── 02-spec.md               # BDD scenarios + API contracts
├── 03-design.md             # Architecture decisions (ADRs)
├── 04-data.md               # Data model + SQL migrations
├── 05-tests.md              # Test-first implementation (RED)
├── 06-implementation.md     # Code implementation (GREEN)
├── 07-review.md             # 5-dimension review checklist
├── 08-progressive-analysis.md  # Large codebase analysis
├── 09-issue-create.md       # GitHub Issue creation
├── 10-security.md           # Security scan
├── 11-eval.md               # Eval harness
├── 12-harness-tests.md      # Harness self-testing
├── 13-uninstall.md          # Remove all HES artifacts
├── auto-install.md          # Auto-install HES
├── agent-registry.md        # Registry reference
├── error-recovery.md        # Error diagnosis & recovery
├── harness-health.md        # Coverage diagnostics
├── legacy.md                # Legacy project onboarding
├── refactor.md              # Safe refactoring
├── report.md                # Batch learning reports
├── session-manager.md       # Session lifecycle
├── tool-dispatch.md         # Tool dispatch protocol
├── reference/               # 12 reference documents
│   ├── action-event-protocol.md
│   ├── context-engineering.md
│   ├── domain-templates.md
│   ├── fitness-sensors.md
│   ├── git-hooks.md
│   ├── handoff-schemas.md
│   ├── interactive-ui.md
│   ├── layout-standard.md
│   ├── llm-trace-protocol.md
│   ├── skill-versioning.md
│   ├── step-budget-protocol.md
│   └── telemetry-protocol.md
└── roadmap/                 # 5 stub files for v4.0
    ├── planner.md
    ├── orchestrator.md
    ├── harness-evolver.md
    ├── optimizer.md
    └── reviewer.md

---

Phase Skills

00-bootstrap.md

Initial project setup and configuration.

Gate: .hes/ directory exists with valid current.json

01-discovery.md

Business rules elicitation and requirements gathering.

Gate: docs/discovery.md exists with business rules

02-spec.md

BDD scenarios and API contracts.

Gate: docs/spec.md exists with BDD scenarios

03-design.md

Architecture decisions (ADRs).

Gate: docs/design.md exists with ADRs

04-data.md

Data model and SQL migrations.

Gate: docs/data.md exists with data model

05-tests.md

Test-first implementation (RED phase).

Gate: Tests are written and failing

06-implementation.md

Code implementation (GREEN phase).

Gate: All tests pass

07-review.md

5-dimension code review.

Gate: Review checklist completed

10-security.md

Security scan with Bandit and Semgrep.

Gate: No critical/high findings

---

System Skills

error-recovery.md

Error diagnosis and recovery with categories A-E.

harness-health.md

Coverage diagnostics using Fowler's 3 dimensions.

session-manager.md

Session lifecycle management and checkpoints.

tool-dispatch.md

Tool dispatch protocol for external tools.

---

Reference Documents

Document	Purpose
action-event-protocol.md	Event sourcing format
context-engineering.md	Context management patterns
domain-templates.md	Domain-specific templates
fitness-sensors.md	Architecture fitness functions
git-hooks.md	Git hook integration
handoff-schemas.md	JSON schemas for phase handoffs
interactive-ui.md	Interactive UI patterns
layout-standard.md	File layout standards
llm-trace-protocol.md	LLM tracing format
skill-versioning.md	Version tracking
step-budget-protocol.md	Step budget management
telemetry-protocol.md	Telemetry format

---

Roadmap Stubs (v4.0)

Stub	Target	Purpose
planner.md	v3.6	Task decomposition
orchestrator.md	v3.7	Parallel agent fleet
harness-evolver.md	v3.8	Auto-evolution
optimizer.md	v3.9	Code optimization
reviewer.md	v4.0	Autonomous PR review

---

Last updated: June 2026