virtualboard template
A complete implementation of the VirtualBoard Feature Spec Workflow system. Ready-to-use template with AI agent collaboration, Markdown-first approach, and zero dependencies.
IDE Integration
Works with your tools
Seamless integration with Claude Code, Cursor, and OpenCode
One-Command Install
Use the CLI to install the Claude Code plugin automatically:
# Automated via vb CLI vb install claude-code # Or manually via claude CLI claude plugin add virtualboard/template-base claude plugin install virtualboard
/work-on Skill
Work on features in isolated git worktrees with the built-in skill:
/work-on FTR-0042 /work-on FTR-0042 --autonomous /work-on FTR-0042 --create-pr
One-Command Install
Use the CLI to download and install Cursor rules automatically:
vb install cursor # Downloads .cursor/rules/virtualboard.mdc # Use --force to skip confirmation
Manual Install
Alternatively, copy the .cursor folder to your project root, or add the VirtualBoard rule globally via Cursor Settings > Rules for AI.
cp -r .cursor /path/to/your/project/
One-Command Install
Use the CLI to copy agent files to OpenCode's agent directory:
vb install opencode
Manual Install
Copy agent files manually and restart your session:
mkdir -p .opencode/agent && cp -Rf .virtualboard/agents .opencode/agent
Template Repository
What is this template?
Everything you need to manage features with AI agents
Markdown-First
All specs live in Markdown files with YAML frontmatter. Easy to diff, parse, and index for humans and AI agents alike.
10 Agent Roles
Pre-configured roles for PM, Architect, Frontend, Backend, Fullstack, QA, DevOps, Security, Data, and UX agents.
Validation Built In
JSON Schema validation for frontmatter, workflow rules enforcement, and dependency checking via the vb CLI.
System Spec Templates
Eight reusable blueprints covering tech stack, infrastructure, CI/CD, database, caching, security, and more.
Security Hardened
SHA-256 checksum verification, --allow-sudo flag, gitleaks pre-commit hooks, and untrusted-content delimiters.
Zero Dependencies
Pure Markdown and the single vb binary. No Node.js, no npm, no runtime dependencies required.
Quick Start
Up and running in minutes
Initialize a workspace and start managing features
Install the CLI
Bootstrap with the installer script or download the binary directly:
./scripts/install-vb-cli.sh --ensure-latest
Verifies SHA-256 checksums before installing. Reads .vb-version to pin to a specific release.
Initialize Workspace
Set up the .virtualboard/ directory structure:
vb init
Downloads the template archive. Use vb init --update to interactively diff and update.
Create Features
Scaffold feature specs with labels and frontmatter:
vb new "User Authentication" security auth
Validate and Move
Enforce rules and progress features through the workflow:
vb validate vb move FTR-0001 in-progress --owner alice