One-click install
npx skills add https://github.com/osovv/vv-opencode --skill vv-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vv-plan
Source: https://github.com/osovv/vv-opencode/tree/main/templates/skills/vv-plan
Command: npx skills add https://github.com/osovv/vv-opencode --skill vv-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the ambiguity and inconsistency of ad-hoc implementation planning by generating structured, reviewable plan documents directly from approved feature specifications, ensuring every development task aligns exactly to approved requirements.

Core Features & Use Cases

  • Spec-Aligned Plan Generation: Reads approved spec.xml files and optional design-context.xml to produce compliant plan.xml documents with exact file paths, interface contracts, and dependency ordering.
  • Testable Task Definitions: Breaks implementation work into discrete tasks with code snippets in CDATA and specific, testable acceptance criteria for each requirement.
  • Three-Stage Review Support: Enables independent review of requirements, plans, and final code to catch misalignment early in the development workflow.
  • Use Case: For a team that has approved a new payment processing feature spec, use this skill to generate a step-by-step implementation plan with exact interface signatures, test criteria, and task dependencies for the development team to execute.

Quick Start

Use the vv-plan skill to generate an implementation plan for the approved spec located at .vvoc/specs/<id>/spec.xml.

Frequently Asked Questions about vv-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an implementation plan from an approved feature specification?

To generate an implementation plan from an approved feature specification, you input the spec.xml file to produce a compliant plan.xml with defined modules, interface contracts, and task dependencies. This ensures every development task aligns exactly with the approved requirements.

What is spec-driven development planning and how does it handle task decomposition?

Spec-driven development planning transforms approved specifications into structured implementation plans using task decomposition. It breaks implementation work into discrete tasks featuring specific, testable acceptance criteria and code snippets to ensure traceable, contract-level alignment before coding begins.

How do I create testable task definitions with interface contracts for a new development workflow?

You create testable task definitions with interface contracts by processing approved specification documents into structured plans. The system defines exact file paths, interface signatures, and dependency ordering, ensuring each task contains specific acceptance criteria and code snippets for review-driven workflows.

Does this implementation planning approach support three-stage code review workflows?

Yes, this implementation planning approach supports three-stage review workflows by enabling independent review of requirements, plans, and final code. It generates contract-level plans with exact interface signatures and test criteria to catch misalignment early before code implementation begins.

Can I use optional design context to improve contract-first design plan generation?

Yes, you can supply an optional design-context.xml file alongside the approved spec.xml to improve contract-first design plan generation. Reading this optional context helps produce more compliant plan.xml documents with exact file paths and interface contracts.

What are the limitations of using automated task decomposition for spec-driven development?

Automated task decomposition for spec-driven development requires a pre-approved feature specification document as input and cannot generate plans from ad-hoc or unapproved requirements. It is limited to structuring exact file paths, interface contracts, and dependency ordering for review-driven workflows.