claude-archeflow-plugin/docs/status.md

# ArcheFlow — Status Log

## 2026-04-06: Run replay (v0.9.0)

- `lib/archeflow-decision.sh` — append `decision.point` (phase, archetype, input, decision, confidence).
- `lib/archeflow-replay.sh` — `timeline` / `whatif` (weighted archetypes, threshold) / `compare`; optional `--json`.
- Skill `af-replay`, plugin bump, DAG renders `decision.point`, `tests/archeflow-replay.bats`.

## 2026-04-04: Triple Release Sprint (v0.4 → v0.6)

### What happened
Three ArcheFlow PDCA cycles in one session, each using ArcheFlow's own orchestration to develop itself (dogfooding). Each cycle: Explorer→Creator→Maker→Guardian+Skeptic+Sage→fixes→merge→push.

### v0.4.0 — Gap Fixes (8 commits, 541 lines, 15 files)
- Unified feedback routing tables across 3 skills (canonical 8-row version)
- Confidence gate with concrete bash parsing, 3 branches (pause/upgrade/mini-Explorer)
- `archeflow-rollback.sh` — post-merge auto-revert with `--mainline 1`
- Test-first validation gate in Do phase (word-boundary patterns)
- Memory injection audit trail (`--audit` flag, `audit-check` command)
- Review fixes: safe jq `--arg`, confidence fallback→0.0, pattern hardening

### v0.5.0 — Infrastructure (8 commits, 483 lines, 12 files)
- Lib script validation at run initialization (0a)
- Hook points documentation (`docs/hooks.md` + config template with 6 events)
- Phase rollback via `--to <phase>` in rollback script
- Per-workflow model assignment configuration
- Cross-run finding regression detection
- Check-phase fleshed out with parallel reviewer spawning protocol
- Review fixes: mutual exclusivity guard, jq --arg everywhere, table-row grep

### v0.6.0 — Quality Polish (5 commits, 253 lines, 13 files)
- Attention-filters expanded from 39-line stub to full skill (prompt templates, token budgets, cycle-back rules, verification checklist)
- Explorer skip heuristic in plan-phase skill
- Agent persona normalization (4 agents: examples, model comments, isolation note)
- Runnable quickstart example (`examples/runnable-quickstart.md`)
- CHANGELOG completed with missing v0.4.0 entry + roadmap version history

### v0.7.0 — Superpowers-Inspired + Strategy Abstraction (8 commits, 485 lines, 20 files)
- Context isolation protocol (attention-filters + all 7 agents)
- Structured status tokens: DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED
- Evidence-gated verification: banned phrases, evidence markers, downgrade-to-INFO
- Plan granularity constraint: 2-5 min tasks with file:line + code block + verify
- Strategy abstraction: `pdca` (cyclic) vs `pipeline` (linear) vs `auto` (selected by task)
- README: experimental status + interdisciplinary framing (psychology + process eng + software eng)
- Review fixes: fast→pipeline auto-select, merge guard, evidence check completeness

### Key numbers
| Metric | v0.3 → v0.7 delta |
|--------|-------------------|
| Commits this session | 29 |
| Lines added | ~1,762 |
| Files touched | 30+ |
| Lib scripts | 8 → 9 (archeflow-rollback.sh) |
| Skills | 24 (all fleshed out, no stubs remain) |
| Review cycles | 4 (v0.4: full, v0.5: full, v0.6: fast, v0.7: Guardian-only) |
| Review findings fixed | 15 |

### What to do next
1. **End-to-end dogfood** — run `af-run` on a real task (not ArcheFlow itself) to test both strategies
2. **Hook execution runtime** — config documents 6 hook events but no runner yet
3. **Pipeline strategy testing** — exercise the `--strategy pipeline` path on a bug fix
4. **Publish** — tag v0.7.0, consider claude.com/plugins marketplace listing
5. **GitHub Action** — automated PR review (roadmap item, low effort)

## 2026-04-03: Major Feature Sprint (v0.1 → v0.3)

