@neuradex/sao
v0.1.3
Published
Stateful Agent Orchestration - methodology and library for AI agent state management
Readme
SAO - Stateful Agent Orchestration
A methodology for overcoming AI agent context limitations and enabling continuous execution of large-scale projects
What is SAO?
AI agents lose memory between sessions:
Traditional: Session 1 → [Work] → Session ends → Memory lost → Session 2 → [Start over]
SAO: Session 1 → [Work] → Save state to documents → Session 2 → Restore state → [Continue]SAO solves this problem through document-based state persistence.
Documentation
| Document | Description | |----------|-------------| | concepts/README.md | SAO methodology overview | | concepts/templates/ | Project templates |
Template List
| Template | Purpose | |----------|---------| | project-readme.md | Project entry point & progress overview | | design.md | Vision, design philosophy & phase design | | phase-readme.md | Phase progress & checklist | | implementation-plan.md | Detailed implementation steps |
Core Concepts
Project (entire project)
├── Phase 1 (major work unit)
│ ├── Step 1 (concrete task)
│ ├── Step 2
│ └── Step 3
├── Phase 2
└── Phase NState Transitions
Not Started ──→ In Progress ──→ Completed
│
↓
BlockedConsumers
Configuration files for tools that use SAO:
| Consumer | Files | |----------|-------| | Claude Code | consumers/claude/ |
Quick Start
Install
npx init-sao-claudeThis sets up .claude/sao/concepts/ and .claude/commands/ in your project.
Update
npx init-sao-claude --updateUpdates SAO core files and commands while preserving your projects in .claude/sao/projects/.
License
MIT
