vc-predict

Runs five expert personas to debate proposed changes and produce a risk verdict before implementation.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/HyuseCS/project-c --skill vc-predict-hyusecs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-predict
Source: https://github.com/HyuseCS/project-c/tree/main/.claude/skills/vc-predict
Command: npx skills add https://github.com/HyuseCS/project-c --skill vc-predict-hyusecs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It catches architectural, security, performance, and UX problems in a proposed change before any code is written, preventing costly rework from flawed designs. ## Core Features & Use Cases - Multi-Persona Debate: Five personas (Architect, Security, Performance, UX, Devil's Advocate) independently analyze a proposal, then reconcile conflicts into a GO, CAUTION, or STOP verdict. - Simple and Deep Modes: Deep mode spawns a research subagent that scans git history, prior phase reports, and test failure logs so personas can cite concrete past failures. - Structured Risk Report: Outputs agreements, conflict resolutions, a severity-ranked risk table, and actionable recommendations. - Use Case: Before migrating authentication from JWT to session cookies, run the skill to surface session-fixation risks, latency impacts, and a simpler alternative you had not considered. ## Quick Start Ask the AI to run vc-predict on your proposed feature, for example: predict the risks of adding WebSocket support for real-time notifications.

Frequently Asked Questions about vc-predict

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

FAQPage Schema
How do I review a proposed feature for risks before writing code?

Run vc-predict with a description of the proposed change. Five personas covering architecture, security, performance, UX, and hidden assumptions analyze it independently, then debate conflicts and return a GO, CAUTION, or STOP verdict with mitigations.

What is the difference between simple and deep mode in vc-predict?

Simple mode reasons from the proposal description alone. Deep mode first spawns a research subagent that scans git log, prior phase reports, and test failure history, so personas can reference concrete past attempts and known landmines.

When should I use deep mode for pre-implementation analysis?

Use deep mode when the approach touches surfaces with failure history such as auth, billing, container lifecycle, or streaming, when a similar pattern was attempted before, or when the plan is complex. It also triggers via the --deep flag.

When should I not use multi-persona prediction?

Skip it for trivial or low-risk changes, already-approved work with no open design questions, and pure dependency upgrades without API changes. Use a debugger skill for bugs and a planning skill for already-decided tasks.

What triggers a STOP verdict in a prediction report?

A STOP verdict occurs when security finds an unmitigable auth bypass or data exposure, the architect finds a fundamental design incompatibility, performance finds unacceptable latency with no workaround, or a false assumption invalidates the entire approach.