Getting Started

Prerequisites

Clone repo:

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

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

Grandpa explains commands. Listen or get hit with stick.

Command	DED says
`saipen set`	Stop running like headless chicken. Plant flag. This is project.
`saipen plan`	Grandpa has idea. Agent makes shopping list. No more "I forgot".
`saipen goal <text>`	Want dark mode? Say "goal add dark mode". Agent figures rest. Grandpa naps.
`saipen status`	Where we at? Don't make grandpa ask twice. Read board, shut up.
`saipen scout`	Look before leap. Grandpa taught you at 5. Still applies.
`saipen build`	Scouted? Good. Build exactly what scout said. No side quests.
`saipen verify`	You THINK it works? Run tests. Prove. Grandpa doesn't trust "probably".
`saipen clean`	Clean your room. Digital room also dirty. Grandpa sees orphan files.
`saipen continue`	Yesterday grandpa told something. You forgot. SAIPEN remembers. Listen.
`saipen markhunt`	Every 6 releases. Like dentist. Painful but necessary. STOP WHINING.

SAIPEN phase pipeline:

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

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

Delegatable read-only roles for parallel work:

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

SAIPEN v7.158.0 — One command. Zero dependencies. Zero amnesia. — MIT