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):

1. Lawgiver — Creates

   .ushabti/laws.md

   and a minimal docs scaffold (

   .ushabti/docs/index.md

   )
2. Artisan — Creates

   .ushabti/style.md

   , recommends Surveyor for comprehensive docs
3. Surveyor (optional) — Creates comprehensive documentation in

   .ushabti/docs/

4. Scribe — Plans the first Phase (scaffold docs are sufficient to proceed)
5. Builder — Implements the Phase
6. Overseer — Reviews and approves the Phase

For an existing project:

1. Surveyor — Documents the existing codebase
2. Lawgiver — Defines project invariants (docs already exist)
3. Artisan — Defines project style
4. 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.