Twelve operational beo skills plus a shared reference corpus for structured, contract-driven feature development. Uses br (beads_rust) for issue tracking and bv (Beads Viewer) for graph analytics. Pure Markdown skill definitions -- no application code.
flowchart LR
bootstrap[beo-onboard] -.->|onboarding gate| router[beo-route]
router --> exploring[beo-explore]
exploring --> planning[beo-plan]
planning --> validating[beo-validate]
validating -->|approve current phase| swarming[beo-swarm]
validating -->|single worker| executing[beo-execute]
swarming --> executing
executing -->|final execution scope complete| reviewing[beo-review]
executing -. later phases remain .-> planning
reviewing --> compounding[beo-compound]
executing -. blocker / failure .-> debugging[beo-debug]
debugging -. fix / retry .-> executing
compounding --> critical[.beads/critical-patterns.md]
critical -. read by future planning .-> planning
compounding --> learnings[.beads/learnings/*.md]
dream[beo-dream] -. periodic consolidation .-> learnings
| Skill | Purpose |
|---|---|
| beo-route | Resolves canonical beo state and selects exactly one next target |
| beo-explore | Locks product requirements into CONTEXT.md before solution design |
| beo-plan | Converts locked context into current-phase technical design and executable beads |
| beo-validate | Gates current-phase execution readiness and selects beo-execute or beo-swarm |
| beo-swarm | Coordinates parallel workers for approved, independent beads |
| beo-execute | Implements and verifies exactly one approved bead |
| beo-review | Assesses completed current-phase work and issues accept, fix, or reject |
| beo-compound | Captures durable learnings from one accepted feature |
Support skills (invoked on demand): beo-debug (single-blocker diagnosis and minimal unblock), beo-dream (cross-feature learning consolidation), beo-author (skill-system authoring and pressure testing).
Bootstrap: beo-onboard -- readiness gate that verifies beo tooling and bootstrap state before any other skill proceeds.
Shared reference: beo-reference -- canonical shared protocol docs, CLI refs, status mapping, approval gates, and artifact rules.
| Tool | Required | Install |
|---|---|---|
br 0.1.28+ |
Yes | cargo install beads_rust |
bv 0.15.2+ |
Yes | See bv docs |
obsidian CLI |
No | Optional knowledge store mirror |
qmd |
No | Optional search enhancement |
The host environment needs shell execution, filesystem access, and skill/instruction loading. Subagent dispatch is recommended for planning and review. Swarming requires Agent Mail; without it, work falls back to sequential beo-execute.
npx skills add https://github.com/minhtri2710/skills/tree/main/skills/beoVerify: br --version (0.1.28+), bv --version (0.15.2+).
Or load skills manually by reading skills/beo/route/SKILL.md as the entry point.
- All
br/bvcommands must match CLI help output exactly - Child beads use dotted IDs:
<parent-id>.<number> - Use
br label add/remove <ID> -l <label>for label operations - Always include
--no-daemononbr comments add - Artifact end markers use underscores:
---END_ARTIFACT--- - Status mapping must match the shared reference documents
MIT with Commons Clause -- Copyright (c) 2026 minhtri2710