### What happened
Single-session sprint that took ArcheFlow from 9 skills + 2 scripts to **24 skills + 8 scripts**. Driven by dogfooding: we wrote a short story ("Der Huster", Giesing Gschichten) using ArcheFlow to orchestrate the creative writing process, and every gap we hit became a feature.

### Commits (chronological)
```
1753e69 feat: process logging with DAG-based event sourcing
b6df3d1 feat: automated PDCA loop, domain adapters, cost tracking, DAG renderer
19f8f76 feat: memory, convergence, colette bridge, templates, progress, effectiveness, git integration
6bd2c93 feat: archeflow-init.sh template gallery script
ef995fd feat: archeflow-git.sh for per-phase commits and rollback
ee5dfa7 feat: multi-project orchestration with dependency DAG and shared budget
9faea1d feat: progress and effectiveness scoring scripts
9e22ff5 docs: rewrite README, CHANGELOG, skill index, roadmap
9bf64fc fix: input validation for event emitter + test report (42/42 pass)
```

### What's production-ready
- All 8 lib scripts pass validation (42/42 tests, see docs/test-report-2026-04-03.md)
- README fully rewritten with all 24 skills documented
- CHANGELOG covers v0.1 → v0.3
- Plugin manifest updated to v0.3.0
- Event emitter has input validation (JSON + parent format)

### New features by category

**Core Orchestration:**
- `archeflow:run` — single-command PDCA with --start-from, --dry-run
- `archeflow:act-phase` — structured review→fix pipeline
- `archeflow:artifact-routing` — inter-phase artifact protocol

**Process Intelligence:**
- `archeflow:process-log` — event-sourced JSONL with DAG parents
- `archeflow:memory` — cross-run learning from recurring findings
- `archeflow:effectiveness` — per-archetype signal-to-noise scoring
- `archeflow:progress` — live progress.md during runs
- `archeflow:convergence` — oscillation detection + early termination

**Integration:**
- `archeflow:colette-bridge` — auto-inject voice profiles, personas, characters
- `archeflow:git-integration` — branch-per-run, commit-per-phase, rollback
- `archeflow:multi-project` — cross-repo orchestration with dependency DAG

**Configuration:**
- `archeflow:domains` — writing/code/research domain adapters
- `archeflow:cost-tracking` — budget enforcement + model tier recommendations
- `archeflow:templates` — workflow gallery with init/save/share

### Dogfood project: Giesing Gschichten
- Voice profile, persona, series config in Colette
- First story "Der Huster" (~6000 words) — full PDCA cycle
- All process artifacts: research, outline, reviews, event log, process report
- In `book.giesing-gschichten/` (parent repo) + `writing.colette/` (Colette repo)

### Done (late session)
- **Global hook** — `.claude/settings.json` with SessionStart hook, CLAUDE.md updated with ArcheFlow section
- **Template bundles** — 4 bundles shipped: writing-short-story, backend-feature, security-review, quick-fix (22 files, +936 lines)
- **Multi-project examples** — giesing + fullstack examples + examples/README.md
- **Default config** — `.archeflow/config.yaml` with all documented options
- **Production hardening** — 42/42 script tests pass, input validation on event emitter

### What to do next
1. **Write story #2** with live event logging (true dogfood of `archeflow:run` + `archeflow:progress`)
2. **Colette integration test** — test colette-bridge with actual `colette write` commands
3. **Multi-project run** — test cross-repo orchestration using `examples/multi-project-giesing.yaml`
4. **Publish** — consider making the repo public for others to use
5. **MCP server** — ArcheFlow as MCP tool for Cursor/Windsurf (future)

### Architecture snapshot
```
archeflow/
├── agents/          7 archetype personas (md)
├── skills/         24 behavioral skills (md)
├── lib/             8 bash utilities (sh)
├── examples/        workflows, teams, archetypes
├── hooks/           session-start auto-activation
├── docs/            roadmap, test report
├── CHANGELOG.md     v0.1 → v0.3
└── README.md        full reference
```

### Key numbers
| Metric | Value |
|--------|-------|
| Skills | 24 |
| Agents | 7 |
| Lib scripts | 8 |
| Total lines added | ~7,600 |
| Tests passed | 42/42 |
| Version | 0.3.0 |