tomevault-io Coder Clone-Behavior
Clone an entire program by extracting WHAT it does (behavior), not HOW it's coded. Then reimplement from scratch - same functionality, completely different code.
Dynamic Context
CLI analysis:
!python3 -m erirpg.commands.clone_behavior $ARGUMENTS --json 2>/dev/null || echo '{"error": "CLI failed or dry-run needed"}'
Clone state (if resuming):
!cat clone-state.json 2>/dev/null || echo '{"status": "not_started"}'
CLI Options
python3 -m erirpg.commands.clone_behavior <source-path> <new-project-name> [options] --json
| Option | Description |
|---|---|
--language <lang> |
Target language (default: same as source) |
--framework <framework> |
Target framework |
--skip-tests |
Don't extract test contracts |
--dry-run |
Show plan without executing |
--modules <list> |
Only clone specific modules (comma-separated) |
--exclude <list> |
Skip specific modules (comma-separated) |
The 5 Phases
SOURCE ──► SCAN ──► PLAN ──► IMPLEMENT ──► VERIFY ──► COMPLETE ──► TARGET
(extract) (roadmap) (build) (diff) (finalize)
Phase 1: SCAN - Extract Behaviors
- Map source codebase with
eri-codebase-mapper - Extract BEHAVIOR.md for each module with
eri-behavior-extractor - Verify all behaviors extracted
Parallel execution: Up to 4 behavior extraction agents.
See reference.md for details.
Phase 2: PLAN - Create Roadmap
- Initialize target project directory
- Copy BEHAVIOR.md files to target
- Create PROJECT.md with clone context
- Create REQUIREMENTS.md from behaviors
- Generate ROADMAP.md with
eri-roadmapper
See reference.md for details.
Phase 3: IMPLEMENT - Build From Behaviors
For each module phase:
/coder:plan-phase N- Plan from BEHAVIOR.md (NOT source code)/coder:execute-phase N- Implement in target language idioms/coder:verify-work N- Quick verification
Key principle: Code should look like it was written by someone who never saw the source.
See reference.md for details.
Phase 4: VERIFY - Behavior Diff
For each module:
- Run behavior verification
- Check interface, state machine, tests, resources, ownership
- Fix any ❌ violations before proceeding
- Document ⚠️ manual checks
See reference.md for details.
Phase 5: COMPLETE - Finalize
- Generate CLONE-VERIFICATION.md report
- Tag release with
/coder:complete-milestone v1.0 - Final commit
See reference.md for details.
Agent Strategy
| Phase | Agent | Model |
|---|---|---|
| SCAN | eri-codebase-mapper, eri-behavior-extractor | sonnet |
| PLAN | eri-roadmapper | sonnet |
| IMPLEMENT | eri-planner, eri-executor | opus (complex), sonnet (simple) |
| VERIFY | Built-in verification | sonnet |
Error Recovery
Check progress:
python3 -m erirpg.commands.clone_behavior progress --json
Resume from failed step (not beginning).
Completion
Use templates/completion-box.md format.
Update STATE.md with:
- Modules cloned count
- Behaviors verified count
- Next step: Run and compare with source
Converted and distributed by TomeVault — claim your Tome and manage your conversions.