prototype

Builds proof-of-concept code in a hookless git worktree sandbox, then promotes it through clean-room review.

6|1|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/jl-cmd/claude-dev-env --skill prototype-jl-cmd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prototype
Source: https://github.com/jl-cmd/claude-dev-env/tree/main/skill-archive/prototype
Command: npx skills add https://github.com/jl-cmd/claude-dev-env --skill prototype-jl-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Standards hooks like TDD enforcement and code-rules gates slow down exploratory proof-of-concept builds, but skipping them entirely risks shipping unreviewed code. This Skill separates the two concerns: it runs a fast, hookless sandbox build in an isolated git worktree, then re-verifies the result under full standards before it becomes a commit and pull request. ## Core Features & Use Cases - Hookless sandbox builds: Launches a headless claude -p --bare session in an isolated worktree off origin/main, keeping only two safety gates (personal-data blocking and destructive-command blocking) active. - Verified containment: Builds a minimal safety settings file from the live ~/.claude/settings.json and probes both safety hooks with payloads they must hard-deny before trusting the sandbox. - Clean-room promotion: Re-applies the POC as an uncommitted diff on a fresh branch, runs cleanup, privacy sweep, review and verification, then commits and opens a draft PR with honest limitations stated. - Use Case: You want to spike a caching layer without TDD friction. The sandbox agent builds it freely; if it works, promotion re-verifies the diff, sweeps for secrets, and ships it as a reviewed draft PR. ## Quick Start Ask the AI to prototype your idea, for example: prototype a proof of concept for the widget cache and promote it if it works.

Frequently Asked Questions about prototype

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

FAQPage Schema
How do I build a proof of concept without TDD and code-quality hooks slowing it down?▼

Run the prototype skill, which creates an isolated git worktree and launches a headless claude session with the --bare flag so standards hooks do not fire. Only personal-data and destructive-command safety gates remain active during the build.

How do I promote a prototype or spike build into a real pull request?▼

The promotion phase re-applies the POC as an uncommitted diff on a fresh branch off origin/main, then runs cleanup, a privacy sweep, and review and verification before committing and opening a draft PR. Sandbox commits are never cherry-picked or merged.

What safety protections stay active inside the hookless sandbox?▼

Two gates remain live: personal-data blocking on Write, Edit, MultiEdit, and Bash, and destructive-command blocking on Bash running in hard-deny mode. A probe script confirms both hooks deny their test payloads before the sandbox launches.

Why does the prototype skill refuse to run?▼

It refuses when the directory is not a git repository, when the fresh-branch skill is not installed, or when the claude CLI is not on PATH. Each refusal case returns a specific message explaining the missing prerequisite.

What are the limitations of code promoted from a prototype sandbox?▼

Write-time code rules never ran on the code because it was built under --bare, and TDD red-green-refactor ordering is waived on promoted lines. Promotion covers the code with review, verification, and a privacy sweep instead.