AI SummaryIMP is a unified shipping protocol that combines code execution, validation, and self-review using a TRACE methodology to ensure quality changes are deployed incrementally. It benefits developers and AI coding assistants who want to ship bead-scoped changes with built-in review cycles.
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to install the "imp" skill in my project. Repository: https://github.com/majiayu000/claude-skill-registry Please read the repo to find the SKILL.md file(s), then: 1. Download them into the correct skills directory (.claude/skills/ or .cursor/skills/) 2. Include any companion files referenced by the skill 3. Confirm what was installed and where
Description
Unified shipping + TRACE self-review protocol (beads, proof, PR). Explicit-only.
2) Clarify until requirements are implementable
• Ask only judgment calls (preferences, tradeoffs, acceptance thresholds). • Everything else should be discovered in-repo (code, tests, conventions) or in the bead. • If you encounter ambiguity mid-implementation, stop and re-clarify.
Intent
Ship bead-scoped changes end-to-end with proof, then immediately self-review the resulting PR using TRACE and fix what you find. IMP is a combined execution + review + closure protocol: • Write code with strong invariants and minimal incision. • Validate with a full check suite. • Open a PR. • Review that PR right away and resolve findings. • Select the next bead (so bead state is committed). • Update/monitor/merge/cleanup (CL).
Definition of Done (IMP)
An imp run is done when: • The bead’s acceptance criteria are satisfied. • The working tree contains only bead-aligned changes. • Format + lint/typecheck + build + tests have run (or are explicitly recorded as unavailable). • $close-the-loop is invoked and at least one signal is recorded. • The worked bead is marked done before PR creation. • A PR is opened. • A TRACE self-review is produced (in chat) and all 🔥 + 🟡 items are resolved. • $select is run once (to pick exactly one next bead), and resulting bead state changes (e.g. issues.jsonl) are committed into the PR. • The PR is updated and squash-merged when either: • CI is green, or • CI is billing-blocked (billing appears in CI failure text), zig build ci passes, and the PR is squash-mergeable. • Local state is cleaned up. • A bead comment exists with PR link + proof summary.
Guardrails
• Explicit-only; never auto-trigger. • Source of truth: bd wins. • Surgeon’s principle: smallest correct change. • No intentional product/semantic changes without clarifying. • Don’t split into multiple PRs unless explicitly asked. • Don’t merge until the final CL step.
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster