Prototyping And Solution Discovery Skill
Use When
- comparing solution candidates or prototypes to reduce uncertainty before locking requirements or design; use UX-specification after the chosen interaction direction is approved.
- Use this procedure when the required source artefacts are available and
Prototype plan, evaluation evidence, and decision record is the next lifecycle deliverable.
Do Not Use When
- Use
ux-specification when that neighbouring route owns the decision or deliverable.
- Do not invent missing project evidence, standards clauses, thresholds, or stakeholder decisions.
Required Inputs
| Artefact |
Source or provider |
Required? |
Behaviour when missing |
| Discovery question, candidate options, constraints, users, risks, and success criteria |
Product owner, users, architecture, and research evidence |
Yes |
Stop the affected step, name the missing source, and return only a qualified gap record. |
Workflow
- Inspect the required inputs and log the exact sources, versions, and unresolved assumptions.
- Apply this skill's existing domain workflow and decision rules to produce
Prototype plan, evaluation evidence, and decision record.
- Stop when a required source, accountable decision owner, or deterministic test oracle is absent.
- Recover by preserving valid work, marking the blocked scope, and returning the narrowest qualified artefact plus the next evidence needed.
Outputs
| Artefact |
Consumer |
Acceptance condition |
| Prototype plan, evaluation evidence, and decision record |
Requirements, product, design, and architecture owners |
Required sections are populated, source links resolve, and every material requirement or decision has an observable review or test oracle. |
Evidence Produced
| Evidence |
Reviewer |
Acceptance condition |
Source, decision, trace, and validation record for Prototype plan, evaluation evidence, and decision record |
Requirements quality reviewer |
Inputs used, decisions made, checks run, failures, and unassessed items are explicit. |
Capability and permission boundaries
Read and search are required. Editing is allowed only when the request authorises creation or repair of the named requirements artefact. Publishing, production mutation, destructive action, spending, and certification require explicit authority.
Degraded mode
Fallback: if a required file, reviewer, standard source, network check, renderer, or execution capability is unavailable, return the narrowest useful qualified result and mark the affected check not assessed; never convert an unassessed check into a pass.
Decision Rules
| Choice or condition |
Action |
Failure or risk avoided |
| A prototype has no falsifiable question or decision threshold |
Rewrite the experiment before building it. |
Prototype theatre with no decision value. |
| Required inputs and test oracles are complete |
Continue through the existing workflow and record evidence. |
A deliverable whose acceptance cannot be reproduced. |
| A mandatory source or owner is missing |
Stop the affected branch and issue a qualified gap record. |
Fabricated context or unauthorised decisions. |
Quality Standards
- Preserve stable identifiers and bidirectional traceability from project evidence to
Prototype plan, evaluation evidence, and decision record and its acceptance checks.
- Apply ISO/IEEE measures only with a named metric, method, threshold, evidence source, and responsible reviewer; run the anti-slop gate before release.
Anti-Patterns
- Producing
Prototype plan, evaluation evidence, and decision record from assumed context. Fix: cite the project source or mark the scope blocked.
- Accepting a material requirement without a deterministic oracle. Fix: add a measurable result, boundary, and verification method.
- Crossing into
ux-specification without routing the decision. Fix: hand off the named input and preserve trace links.
- Treating an unavailable check as passed. Fix: mark it
not assessed and state the release consequence.
- Claiming standards, statutory, or stakeholder approval without evidence. Fix: cite the source and reviewer or qualify the claim.
References
Evidence escalation and AI-assisted discovery
Choose the cheapest prototype that can answer the uncertainty, but escalate
evidence with risk: problem/market and alternative review, user research or
observation, concept/landing test, click-through flow, workflow/concierge
simulation, technical spike, and (where justified) a pilot or real commitment.
For each stage record the hypothesis, target users, observable behaviour,
threshold, guardrail, time box, decision, and remaining unknowns. A prototype,
portfolio example, or stakeholder enthusiasm is not evidence of approval or
product-market fit.
If AI assists research, synthesis, requirements, or prototyping, preserve the
source context, ask it to surface questions/options before generating, verify
summaries and competitor claims against originals, keep a decision log, and
review scoped deltas rather than accepting broad regeneration. Human owners
retain product, requirements, accessibility, and release judgement.
Practitioner cross-checks: Eleken product-idea validation, AI design workflow; corroborating practice: GOV.UK making prototypes.
Overview
This skill creates structured candidate solutions and prototype-driven learning before the project commits to a detailed design. It supports sacrificial prototypes, ready-made solution evaluation, comparison matrices, and explicit learning loops so the engine reduces requirement and design risk early.
When to Use
- When the solution space is still open or disputed
- When user workflows are hard to understand without concrete examples
- When ready-made products or platform choices must be compared
- When high-risk assumptions need to be tested before baselining requirements
Quick Reference
| Attribute |
Value |
| Inputs |
projects/<ProjectName>/_context/vision.md, projects/<ProjectName>/_context/features.md, projects/<ProjectName>/<phase>/<document>/stakeholder_register.md (recommended), projects/<ProjectName>/<phase>/<document>/requirements_analysis_report.md (optional) |
| Output |
projects/<ProjectName>/<phase>/<document>/solution_discovery_report.md |
| Tone |
Exploratory but disciplined, evidence-seeking |
| Standards |
Volere discovery and prototype-driven requirements practices |
Core Instructions
Step 1: Define the Uncertainty
State:
- the problem being explored
- the assumptions most likely to be wrong
- the decision that the prototype or comparison must support
Step 2: Generate Multiple Candidates
Produce at least three candidate solution directions when feasible:
- build custom
- configure or buy
- hybrid or phased option
For each candidate, define intended benefits, risks, and major constraints.
Step 3: Define Prototype Strategy
Choose the smallest prototype type that can answer the question:
- paper or wireframe
- click-through UX
- workflow simulation
- proof-of-concept integration
- technical spike
Step 4: Compare Candidates
Evaluate candidates against:
- business fit
- user fit
- technical feasibility
- implementation cost
- operational impact
- compliance or security risk
Step 5: Record Learnings
For each prototype or experiment, document:
- hypothesis
- what was tested
- stakeholders involved
- findings
- decision impact
- follow-up work
Step 6: Write Output
Write projects/<ProjectName>/<phase>/<document>/solution_discovery_report.md including candidates, prototype strategy, evaluation matrix, learnings, and recommendation.
Common Pitfalls
- Treating a prototype as implicit approval for production implementation
- Testing visuals while leaving workflow or policy risks untouched
- Comparing options without agreed evaluation criteria
- Running discovery without recording what decision it should influence
Verification Checklist
1---2name: 10-prototyping-and-solution-discovery3description: Use when comparing solution candidates or prototypes to reduce uncertainty before locking requirements or design; use UX-specification after the chosen interaction direction is approved.4---56# Prototyping And Solution Discovery Skill78<!-- local-contract-start -->9<!-- dual-compat-start -->10## Use When1112- comparing solution candidates or prototypes to reduce uncertainty before locking requirements or design; use UX-specification after the chosen interaction direction is approved.13- Use this procedure when the required source artefacts are available and `Prototype plan, evaluation evidence, and decision record` is the next lifecycle deliverable.1415## Do Not Use When1617- Use `ux-specification` when that neighbouring route owns the decision or deliverable.18- Do not invent missing project evidence, standards clauses, thresholds, or stakeholder decisions.1920## Required Inputs2122| Artefact | Source or provider | Required? | Behaviour when missing |23| --- | --- | --- | --- |24| Discovery question, candidate options, constraints, users, risks, and success criteria | Product owner, users, architecture, and research evidence | Yes | Stop the affected step, name the missing source, and return only a qualified gap record. |2526## Workflow27281. Inspect the required inputs and log the exact sources, versions, and unresolved assumptions.292. Apply this skill's existing domain workflow and decision rules to produce `Prototype plan, evaluation evidence, and decision record`.303. Stop when a required source, accountable decision owner, or deterministic test oracle is absent.314. Recover by preserving valid work, marking the blocked scope, and returning the narrowest qualified artefact plus the next evidence needed.3233## Outputs3435| Artefact | Consumer | Acceptance condition |36| --- | --- | --- |37| Prototype plan, evaluation evidence, and decision record | Requirements, product, design, and architecture owners | Required sections are populated, source links resolve, and every material requirement or decision has an observable review or test oracle. |3839## Evidence Produced4041| Evidence | Reviewer | Acceptance condition |42| --- | --- | --- |43| Source, decision, trace, and validation record for `Prototype plan, evaluation evidence, and decision record` | Requirements quality reviewer | Inputs used, decisions made, checks run, failures, and unassessed items are explicit. |4445## Capability and permission boundaries4647Read and search are required. Editing is allowed only when the request authorises creation or repair of the named requirements artefact. Publishing, production mutation, destructive action, spending, and certification require explicit authority.4849## Degraded mode5051Fallback: if a required file, reviewer, standard source, network check, renderer, or execution capability is unavailable, return the narrowest useful qualified result and mark the affected check `not assessed`; never convert an unassessed check into a pass.5253## Decision Rules5455| Choice or condition | Action | Failure or risk avoided |56| --- | --- | --- |57| A prototype has no falsifiable question or decision threshold | Rewrite the experiment before building it. | Prototype theatre with no decision value. |58| Required inputs and test oracles are complete | Continue through the existing workflow and record evidence. | A deliverable whose acceptance cannot be reproduced. |59| A mandatory source or owner is missing | Stop the affected branch and issue a qualified gap record. | Fabricated context or unauthorised decisions. |6061## Quality Standards6263- Preserve stable identifiers and bidirectional traceability from project evidence to `Prototype plan, evaluation evidence, and decision record` and its acceptance checks.64- Apply ISO/IEEE measures only with a named metric, method, threshold, evidence source, and responsible reviewer; run the anti-slop gate before release.6566## Anti-Patterns6768- Producing `Prototype plan, evaluation evidence, and decision record` from assumed context. Fix: cite the project source or mark the scope blocked.69- Accepting a material requirement without a deterministic oracle. Fix: add a measurable result, boundary, and verification method.70- Crossing into `ux-specification` without routing the decision. Fix: hand off the named input and preserve trace links.71- Treating an unavailable check as passed. Fix: mark it `not assessed` and state the release consequence.72- Claiming standards, statutory, or stakeholder approval without evidence. Fix: cite the source and reviewer or qualify the claim.7374## References7576- [Skill authoring and release standard](../../../../docs/skill-authoring-standard.md)77## Evidence escalation and AI-assisted discovery7879Choose the cheapest prototype that can answer the uncertainty, but escalate80evidence with risk: problem/market and alternative review, user research or81observation, concept/landing test, click-through flow, workflow/concierge82simulation, technical spike, and (where justified) a pilot or real commitment.83For each stage record the hypothesis, target users, observable behaviour,84threshold, guardrail, time box, decision, and remaining unknowns. A prototype,85portfolio example, or stakeholder enthusiasm is not evidence of approval or86product-market fit.8788If AI assists research, synthesis, requirements, or prototyping, preserve the89source context, ask it to surface questions/options before generating, verify90summaries and competitor claims against originals, keep a decision log, and91review scoped deltas rather than accepting broad regeneration. Human owners92retain product, requirements, accessibility, and release judgement.9394Practitioner cross-checks: [Eleken product-idea validation](https://www.eleken.co/blog-posts/how-to-validate-product-ideas), [AI design workflow](https://www.eleken.co/blog-posts/ai-design-workflow); corroborating practice: [GOV.UK making prototypes](https://www.gov.uk/service-manual/design/making-prototypes).9596<!-- dual-compat-end -->97<!-- local-contract-end -->9899## Overview100101This skill creates structured candidate solutions and prototype-driven learning before the project commits to a detailed design. It supports sacrificial prototypes, ready-made solution evaluation, comparison matrices, and explicit learning loops so the engine reduces requirement and design risk early.102103## When to Use104105- When the solution space is still open or disputed106- When user workflows are hard to understand without concrete examples107- When ready-made products or platform choices must be compared108- When high-risk assumptions need to be tested before baselining requirements109110## Quick Reference111112| Attribute | Value |113|-----------|-------|114| **Inputs** | `projects/<ProjectName>/_context/vision.md`, `projects/<ProjectName>/_context/features.md`, `projects/<ProjectName>/<phase>/<document>/stakeholder_register.md` (recommended), `projects/<ProjectName>/<phase>/<document>/requirements_analysis_report.md` (optional) |115| **Output** | `projects/<ProjectName>/<phase>/<document>/solution_discovery_report.md` |116| **Tone** | Exploratory but disciplined, evidence-seeking |117| **Standards** | Volere discovery and prototype-driven requirements practices |118119## Core Instructions120121### Step 1: Define the Uncertainty122123State:124- the problem being explored125- the assumptions most likely to be wrong126- the decision that the prototype or comparison must support127128### Step 2: Generate Multiple Candidates129130Produce at least three candidate solution directions when feasible:131- build custom132- configure or buy133- hybrid or phased option134135For each candidate, define intended benefits, risks, and major constraints.136137### Step 3: Define Prototype Strategy138139Choose the smallest prototype type that can answer the question:140- paper or wireframe141- click-through UX142- workflow simulation143- proof-of-concept integration144- technical spike145146### Step 4: Compare Candidates147148Evaluate candidates against:149- business fit150- user fit151- technical feasibility152- implementation cost153- operational impact154- compliance or security risk155156### Step 5: Record Learnings157158For each prototype or experiment, document:159- hypothesis160- what was tested161- stakeholders involved162- findings163- decision impact164- follow-up work165166### Step 6: Write Output167168Write `projects/<ProjectName>/<phase>/<document>/solution_discovery_report.md` including candidates, prototype strategy, evaluation matrix, learnings, and recommendation.169170## Common Pitfalls171172- Treating a prototype as implicit approval for production implementation173- Testing visuals while leaving workflow or policy risks untouched174- Comparing options without agreed evaluation criteria175- Running discovery without recording what decision it should influence176177## Verification Checklist178179- [ ] The uncertainty or decision to resolve is explicit.180- [ ] More than one solution direction was considered where feasible.181- [ ] Prototype type matches the learning goal.182- [ ] Evaluation criteria include business and operational impact, not only UX.183- [ ] Findings lead to a recommendation or a clearly defined next experiment.