vv-tools

VV AI Tools

A Claude Code plugin marketplace providing the vv plugin - a structured development workflow toolkit that guides projects through analysis, architecture, development, and review phases.

Overview

The vv plugin implements a role-based development methodology where each phase of software development is handled by a specialized AI persona with focused responsibilities. This ensures thorough requirements gathering, thoughtful design, disciplined implementation, and rigorous code review.

Installation

This plugin is designed for use with Claude Code.

To install locally:

1. Clone this repository
2. The plugin is automatically available when working in this directory (configured in .claude/settings.local.json)

The VV Workflow

The plugin provides four skills that implement a complete development lifecycle:

1. Analyze (/vv:analyze)

Role: Business Analyst

Creates a system prompt for gathering requirements, constraints, and goals. The analyst researches the problem space, asks clarifying questions, and ensures stakeholders understand what they're building.

Output: REQUIREMENTS.md - A comprehensive requirements document

2. Architect (/vv:architect)

Role: Solutions Architect

Reads the requirements and designs the solution. Engages with stakeholders to refine the architecture and create a detailed implementation plan.

Input: REQUIREMENTS.md Output: SPEC.md - Technical specification and implementation plan

3. Develop (/vv:develop)

Role: Developer

Implements the solution following the specification using disciplined engineering practices:

• Test-driven development (TDD)
• Small, incremental changes
• Feature branches for isolation
• Code comments for clarity
• Integration with OpenSpec for tracking

Input: SPEC.md Workflow: Feature branches, TDD, documented code

4. Review (/vv:review)

Role: Code Reviewer

Reviews changes before merging to main, evaluating:

• Potential bugs and edge cases
• Security concerns
• Performance issues
• Code readability

Input: Branch changes + SPEC.md Output: COMMENTS.md - Actionable review feedback

Usage

Each skill generates a system prompt for its role. Invoke them using the /vv: prefix:

/vv:analyze    # Start with requirements gathering
/vv:architect  # Design the solution
/vv:develop    # Implement the feature
/vv:review     # Review the code

Development Artifacts

The workflow produces structured documentation at each phase:

• REQUIREMENTS.md - What needs to be built and why
• SPEC.md - How it will be built
• COMMENTS.md - What needs to be improved

These artifacts create a paper trail for decisions and ensure continuity across development phases.

Extending the Plugin

To add new skills:

1. Create a directory under plugins/vv/skills/{skill-name}/
2. Add a SKILL.md file with:

   ---
   description: Brief description of the skill
   disable-model-invocation: true
   ---
   
   [Prompt generation instructions here]
   

3. The skill becomes immediately available

Repository Structure

.claude-plugin/
  marketplace.json          # Marketplace configuration
plugins/
  vv/
    .claude-plugin/
      plugin.json           # Plugin metadata
    skills/
      analyze/SKILL.md      # BA prompt generator
      architect/SKILL.md    # Architect prompt generator
      develop/SKILL.md      # Developer prompt generator
      review/SKILL.md       # Reviewer prompt generator

Philosophy

This plugin embodies the principle that software development benefits from distinct phases and specialized perspectives. By separating analysis, design, implementation, and review into explicit roles, it encourages:

• Thorough thinking at each stage
• Documentation of decisions
• Accountability through reviews
• Quality through discipline

License

MIT

Author

Vlad Dumitrescu