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.