1753e69a9f
feat: add process logging with DAG-based event sourcing
...
Event-sourced orchestration logging: JSONL events with parent
relationships form a DAG for causal reconstruction of agent flows.
Includes bash event emitter (jq-based) and markdown report generator.
2026-04-03 11:06:02 +02:00
8dec44d199
chore: consolidate plugin for sharing
...
- Add .gitignore (ignore .archeflow/ runtime state)
- Move custom archetype examples from .archeflow/ to examples/
- Remove onboarding skill (covered by using-archeflow + README)
- Remove internal planning doc
- Clean roadmap (remove tool.archeflow references)
- Simplify session-start hook config
- Polish README for external users
2026-04-03 07:29:53 +02:00
5eefa309cb
fix: redesign adaptation rules per Guardian review — resolve race conditions
...
Guardian review (Sprint 1) found critical issues in adaptation rules:
- A2 couldn't skip already-spawned parallel reviewers (race condition)
- A1 escalated then A2 skipped the escalated reviewers (self-defeating)
- A3 "Pause" conflicted with parallel agent execution
- A1's "thorough" override was unreachable dead code
Fixes:
- Reorder rules: A3 (after Plan) → A2 (after Guardian) → A1 (after Check)
- Guardian now runs first in Check phase, A2 evaluated before spawning others
- A2 doesn't apply to escalated workflows or first cycle of thorough
- A3 task-understanding pause runs before Do phase (no cancellation needed)
- Added explicit evaluation order diagram
2026-04-03 06:25:27 +02:00
8755d68dc9
fix: address Guardian review findings — sync Creator agent, wire hooks, add cost table
...
- Sync agents/creator.md output format with plan-phase skill (3-axis confidence,
alternatives considered, mini-reflect) — fixes adaptation rule A3 dependency
- Wire hook points into orchestration Act phase (pre-merge, post-merge)
- Add cost-per-agent-tier table to autonomous-mode for budget scheduling
- Add team preset loading reference to orchestration Step 0
2026-04-03 06:23:47 +02:00
761d64b821
feat: DX, extensibility, and adaptive intelligence — completes 25-feature backlog
...
Sprint 5 — Developer Experience (D1-D5):
- Progress indicators with emoji phase markers during orchestration
- Dry-run mode: preview workflow without executing
- /archeflow:status and /archeflow:history commands
- Onboarding skill for first-time users
Sprint 6 — Extensibility (E1-E4, A4-A6):
- Archetype composition: combine 2 archetypes into super-reviewer
- Team presets: save common team configs in .archeflow/teams/
- Hook points: pre-plan, post-check, pre-merge, post-merge custom validation
- Workflow template library: api-design, migration, dep-upgrade, docs, hotfix
- Reviewer profiles: per-project config of which reviewers run
- Explorer cache: skip redundant research on recently-explored code
- Learning from history: track archetype usefulness, recommend profile changes
2026-04-03 06:20:44 +02:00
83e09b70f2
feat: workflow intelligence, quality loop, completion promises, parallel teams
...
Sprint 1 — Workflow Intelligence (A1-A3):
- Conditional escalation: fast→standard on 2+ CRITICALs
- Guardian fast-path: skip remaining reviewers on clean pass
- Confidence-triggered escalation: pause/upgrade/probe on low scores
Sprint 2 — Quality Loop (B1-B2, B5-B6):
- Maker self-review checklist before submitting to Check phase
- Proposal diff ("What Changed") on cycle 2+ revisions
- Convergence detection: escalate to user if same finding persists 2 cycles
- Cross-archetype dedup: merge duplicate findings from different reviewers
Sprint 3 — Completion & Verification (B3-B4):
- Completion promise: user-defined done criteria checked in Act phase
- Post-merge verification: run tests on main, auto-revert on failure
Sprint 4 — Parallel & Scale (C1-C4):
- Parallel team orchestration: 2-3 independent teams with merge gate
- Task dependency graph in autonomous queue format
- Auto-resume on interruption via .archeflow/state.json
- Budget-aware scheduling with automatic workflow downgrade
2026-04-03 06:17:53 +02:00
5139f1ad89
feat: Ralph Loop integration — mini-reflect, alternatives, structured confidence
...
- Mini-Reflect for fast workflow: Creator must restate task, list assumptions,
name highest-damage risk before proposing (catches misunderstandings early)
- Alternatives Considered section: Creator must evaluate 2+ approaches with
rejection rationale before committing to one (prevents tunnel vision)
- Structured confidence scoring: 3-axis table (task understanding, solution
completeness, risk coverage) replaces bare 0.0-1.0 number. Low scores
trigger targeted action (clarify, upgrade workflow, or research)
- Mini-Reflect fallback for skipped tasks: quick reflection even when
ArcheFlow doesn't activate (non-trivial single-file changes)
2026-04-03 06:08:01 +02:00
d08dc657d1
feat: core improvements — feedback loop, attention filters, shadow heuristics, metrics, auto-activation
...
- Cross-cycle feedback protocol with structured finding format, routing, and resolution tracking
- Attention filter enforcement: explicit context include/exclude per archetype
- Shadow detection: quantitative checklists with concrete thresholds
- Orchestration metrics: per-phase timing, agent count, findings summary
- Autonomous mode wiring: checkpoint protocol, session log, stop conditions
- Auto-activation: SessionStart hook fires ArcheFlow for implementation tasks without user config
- Emoji avatars for all 7 archetypes
- Standardized finding format across all reviewers for cross-cycle tracking
- Persisted implementation plan in docs/
2026-04-03 06:02:10 +02:00
ebe943a67e
refactor: realistic shadows for Claude behavior
...
- Creator: Perfectionist → Over-Architect (Claude over-designs, doesn't endlessly revise)
- Maker: Cowboy → Rogue (same behavior, better name)
- Trickster: Saboteur → False Alarm (Claude floods with noise, doesn't sabotage)
2026-04-02 18:50:40 +00:00
60cdedeec1
chore: remove memory skill — duplicates native Claude Code CLAUDE.md and MEMORY.md
2026-04-02 18:38:29 +00:00
cccaf86995
refactor: replace 3-Sets diagnostic with focused attention filters and memory
...
The 3-Sets framework doesn't transfer well to agents — all three
dimensions are fully visible and controllable config, not hidden
human psychology. Removed the branding, kept the practical bits:
- attention-filters: what context each archetype receives (token savings)
- memory: persistent learnings across orchestrations (project knowledge)
2026-04-02 18:36:10 +00:00
ed821097de
feat: add 3-Sets agent diagnostic and attention filters
...
New skill: agent-diagnostic — applies the 3-Sets framework
(Tool-Set, Skill-Set, Mind-Set) to agent orchestration:
- Pre-orchestration diagnostic: check each agent's configuration
across three dimensions, fix the weakest set first
- Chain principle: weakest set caps output (Opus + bad prompt = waste)
- Alignment principle: modest aligned agents beat excellent misaligned ones
- Attention filters: each archetype reads only relevant artifacts
- Post-orchestration learning: extract learnings to persistent memory
structured by the three sets
Based on the 3-Sets Method diagnostic framework.
2026-04-02 18:32:18 +00:00
f7f3c84b41
refactor: trim phase skills to reduce token waste
...
- check-phase: 831 → 204 words (remove protocol duplication with agents)
- plan-phase: 521 → 143 words (keep output formats, drop behavioral text)
- do-phase: 408 → 113 words (keep output format + critical commit rule)
- Total plugin: 9830 → 8269 words (~2000 tokens saved)
2026-04-02 18:24:50 +00:00
87183fc2a4
refactor: one shadow per archetype, trim bootstrap skill
...
- Consolidate to single shadow per archetype (fold best bits from
dropped shadows into the remaining one)
- Trim bootstrap skill from 515 to 254 words (~50% token reduction)
- Remove redundant shadow table from bootstrap (already in archetype table)
2026-04-02 18:22:58 +00:00
5cc3d67718
feat: add virtues and second shadows to all archetypes
...
Each archetype now has the full Jungian triad:
- Virtue: the unique contribution (what makes it worth including)
- Shadow 1: primary dysfunction (strength pushed too far)
- Shadow 2: complementary dysfunction (different failure mode)
Virtues: Contextual Clarity, Decisive Framing, Execution Discipline,
Threat Intuition, Assumption Surfacing, Adversarial Creativity,
Maintainability Judgment.
New shadows: Catalog Fetish, Over-Architect, Scope Creep, Gatekeeper,
Whataboutist, Scope Escape, Philosopher.
2026-04-02 18:18:29 +00:00
21becd8b58
chore: remove ArcheHelix branding, use plain PDCA language
...
The archetypes and shadows are distinctive enough — no need for
a fancy name on top of the standard PDCA cycle terminology.
2026-04-02 18:09:28 +00:00
a6fa708f8b
feat: ArcheFlow — multi-agent orchestration plugin for Claude Code
...
Zero-dependency Claude Code plugin using Jungian archetypes as
behavioral protocols for multi-agent orchestration.
- 7 archetypes (Explorer, Creator, Maker, Guardian, Skeptic, Trickster, Sage)
- ArcheHelix: rising PDCA quality spiral with feedback loops
- Shadow detection: automatic dysfunction recognition and correction
- 3 built-in workflows (fast, standard, thorough)
- Autonomous mode: unattended overnight sessions with full visibility
- Custom archetypes and workflows via markdown/YAML
- SessionStart hook for automatic bootstrap
- Examples for feature implementation and security review
2026-04-02 16:37:44 +00:00
