Skip to content

Getting Started

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

Getting Started

This guide will help you install and use HES with your AI coding assistant.

Prerequisites

  • An AI coding assistant (Claude Code, Cursor, GitHub Copilot, etc.)
  • Git installed on your system
  • Basic familiarity with the command line

Installation

Option 1: Interactive Installer (Recommended)

git clone https://github.com/josemalyson/hes.git
cd hes
./setup

The installer will:

  1. Detect installed AI tools
  2. Ask for scope (project/global/both)
  3. Copy the correct files per tool
  4. Auto-commit the changes

Option 2: Non-Interactive Install

./setup --tools claude,cursor --scope project --target /path/to/project --yes

Option 3: Manual Copy

Copy the skill files to your agent's directory:

# For Claude Code
cp -r skills/ ~/.claude/skills/hes/
cp SKILL.md ~/.claude/skills/hes/

# For Cursor
cp -r skills/ ~/.cursor/skills/hes/
cp SKILL.md ~/.cursor/skills/hes/

File Locations

Agent Location
Claude Code ~/.claude/skills/hes/ or .claude/skills/hes/
Cursor ~/.cursor/skills/hes/ or .cursor/skills/hes/
GitHub Copilot .github/copilot-instructions.md
Windsurf .windsurfrules
Gemini CLI .agents/skills/hes/
Codex CLI .agents/skills/hes/
Kiro .kiro/skills/hes/

Verify Installation

After installing, test that HES is working:

/hes status

You should see the current phase and project state.

First Steps

1. Start a New Feature

/hes start

This will:

  • Bootstrap the project if needed
  • Ask for the feature name
  • Begin the DISCOVERY phase

2. Follow the Workflow

HES will guide you through each phase:

  1. DISCOVERY — Elicit business rules
  2. SPEC — Write BDD scenarios
  3. DESIGN — Make architecture decisions
  4. DATA — Design data model
  5. RED — Write tests first
  6. GREEN — Implement code
  7. SECURITY — Run security scans
  8. REVIEW — Code review
  9. DONE — Feature complete

3. Check Status Anytime

/hes status

Commands

See Commands for a complete list of all 26 HES commands.

Next Steps

  • Architecture — Learn about HES's technical architecture
  • Phases — Understand the 10-phase workflow
  • Rules — Read the 34 rules
  • Skills — Explore the skill files

Last updated: June 2026

Clone this wiki locally