vapa-design

Decompose GitHub issue requirements into actionable design items.

1|1|Updated May 8, 2026
One-click install
npx skills add https://github.com/insentek/VAPA --skill vapa-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vapa-design
Source: https://github.com/insentek/VAPA/tree/main/skills/vapa-design
Command: npx skills add https://github.com/insentek/VAPA --skill vapa-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the ambiguity in AI-driven development by forcing a structured, interactive design phase before implementation begins, ensuring that technical decisions are documented and agreed upon.

Core Features & Use Cases

  • Interactive Design: Guides the user through a checklist of design items including data models, API contracts, and frontend flows.
  • Traceable Records: Automatically archives design decisions and posts them as confirmed issue comments for team visibility.
  • Use Case: When a new feature proposal is submitted, use this skill to walk through the database schema and API requirements with the AI, ensuring the final design is recorded as a contract before any code is written.

Quick Start

Use the vapa-design skill to design the solution for the GitHub issue numbered 15 in the current repository.

Frequently Asked Questions about vapa-design

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

FAQPage Schema
How do I design a technical solution for a GitHub issue before writing code?

To design a technical solution for a GitHub issue, you can use an interactive workflow to decompose requirements into actionable design items like data models and API contracts. This ensures technical decisions are documented and agreed upon before implementation begins.

What is the best way to document architecture decisions for new feature proposals?

Documenting architecture decisions for feature proposals is best handled by archiving them as confirmed issue comments. This provides team visibility and establishes a clear contract between strategic goals and technical implementation directly within the repository.

Do I need GitHub CLI to design VAPA proposals interactively?

Yes, you need GitHub CLI to design VAPA proposals interactively. It is required for issue interaction and local workspace management to maintain a persistent record of confirmed design decisions throughout the collaborative architecture process.

How does an interactive design workflow handle API contracts and data models?

An interactive design workflow handles API contracts and data models by guiding users through a structured checklist of design items. This ensures frontend flows and backend requirements are fully decomposed and aligned with repository-specific vision documents.

Can I align technical implementation with strategic goals using repository vision documents?

Yes, you can align technical implementation with strategic goals using repository vision documents. The design process operates within the context of these documents and GitHub issues to ensure the final architecture matches the project's strategic direction.