Christian Nennemann
4f8e2a9962
- 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
57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
---
|
|
name: using-archeflow
|
|
description: 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:
|
|
1. Restate what you're changing
|
|
2. Name one assumption
|
|
3. Check if it could break anything
|