prototype-feature

Generate competing feature skeletons from an approved OpenSpec change.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/jankneumann/agentic-assistant --skill prototype-feature
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prototype-feature
Source: https://github.com/jankneumann/agentic-assistant/tree/main/.agents/skills/prototype-feature
Command: npx skills add https://github.com/jankneumann/agentic-assistant --skill prototype-feature

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Prototype-feature turns an approved OpenSpec proposal into multiple competing working skeletons, then drives a structured convergence using lightweight validation and human selection instead of expensive full implementations.

Core Features & Use Cases

  • Parallel variant dispatch: Runs N angle-steered variant agents (default 3) against the approved proposal using isolated worktrees and branches to prevent cross-contamination.
  • Cheap multi-phase scoring: Applies existing validation phases (smoke + spec) to each skeleton and records outcomes as data, not hard-fail exceptions.
  • Human pick-and-choose feedback: Lets operators select per-aspect winners (data model, API, tests, layout) so iteration can synthesize a best-combination plan.
  • Convergence handoff artifact: Writes a single prototype-findings.md file containing human picks plus per-variant machine-readable JSON for /iterate-on-plan.

Quick Start

Invoke the skill for an approved change id by running prototype-feature with the operator-approved change-id, optionally overriding angles and variant count to generate competing skeletons and produce prototype-findings.md for convergence.

Frequently Asked Questions about prototype-feature

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

FAQPage Schema
How do I generate competing prototypes from an approved OpenSpec change?▼

To generate competing prototypes from an OpenSpec change, the skill dispatches N parallel variant agents using isolated git worktrees. It creates multiple working feature skeletons steered by distinct angle prompts to prevent cross-contamination.

How does parallel prototyping handle validation and scoring?▼

Parallel prototyping applies cheap multi-phase validation scoring by running smoke and spec tests against each skeleton. Validation outcomes are recorded as data rather than hard-fail exceptions, allowing objective comparison between variants.

Can I use human feedback to converge multiple prototype variants into one plan?▼

Yes, you can converge prototype variants through human pick-and-choose feedback by selecting per-aspect winners like data model, API, and tests. The skill synthesizes your selections into a best-combination convergence plan.

What is the best way to structure prototype findings for iteration handoff?▼

The best way to structure prototype findings for iteration handoff is writing a single prototype-findings.md file. This file persists human picks alongside VariantDescriptor-compatible JSON for downstream convergence processing.

Do I need git worktrees to run parallel prototype divergence?▼

Yes, you need git worktrees to run parallel prototype divergence because they provide isolated branches for each variant agent. This isolation prevents cross-contamination between competing feature skeletons during generation.

What are the limitations of using automated variant synthesis for feature prototyping?▼

A limitation of automated variant synthesis is that it requires strict input validation for variant and angle counts. Additionally, vendor-diversity assignment is only best-effort, and full implementations are deferred until human convergence is complete.