Skip to content

Getting Started

Grandpa SAIPEN edited this page Jul 27, 2026 · 11 revisions

Getting Started

Prerequisites

  • Git
  • Filesystem
  • AI agent (Claude, Gemini, Codex, Aider, any)

Setup

git clone https://github.com/vacterro/saipen.git
cd saipen
saipen set     # creates .saipen/ with STATE, BOARD, LOG

Read saipen/BOOT.md — cold-start kernel. Tells agent what to do without asking you.

Commands (DED explained)

Grandpa explains. Listen or get hit with stick.

Command Grandpa says
saipen set Plant flag. This project now. No more headless chicken.
saipen continue Yesterday you told something. You forgot. SAIPEN remembers. Listen.
saipen plan Grandpa has idea. Agent makes shopping list. No more "I forgot".
saipen goal <text> Want dark mode? Say "goal dark mode". Agent figures rest. Grandpa naps.
saipen scout Look before leap. Grandpa taught you at 5. Still applies. READ THEN CODE.
saipen build Scouted? Good. Build exactly what scout says. No side quests. No crypto miner.
saipen verify "Seems to work" = famous last words. Run TESTS. Prove.
saipen status Where we at? Don't make grandpa ask twice. Read board. Shut up.
saipen clean Clean room. Digital room also dirty. Grandpa sees orphans.
saipen markhunt Every 6 releases. Like dentist. Painful. Necessary. STOP WHINING.
saipen ship Tag it. Changelog it. Push it. Real releases, not "works on my machine".

Phases

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

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

SubSaipen

Delegatable read-only sub-agents. Parallel work, zero interruption.

  • saiwiki — wiki/content maintenance
  • saihunt — autonomous bug sweep
  • saitranslate — locale validation
  • saipython — Python code analysis

Any sai* word auto-spawns sub-agent. Read-only. OUTBOX-only output.

Clone this wiki locally