majiayu000 Ushabti Prerequisites
How to Check Prerequisites
Run these commands to verify required files exist:
[ -f .ushabti/laws.md ] && echo "✓ laws.md exists" || echo "✗ laws.md MISSING (run Lawgiver)"
[ -f .ushabti/style.md ] && echo "✓ style.md exists" || echo "✗ style.md MISSING (run Artisan)"
[ -f .ushabti/docs/index.md ] && echo "✓ docs/index.md exists" || echo "✗ docs/index.md MISSING (run Surveyor)"
[ -d .ushabti/phases ] && echo "✓ phases/ exists" || echo "✗ phases/ MISSING (run Scribe)"
Required Files by Agent
| Agent | laws.md | style.md | docs/ | phases/ |
|---|---|---|---|---|
| Lawgiver | Creates | — | Creates scaffold | — |
| Artisan | Required | Creates | — | — |
| Surveyor | — | — | Creates comprehensive | — |
| Scribe | Required | Required | Required (scaffold OK) | Creates |
| Builder | Required | Required | Recommended | Required |
| Overseer | Required | Required | Recommended | Required |
Bootstrap Flow
For a new project (empty directory):
- Lawgiver — Creates
.ushabti/laws.mdand a minimal docs scaffold (.ushabti/docs/index.md) - Artisan — Creates
.ushabti/style.md, recommends Surveyor for comprehensive docs - Surveyor (optional) — Creates comprehensive documentation in
.ushabti/docs/ - Scribe — Plans the first Phase (scaffold docs are sufficient to proceed)
- Builder — Implements the Phase
- Overseer — Reviews and approves the Phase
For an existing project:
- Surveyor — Documents the existing codebase
- Lawgiver — Defines project invariants (docs already exist)
- Artisan — Defines project style
- Scribe → Builder → Overseer — Normal Phase cycle
Docs Scaffold vs Comprehensive Docs
Scaffold (created by Lawgiver): Minimal index.md with placeholder content. Marked with "Scaffold documentation" text. Sufficient for Scribe to plan, but Surveyor should run for full documentation.
Comprehensive (created by Surveyor): Full project documentation with multiple files covering architecture, systems, and APIs.