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.

Get Virtual Board CLI View on GitHub
Template · v0.4.0 Claude Code Plugin Zero Dependencies AI Ready Markdown First

IDE Integration

VirtualBoard integrates seamlessly with multiple AI-powered development tools. Choose your IDE below to get started:

Claude Code Plugin

VirtualBoard is available as a Claude Code plugin! Install it directly to get instant access to 10 specialized AI agent roles and 30+ commands.

claude plugin marketplace add virtualboard/template-base
claude plugin install virtualboard

10 Specialized Agent Roles

  • Project Manager
  • System Architect
  • Backend/Frontend/Fullstack Developer
  • QA Engineer
  • DevOps Engineer
  • Security Engineer
  • Data Engineer
  • UX/Product Designer

30+ Agent Commands

  • GPP - Project Progress Report
  • GBG - Backlog Grooming
  • GAD - Architecture Diagram
  • GAE - API Endpoint
  • GC - Component Generation
  • GTP - Test Plan
  • And 23+ more specialized commands!
Plugin Benefits: Automatic updates, built-in validation, and seamless integration with Claude Code's agent system.

/work-on Skill

The plugin includes a /work-on skill for working on features in isolated git worktrees:

/work-on FTR-0042 # Interactive mode
/work-on FTR-0042 --autonomous # Autonomous mode
/work-on FTR-0042 --base-branch dev # Branch from dev
/work-on FTR-0042 --create-pr # Create PR after push

Features

  • Creates git worktree with feature branch
  • Detects and resumes existing work
  • Configurable base branch
  • Automatic commit footer

Configuration

  • VIRTUALBOARD_WORKTREE_PATH
  • VIRTUALBOARD_BASE_BRANCH
  • VIRTUALBOARD_POST_PUSH
  • VIRTUALBOARD_SESSION_MODE

Cursor IDE Integration

VirtualBoard includes a .cursor/rules/virtualboard.mdc file that enables automatic integration with Cursor IDE.

Project-Level Installation

Copy the .cursor folder to your project root to enable VirtualBoard for that specific project:

cp -r .cursor /path/to/your/project/

Recommended for: Single project or project-specific customizations

Global Installation

Add the VirtualBoard rule globally in Cursor Settings:

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Navigate to "Cursor Settings" → "Rules for AI"
  3. Click "Edit in settings.json"
  4. Add the VirtualBoard rule configuration

Recommended for: Using VirtualBoard across all your projects

Note: Project-level rules (.cursor/rules/) take precedence over global rules.

OpenCode Integration

VirtualBoard agents can be easily integrated into OpenCode, an open source AI coding tool.

One-Time Setup

Copy the VirtualBoard agent files to OpenCode's agent directory:

mkdir -p .opencode/agent && cp -Rf .virtualboard/agents .opencode/agent

Activate the Agents

Restart your OpenCode session to load the agents.

What Gets Copied:
  • All agent role definitions (agents/*.md)
  • Agent command system (prompts/agents/)
  • Shared rules of engagement (agents/RULES.md)

Using the Agents

Once reloaded, all VirtualBoard agents (PM, Architect, Frontend Dev, Backend Dev, QA, etc.) will be available in OpenCode.

Benefits

  • Native agent integration
  • Quick access to specialized commands
  • Consistent agent behavior
  • No additional configuration

Available Agents

  • All 10 specialized roles
  • 30+ agent commands
  • Feature lifecycle management
  • Automated validation

What is this Template?

Complete Implementation

This is a template repository that provides a complete implementation of the VirtualBoard Feature Spec Workflow system. It's designed to be used with the Virtual Board CLI to initialize new projects with a standardized feature management workflow.

Key Benefits

  • Zero dependencies - pure bash scripts
  • Universal compatibility across Unix systems
  • AI agent collaboration ready
  • Markdown-first approach
  • Automated validation and indexing
  • Built-in code quality tools and pre-commit hooks

System Specification Templates

The templates/specs/ directory ships with eight reusable blueprints so every project can document foundational architecture decisions. Copy templates to your project's specs/ directory before stories start moving.

Architecture & Delivery

  • Tech Stack: Languages, runtimes, frameworks, third-parties.
  • Hosting & Infrastructure: Cloud/on-prem topology, networking, DR.
  • CI/CD Pipeline: Build/test/deploy stages, gates, approvals.
  • Observability & Incident Response: Telemetry coverage, alerting, playbooks.

Data & Safety

  • Local Development: Toolchain requirements, secrets, seeding, troubleshooting.
  • Database Schema: Entity catalog, migrations, lifecycle & retention.
  • Caching & Performance: Cache layers, SLIs/SLOs, invalidation strategy.
  • Security & Compliance: Threat model, controls, audit requirements.

Each template carries validated frontmatter (schemas/system-spec.schema.json) so vb validate and ./scripts/ftr-validate.sh enforce metadata just like feature specs.

Explore the detailed specs catalog →