SAIPEN

Continuation protocol for AI coding agents. Persistent project memory in plain markdown, so a cold agent with no chat history runs /saipen continue and resumes work in under a minute -- no rebriefing, any vendor, any day.

One command. Zero amnesia.

v7.40.0 | Spec | Guide | RFC | Style | UI | Conformance | plain markdown | zero deps | MIT

User  ->  /saipen continue
Agent ->  reads STATE ("What do I do right now?")
Agent ->  reads BOARD ("What task am I picking up?")
Agent ->  reads next_action (executes command)
Agent ->  Works.

Project State > Model Memory

Memory lives in the project, not in a model's head. Project -> Memory -> LLM becomes Project -> SAIPEN State -> LLM.

Key Protocol Logic & Guarantees

• Core State Machine: INIT → PLAN → SCOUT → BUILD → VERIFY → REVIEW → SHIP → DONE | BLOCKED
• Zero-Prompt Autonomy: Board empty? Auto-transitions HUNT (scan bugs) → ADD (evolve features) → HUNT loop. Zero questions asked.
• Explicit Triggers: /saipen clean (repo scrub), /saipen translate (isolated .saipen/saitranslate/ factory), /saipen validate (conformance check), /saipen goal (autonomous wave execution).
• Strict Reliability: Batch input parsing (surgical 1-by-1 tickets), dirty-tree adoption (never wipes uncommitted work), secret redaction (sk-***).

Projects Powered by SAIPEN

• ⚡ FastPrompter — High-performance prompt management tool natively integrated with SAIPEN memory protocol.

Two Layers

Layer	Required	Purpose
Core	✅	Continue work safely
Maintenance	On top of Core	Evolve the software with no tasking

Automated Evolution. Board empty, type /saipen: HUNT audits for bugs, dead code, failing tests. Clean? ADD builds the next obvious missing capability, verifies it, hunts again. Product's mature -> stops gracefully.

GOAL Mode. /saipen goal <what you want> pivots the board (old tickets demoted, never deleted) and runs the new objective forward -- no "shall I continue?" between tickets, VERIFY/REVIEW never skipped. SHIP auto-pushes to an existing remote; a brand-new repo still asks once. Shipping the objective isn't the stopping point either -- it falls straight into autonomous HUNT/ADD maintenance until the product is mature, blocked, or the run hits its cap (3 waves / 20 tickets, then checkpoints and reports).

Quick Start

1. Install once per machine -- teaches Claude Code, Gemini, OpenCode, Aider, Antigravity:

git clone https://github.com/vacterro/saipen
cd saipen
powershell -ExecutionPolicy Bypass -File .\bootstrap\inject.ps1     # Windows
bash bootstrap/inject.sh                                            # macOS / Linux

2. Start a project -- open an agent in your folder, type:

saipen set

No install? Paste one line to any agent:

Read /saipen/RFC.md + /saipen/STYLE.md and follow them.

Platform not in the list above (DeepSeek, Qwen, standalone OpenAI, etc.)? Per-platform notes live in extensions/adapters/.

Documentation & Specification Links

• SPEC.md -- formal architecture, design goals, litmus test.
• RFC.md -- normative specification executed by agents.
• GUIDE.md -- human tutorial & ELI5 guides:
  • 🇷🇺 Русский | 🇺🇸 English | 🇪🇪 Eesti | 🇯🇵 日本語 | 👴 Версия Деда
  • 🇺🇦 Українська | 🇩🇪 Deutsch | 🇫🇷 Français | 🇪🇸 Español | 🇮🇹 Italiano
  • 🇵🇹 Português | 🇳🇱 Nederlands | 🇵🇱 Polski | 🇸🇪 Svenska | 🇩🇰 Dansk
  • 🇫🇮 Suomi | 🇳🇴 Norsk | 🇨🇳 中文 | 🇰🇷 한국어 | 🇹🇭 ไทย | 🇻🇳 Tiếng Việt | 🇸🇦 العربية | 🇮🇱 עברית
  • 🇹🇷 Türkçe | 🇮🇳 हिन्दी | 🇮🇩 Bahasa Indonesia | 🇬🇷 Ελληνικά | 🇨🇿 Čeština | 🇷🇴 Română
  • 🇭🇺 Magyar | 🇧🇬 Български | 🇸🇰 Slovenčina | 🇭🇷 Hrvatski
• STYLE.md -- agent communication style & voice definition.
• UI.md -- Dark Golden Win95 UI design guidelines.
• CONFORMANCE.md -- behavioral test scenarios & validator rules.