Core Features
Everything you need for deterministic AI-human collaboration
Workflow Management
Folder-based lifecycle with built-in safety and validation
Lifecycle Management
Clear state transitions: backlog, in-progress, blocked, review, done. Folder location is the source of truth.
Multi-Agent Safety
Built-in concurrency controls with ownership locks and collision prevention.
Validation & Indexing
Automated validation rules and index generation for Markdown, JSON, and HTML.
Pre-commit Hooks
YAML validation, JSON formatting, spell checking, and file integrity checks.
Markdown Linting
Python-based markdown linting with PyMarkdown for consistent formatting.
CI/CD Ready
GitHub Actions workflows with validation rules and automated indexing.
Concurrency & Safety
Built-in locking mechanisms ensure multiple agents can work safely without conflicts
Soft Lock via Owner
Only the current owner may edit a spec outside of trivial fixes.
Hard Lock with TTL
Optional hard locks with time-to-live prevent stale ownership.
Collision Detection
Agents detect conflicts and abort with clear handoff procedures.
Project Structure
Simple, intuitive folder-based organization
my-project/ ├── features/ # Feature specifications │ ├── backlog/ # Unassigned features │ ├── in-progress/ # Features being worked on │ ├── blocked/ # Features waiting on dependencies │ ├── review/ # Features ready for review │ ├── done/ # Completed features │ └── INDEX.md # Auto-generated feature index ├── templates/ # Templates and configuration │ ├── feature.md # Feature spec template │ ├── pr-template.md # Pull request template │ └── rules.yml # Agent rules configuration ├── schemas/ # Validation schemas │ └── frontmatter.schema.json ├── agents/ # Agent documentation │ ├── pm.md # Project manager prompt │ ├── architect.md # System architect prompt │ ├── backend_dev.md # Backend engineer prompt │ └── frontend_dev.md # Frontend engineer prompt ├── skills/ # Claude Code skills │ └── work-on/ # /work-on feature dev skill ├── scripts/ # Automation scripts │ ├── install-vb-cli.sh # CLI installer │ └── worktree-setup.sh # Worktree management └── .pre-commit-config.yaml # Pre-commit hooks
Frontmatter Schema
Structured metadata for every feature specification