Files

Christian Nennemann d94688ca1b refactor: trim 11 secondary ArcheFlow skills from 3340 to 952 lines

Remove verbose YAML examples, bash pseudo-code, tutorial prose, and
motivational content from configuration/integration skills while
preserving all operational protocols, reference tables, and rules.

Skills trimmed: domains, colette-bridge, multi-project, cost-tracking,
git-integration, custom-archetypes, workflow-design, templates,
autonomous-mode, progress, presence.

2026-04-06 20:48:50 +02:00

2.1 KiB

Raw Permalink Blame History

name, description

name	description
progress	Live progress file for ArcheFlow orchestrations. Regenerates `.archeflow/progress.md` after every event emission, giving users real-time visibility into run status, budget usage, and DAG shape -- watchable from a second terminal. <example>User: "What's happening with my run?"</example> <example>watch -n 2 cat .archeflow/progress.md</example>

Live Progress -- Real-Time Run Visibility

Maintains .archeflow/progress.md, updated after every event during a run.

Progress File Format

# ArcheFlow Run: 2026-04-03-der-huster
**Status:** DO phase -- maker running (3/6 scenes drafted)
**Started:** 14:32 | **Elapsed:** 8 min
**Budget:** $1.45 / $10.00 (14%)

## Progress
- [x] PLAN: Explorer (87s, 21k tok, $0.02)
- [x] PLAN: Creator (167s, 26k tok, $0.08)
- [x] PLAN -> DO transition
- [ ] **DO: Maker** <- running (5 min elapsed)
- [ ] CHECK: Guardian
- [ ] CHECK: Sage
- [ ] ACT: Apply fixes

## Latest Event
#6 agent.start -- maker (do) -- 14:40

Usage

The run skill calls archeflow-progress.sh after each event emission:

./lib/archeflow-progress.sh <run_id>

From a second terminal:

One-shot: cat .archeflow/progress.md
Continuous: ./lib/archeflow-progress.sh <run_id> --watch
JSON output: ./lib/archeflow-progress.sh <run_id> --json

How the Script Works

Read .archeflow/events/<run_id>.jsonl
Determine current phase and active agent
Build checklist from events (only started/completed agents shown)
Calculate budget from agent.complete cost data
Write .archeflow/progress.md

Checklist Construction

Event Type	Entry
`agent.complete`	`- [x] PHASE: archetype (duration, tokens, cost)`
`agent.start` (no complete)	`- [ ] PHASE: archetype <- running`
`phase.transition`	`- [x] PHASE -> PHASE transition`
`cycle.boundary`	`- [x] Cycle N complete`

Pending (not-yet-started) agents are NOT shown to avoid guessing.

Budget Display

Source: run.start event or .archeflow/config.yaml. If no budget configured: show cost only.

2.1 KiB Raw Permalink Blame History