Files
claude-archeflow-plugin/CHANGELOG.md
Christian Nennemann 4f8e2a9962 feat: add run replay for archetype effectiveness analysis
- 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
2026-04-06 21:43:29 +02:00

6.8 KiB

Changelog

All notable changes to ArcheFlow are documented in this file.

[0.9.0] -- 2026-04-06

Added

  • Run replay: decision.point events via archeflow-decision.sh; archeflow-replay.sh with timeline, whatif (weighted archetype weights + threshold), and compare; skill af-replay; DAG labels for decision.point.

[0.7.0] -- 2026-04-04

Added

  • Context isolation protocol in attention-filters skill and all 7 agent personas — agents receive only orchestrator-constructed context, no session bleed or cross-agent contamination
  • Structured status tokens (STATUS: DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, BLOCKED) for all agents with orchestrator parsing protocol in run skill
  • Evidence-gated verification in check-phase — CRITICAL/WARNING findings require concrete evidence (command output, code citations, reproduction steps); banned speculative phrases auto-downgrade to INFO
  • Plan granularity constraint in plan-phase and Creator — each change item must be a 2-5 minute task with exact file path, code block, and verify command
  • Strategy abstraction with pdca (cyclic) and pipeline (linear) execution strategies, auto-selection by task type, and pipeline execution flow in run skill
  • Experimental status and interdisciplinary framing in README

[0.6.0] -- 2026-04-04

Added

  • Expanded attention-filters skill with prompt templates, token budgets, cycle-back filtering, and verification checklist
  • Explorer skip heuristic in plan-phase with decision table for when to skip/require research
  • Runnable quickstart example (examples/runnable-quickstart.md)

Fixed

  • Normalized agent persona frontmatter: added examples, moved isolation note to Rules, documented model choices

[0.5.0] -- 2026-04-04

Added

  • Lib script validation at run initialization — fail fast if required scripts or jq are missing
  • Hook points documentation with 6 lifecycle events (run-start, phase-complete, agent-complete, pre-merge, post-merge, run-complete) and config template
  • Phase rollback support in archeflow-rollback.sh via --to <phase> flag
  • Per-workflow model assignment configuration with fallback chain (per-workflow per-archetype > per-workflow default > per-archetype > global default)
  • Cross-run finding regression detection in archeflow-memory.sh — compares current findings against previously resolved fixes
  • Check-phase parallel reviewer spawning protocol with Guardian-first sequence, A2 fast-path evaluation, timeout handling, and re-check protocol

[0.4.0] -- 2026-04-04

Added

  • Confidence gate parsing with bash snippets for extracting scores from plan-creator.md
  • Mini-Explorer spawning when risk coverage < 0.5
  • Worktree merge flow with explicit pre-merge hooks and post-merge test validation
  • archeflow-rollback.sh for post-merge test failure auto-revert
  • Test-first validation gate in Do phase
  • Memory injection audit trail with --audit flag and audit-check command

Fixed

  • Unified feedback routing tables across orchestration, act-phase, artifact-routing

[0.3.0] -- 2026-04-03

Added

  • Automated PDCA execution loop (archeflow:run) with --start-from and --dry-run support
  • Event-sourced process logging (archeflow:process-log) with DAG parent relationships
  • ASCII DAG renderer (archeflow-dag.sh) with color output
  • Markdown process report generator (archeflow-report.sh) with summary and DAG modes
  • Live progress file (archeflow:progress) watchable from a second terminal
  • Domain adapter system (archeflow:domains) for writing, research, and custom domains
  • Cost tracking skill (archeflow:cost-tracking) with budget enforcement and model tier recommendations
  • Cross-run memory system (archeflow:memory) that learns recurring findings and injects lessons
  • Convergence detection (archeflow:convergence) to prevent wasted cycles from stalling or oscillation
  • Colette bridge (archeflow:colette-bridge) for automatic writing platform integration
  • Template gallery (archeflow:templates) with init, save, clone, and list operations
  • Archetype effectiveness scoring (archeflow:effectiveness) across signal-to-noise, fix rate, cost efficiency
  • Git-per-phase commit strategy (archeflow:git-integration) with branch-per-run and rollback
  • Multi-project orchestration (archeflow:multi-project) with dependency DAG and shared budget
  • Act phase skill (archeflow:act-phase) for post-Check decision logic and fix routing
  • Artifact routing skill (archeflow:artifact-routing) for inter-phase artifact management
  • archeflow-event.sh -- structured JSONL event appender
  • archeflow-git.sh -- per-phase commits, branch creation, merge, and rollback
  • archeflow-init.sh -- template gallery script (init, save, clone, list)
  • archeflow-memory.sh -- cross-run memory management (add, list, decay, forget)
  • archeflow-progress.sh -- live progress file generator
  • archeflow-score.sh -- archetype effectiveness scoring from completed runs
  • Short fiction workflow example (kurzgeschichte.yaml) with custom archetypes and Colette integration
  • Story-explorer and story-sage custom archetype examples

[0.2.0] -- 2026-04-03

Added

  • Plugin consolidation into single shareable archeflow/ directory
  • Workflow intelligence with conditional escalation, fast-path, and confidence triggers
  • Quality loop with self-review, convergence detection, dedup, and completion promises
  • Parallel teams with auto-resume and budget scheduling
  • Extensibility: archetype composition, team presets, hook points, workflow templates
  • Mini-reflect fallback for non-ArcheFlow single-file changes (Ralph Loop integration)
  • Comprehensive README with install, usage, debugging, and examples
  • DX improvements: structured confidence, alternatives surfacing

Fixed

  • Redesigned adaptation rules per Guardian review to resolve race conditions
  • Synced Creator agent definition with orchestration skill expectations
  • Wired hooks correctly and added cost table documentation

[0.1.0] -- 2026-04-02

Added

  • Initial release: 7 Jungian archetypes (Explorer, Creator, Maker, Guardian, Skeptic, Trickster, Sage)
  • PDCA orchestration engine with fast, standard, and thorough workflows
  • Shadow detection with quantitative heuristics per archetype
  • Cross-cycle structured feedback with routing and resolution tracking
  • Attention filters for per-archetype context optimization
  • Autonomous mode for unattended overnight sessions
  • Custom archetypes and workflow design skills
  • SessionStart hook for automatic activation
  • archeflow-dag.sh and archeflow-report.sh process visualization scripts

Changed

  • Removed ArcheHelix branding, adopted plain PDCA language
  • Trimmed phase skills to reduce token waste
  • Simplified to one shadow per archetype for clearer detection

Fixed

  • Rewrote SessionStart hook in pure Node for portability (no bash/awk/sed dependencies)
  • Made hook robust with graceful fallbacks (no set -e)
  • Corrected repository URLs