prototyping
Build a small disposable implementation to answer a feasibility or approach question. Use when the user asks for a spike, proof of concept or experiment; do not use for production code meant to ship.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- prototyping
- description
- Build a small disposable implementation to answer a feasibility or approach question. Use when the user asks for a spike, proof of concept or experiment; do not use for production code meant to ship.
03 SKILL.md 正文
<!-- Generated by Paved plugin paved@2.29.0 from core.development.prototyping@0.1.1; edit Paved Core instead. -->
Prototyping
When to use
A human asked for a prototype, spike or proof of concept, or planning cannot continue without answering a feasibility question. A prototype answers a question; it is not an early version of the feature.
Required context
The question to answer. Useful: the technology context, to prototype with what the project already uses.
Preconditions
- The question and the answer that would settle it are written down ("the external service accepts batches of at least N items").
- A human agreed on where the prototype lives and when it is removed.
Procedure
- Scope. Write the question, what is out of scope, and a time box.
- Isolate. Put the prototype where it cannot ship by accident: a separate branch or directory the build excludes, clearly labeled as a prototype at the top of each file.
- Accept shortcuts, explicitly. Allowed: hard-coded inputs, no error handling, no tests beyond what shows the answer. Never allowed: real secrets in files, production data, writes to shared environments, weakened checks in the main code.
- Run it and record what happened: inputs, outputs, how to reproduce it.
- Answer the question: yes, no or partly, with the reproduction as evidence and the limits of what the prototype showed.
- Clean up or transition. Delete the prototype, or, if a human decides to build on the result, start over through the feature workflow. The prototype is a reference, not a starting point; its shortcuts do not move into production code.
Tools
None. Commands come from the verification profile or the adapters.
Rules
None beyond those that apply by scope. The shortcuts in step 3 never extend to secrets or shared environments.
Verification
Required: runtime — the prototype was run and observed. Recommended: build, to know
the approach at least compiles in the project's toolchain.
Evidence
A reproduction (how to run it, what it showed) and the diff, so the prototype can be found and removed.
Completion criteria
- The question has an answer, backed by the reproduction, with its limits stated.
- The prototype is deleted, or labeled and scheduled for removal by a human.
- Nothing from the prototype reached the main code.
Failure modes
| Failure | Signal | Response |
|---|---|---|
| Prototype becomes the product | Someone proposes merging it | Stop; start the feature workflow instead |
| Question drifts | Work continues after the answer is known | Report the answer; stop |
| Unlabeled leftovers | Prototype files outside the agreed place | Move or delete them |
| Answer overstated | Report claims more than the run showed | Restate the limits |
References
None.
Paved integration
Use the project-local Paved contract as the source of truth. Discover state with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" status --json, load only relevant .paved/project/ context, and invoke verification with node "${CLAUDE_PLUGIN_ROOT}/scripts/paved.mjs" verify --json. Always run it from the repository being worked on, never from the plugin directory. Do not edit generated integration files or bypass Paved lifecycle and ownership checks.
04 同仓库更多 Skills
sample-skill
Does a sample task. Use when a sample is needed.
unexplained-contract
Does a sample task. Use when a sample is needed.
shell-block
Does a sample task. Use when a sample is needed.
project-identifier
Does a sample task. Use when a sample is needed.
oversized
Does a sample task. Use when a sample is needed.
no-activation
Does a sample task.