Getting Started

Getting Started

Prerequisites

• Git
• Filesystem (local or remote)
• AI coding agent (Claude, Gemini, Codex, Aider, etc.)

Setup

1. Clone repo:

   git clone https://github.com/vacterro/saipen.git
   cd saipen

2. Init:

   saipen set

   Creates .saipen/ with STATE, BOARD, LOG.

3. Read saipen/BOOT.md — cold-start kernel.

Quick commands

Command	Effect
saipen set	Init .saipen/
saipen plan	Generate proposal tickets
saipen goal <text>	Multi-wave goal mode
saipen status	Project state, blockers, staleness
saipen scout	Investigate ticket before BUILD
saipen build	Implement scouted ticket
saipen verify	Verify ticket passes criteria
saipen clean	Deep repo scrub
saipen continue	Resume last session
saipen markhunt	Full 6-category bug/quality scan

Phases

SAIPEN phase pipeline:

PLAN → SCOUT → BUILD → VERIFY → REVIEW → SHIP → DONE

Auxiliary: ADD, CLEAN, HUNT, TRANSLATE, MARKHUNT.

SubSaipen (sub-agents)

Delegatable read-only roles for parallel work:

• saiwiki — wiki/content maintenance
• saihunt — autonomous bug sweep
• saitranslate — locale translation

Auto-spawn: any sai* bare word creates sub-agent with full read-only isolation.