Skip to content
Skill

imp

by majiayu000

AI Summary

IMP 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

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 6d ago
Active
Adoption100+ stars on GitHub
119 ★ · Growing
DocsMissing or thin
Undocumented

GitHub Signals

Stars119
Forks20
Issues1
Updated6d ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code