- archeflow-decision.sh records decision points during runs - archeflow-replay.sh: timeline, whatif, compare commands - What-if replay with adjustable archetype weights - /af-replay skill for interactive use - Tests in archeflow-replay.bats
2.3 KiB
2.3 KiB
name, description
| name | description |
|---|---|
| using-archeflow | Use at session start when implementing features, reviewing code, debugging, or any task that benefits from multiple perspectives. Activates ArcheFlow multi-agent orchestration. |
ArcheFlow -- Active
On activation, print ONE line then proceed silently:
archeflow v0.9.0 · 24 skills · <domain> domain
Domain auto-detected: writing if colette.yaml exists, research if paper/thesis files, code otherwise.
When to Use What
| Need | Command | When |
|---|---|---|
| Work the queue | /af-sprint |
Multiple tasks pending across projects, "run the sprint" |
| Deep orchestration | /af-run |
Writing/research tasks, security-sensitive code, complex multi-module refactors |
| Code review | /af-review |
Review diff/branch/commits before merging, security-sensitive changes |
| Single feature | feature-dev or direct |
Clear scope, one project -- no orchestration needed |
When to Skip ArcheFlow
Do NOT use for: single-line fixes, questions, reading/exploring, config tweaks, git ops.
Workflow Selection
| Signal | Workflow | Pipeline |
|---|---|---|
| Small fix, low risk | fast |
Creator --> Maker --> Guardian |
| Feature, multi-file, moderate risk | standard |
Explorer + Creator --> Maker --> Guardian + Skeptic + Sage |
| Security, breaking changes, public API | thorough |
Explorer + Creator --> Maker --> All 4 reviewers |
Available Commands
| Command | What it does |
|---|---|
/af-sprint |
Queue-driven parallel agent runner (primary mode) |
/af-run <task> |
PDCA orchestration loop (--dry-run, --start-from, --workflow) |
/af-review |
Guardian-led code review on diff/branch/range |
/af-status |
Current run state, active agents, findings |
/af-report |
Full process report for a run |
/af-init |
Initialize ArcheFlow in a project |
/af-score |
Archetype effectiveness scores |
/af-memory |
Cross-run lesson memory |
/af-fanout |
Colette book fanout via agents |
/af-dag |
DAG of current/last run |
/af-replay <run_id> |
Decision timeline + weighted what-if on recorded events |
Mini-Reflect Fallback
Even when skipping ArcheFlow, apply for non-trivial changes:
- Restate what you're changing
- Name one assumption
- Check if it could break anything