feat: corrective action framework + CLAUDE.md rewrite + v0.8.0 cleanup
- Extend shadow-detection with 3-layer corrective action framework: archetype shadows, system shadows (tunnel vision, echo chamber, etc.), and policy boundaries (checkpoints, budget gates, circuit breakers) - Rewrite CLAUDE.md with proper guardrails (DO/DO NOT, skill writing rules, 200-line max per skill, no bash pseudo-code in skills) - Update plugin.json to v0.8.0 with consolidated 19-skill list - Update README architecture tree and skills reference - Update using-archeflow version string to v0.8.0 / 19 skills - Remove 8 empty skill directories (absorbed into run skill)
This commit is contained in:
87
README.md
87
README.md
@@ -146,60 +146,51 @@ Shadow detection is quantitative, not vibes. Explorer output exceeding 2000 word
|
||||
|
||||
## Skills Reference
|
||||
|
||||
ArcheFlow ships with 24 skills organized by function.
|
||||
ArcheFlow ships with 19 skills organized by function. The `run` skill is self-contained -- no prerequisites needed.
|
||||
|
||||
### Core Orchestration
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:run` | Automated PDCA execution loop -- single-command orchestration with `--start-from`, `--dry-run`, and cycle-back |
|
||||
| `archeflow:orchestration` | Step-by-step PDCA execution guide for manual orchestration |
|
||||
| `archeflow:plan-phase` | Explorer and Creator output formats and protocols |
|
||||
| `archeflow:do-phase` | Maker implementation rules and worktree commit strategy |
|
||||
| `archeflow:check-phase` | Shared reviewer protocols and output format |
|
||||
| `archeflow:act-phase` | Post-Check decision logic: collect findings, route fixes, exit or cycle |
|
||||
| `archeflow:run` | Self-contained PDCA orchestration -- Plan/Do/Check/Act with adaptation rules, pipeline strategy, and cycle-back |
|
||||
| `archeflow:sprint` | Queue-driven parallel agent dispatch across projects (primary mode) |
|
||||
| `archeflow:review` | Guardian-led code review on diff/branch/commit range |
|
||||
| `archeflow:check-phase` | Shared reviewer protocol -- finding format, evidence requirements, attention filters |
|
||||
| `archeflow:act-phase` | Finding collection, fix routing, exit decisions |
|
||||
|
||||
### Quality and Safety
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:shadow-detection` | Quantitative dysfunction detection and automatic correction |
|
||||
| `archeflow:convergence` | Detects convergence, stalling, and oscillation in multi-cycle runs |
|
||||
| `archeflow:artifact-routing` | Inter-phase artifact protocol -- naming, storage, routing, archiving |
|
||||
|
||||
### Process Intelligence
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:process-log` | Event-sourced JSONL logging with DAG parent relationships |
|
||||
| `archeflow:shadow-detection` | Corrective action framework -- archetype shadows, system shadows, policy boundaries |
|
||||
| `archeflow:memory` | Cross-run memory that learns recurring findings and injects lessons |
|
||||
| `archeflow:effectiveness` | Archetype scoring on signal-to-noise, fix rate, cost efficiency |
|
||||
| `archeflow:progress` | Live progress file watchable from a second terminal |
|
||||
|
||||
### Integration
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:colette-bridge` | Bridges ArcheFlow with the Colette writing platform |
|
||||
| `archeflow:git-integration` | Git-per-phase commits, branch-per-run, rollback to any phase boundary |
|
||||
| `archeflow:git-integration` | Per-phase commits, branch-per-run, rollback |
|
||||
| `archeflow:multi-project` | Cross-repo orchestration with dependency DAG and shared budget |
|
||||
| `archeflow:cost-tracking` | Budget enforcement, per-agent cost aggregation, model tier recommendations |
|
||||
|
||||
### Configuration
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:domains` | Domain adapters for writing, research, and non-code workflows |
|
||||
| `archeflow:custom-archetypes` | Create domain-specific roles (database reviewer, compliance auditor, etc.) |
|
||||
| `archeflow:workflow-design` | Design custom workflows with per-phase archetype assignment and exit conditions |
|
||||
| `archeflow:domains` | Domain adapters for writing, research, and other non-code workflows |
|
||||
| `archeflow:cost-tracking` | Budget enforcement, per-agent cost aggregation, model tier recommendations |
|
||||
| `archeflow:workflow-design` | Design custom workflows with per-phase archetype assignment |
|
||||
| `archeflow:templates` | Template gallery for sharing workflows, teams, and setup bundles |
|
||||
| `archeflow:autonomous-mode` | Unattended overnight sessions with progress logging and safe stopping |
|
||||
| `archeflow:autonomous-mode` | Unattended sessions with corrective action checkpoints |
|
||||
| `archeflow:progress` | Live progress file watchable from a second terminal |
|
||||
| `archeflow:presence` | User-facing output format -- show outcomes, not mechanics |
|
||||
|
||||
### Meta
|
||||
|
||||
| Skill | Description |
|
||||
|-------|-------------|
|
||||
| `archeflow:using-archeflow` | Session-start skill -- activation criteria, workflow selection, quick reference |
|
||||
| `archeflow:using-archeflow` | Session-start activation -- decision tree, workflow selection, commands |
|
||||
|
||||
## Library Scripts
|
||||
|
||||
@@ -340,46 +331,28 @@ archetypes: [explorer, creator, maker, guardian, db-specialist]
|
||||
|
||||
```
|
||||
archeflow/
|
||||
├── .claude-plugin/plugin.json # Plugin manifest (v0.5.0)
|
||||
├── .claude-plugin/plugin.json # Plugin manifest
|
||||
├── agents/ # 7 archetype personas (behavioral protocols)
|
||||
│ ├── explorer.md # Plan: research and context mapping
|
||||
│ ├── creator.md # Plan: solution design and proposals
|
||||
│ ├── maker.md # Do: implementation in isolated worktree
|
||||
│ ├── guardian.md # Check: security and reliability review
|
||||
│ ├── skeptic.md # Check: assumption challenging
|
||||
│ ├── trickster.md # Check: adversarial testing
|
||||
│ └── sage.md # Check: holistic quality review
|
||||
├── skills/ # 24 behavioral skills
|
||||
│ ├── run/ # Automated PDCA loop
|
||||
│ ├── orchestration/ # Manual PDCA execution guide
|
||||
│ ├── plan-phase/ # Plan protocols
|
||||
│ ├── do-phase/ # Do protocols
|
||||
│ ├── check-phase/ # Check protocols
|
||||
│ ├── act-phase/ # Act phase decision logic
|
||||
│ ├── shadow-detection/ # Dysfunction detection
|
||||
│ ├── convergence/ # Cycle convergence detection
|
||||
│ ├── artifact-routing/ # Inter-phase artifact protocol
|
||||
│ ├── process-log/ # Event-sourced JSONL logging
|
||||
│ ├── explorer.md, creator.md # Plan phase agents
|
||||
│ ├── maker.md # Do phase agent
|
||||
│ └── guardian.md, skeptic.md, # Check phase agents
|
||||
│ trickster.md, sage.md
|
||||
├── skills/ # 19 skills (consolidated from 27)
|
||||
│ ├── run/ # Self-contained PDCA orchestration (core)
|
||||
│ ├── sprint/ # Queue-driven parallel agent dispatch
|
||||
│ ├── review/ # Guardian-led code review
|
||||
│ ├── check-phase/ # Shared reviewer protocol + attention filters
|
||||
│ ├── act-phase/ # Finding collection + fix routing
|
||||
│ ├── shadow-detection/ # Corrective action framework (3 layers)
|
||||
│ ├── memory/ # Cross-run learning
|
||||
│ ├── effectiveness/ # Archetype scoring
|
||||
│ ├── progress/ # Live progress file
|
||||
│ ├── colette-bridge/ # Colette writing platform bridge
|
||||
│ ├── git-integration/ # Per-phase git commits
|
||||
│ ├── multi-project/ # Cross-repo orchestration
|
||||
│ ├── custom-archetypes/ # Domain-specific roles
|
||||
│ ├── workflow-design/ # Custom workflow design
|
||||
│ ├── domains/ # Domain adapters
|
||||
│ ├── cost-tracking/ # Budget and cost management
|
||||
│ ├── templates/ # Template gallery
|
||||
│ ├── autonomous-mode/ # Unattended sessions
|
||||
│ └── using-archeflow/ # Session-start activation
|
||||
├── lib/ # 8 shell scripts (process infrastructure)
|
||||
│ └── ... # + 12 config/integration skills
|
||||
├── lib/ # 10 shell scripts (events, git, memory, etc.)
|
||||
├── hooks/ # Auto-activation (SessionStart)
|
||||
├── examples/ # Walkthroughs, templates, custom archetypes
|
||||
└── docs/ # Roadmap, changelog
|
||||
```
|
||||
|
||||
The flow: skills define behavioral rules (what agents should do), agents define personas (how they think), lib scripts handle tooling (event logging, git, reporting), and hooks wire it all together at session start. Events are emitted at every phase transition, forming a DAG that can be rendered, reported, or scored after the run.
|
||||
Skills define behavioral rules, agents define personas, lib scripts handle tooling, hooks wire it together at session start. The `run` skill is self-contained -- it absorbed 8 previously separate skills (orchestration, plan-phase, do-phase, artifact-routing, process-log, convergence, effectiveness, attention-filters) into one 459-line operational guide.
|
||||
|
||||
## Philosophy
|
||||
|
||||
|
||||
Reference in New Issue
Block a user