⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
idea-to-scope
Turn a vague feature idea into a small, testable scope and explicit non-goals before code changes. Use for product discovery and unclear requests; not for a fully specified small fix.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
Boundiff
Small changes. Strong evidence.
Boundiff combines bounded autonomy with disciplined diffs for everyday Codex work.
Created by Aditya Shekhar.
A practical AGENTS.md and a set of 16 focused skills for OpenAI Codex. Use them to turn a rough idea into a scoped change, investigate a failure, review a risky patch, verify real behavior, and prepare a clean handoff.
No services to sign up for. No telemetry. No runtime needed to use the skills. Just Markdown that lives with your code.
Example: “The export endpoint times out on large accounts.”
Use
$root-cause-investigationto isolate the bottleneck without making changes,$bug-fix-verificationto land a regression-backed fix, and$pull-request-handoffto explain exactly what changed and what was tested.
The point is not to make Codex follow a ceremony for every typo. It's to make the important boundaries hard to miss on work where mistakes are expensive.
Start here
If you're adding Boundiff to an existing repository, check whether it already has an AGENTS.md and .agents/skills/ first. Preserve the project's existing instructions.
Install in a project
From a local checkout (recommended when trying it for the first time):
git clone https://github.com/itsofficialadi/boundiff.git
cd boundiff
python3 scripts/install.py --target ../your-project
This previews the installation. It changes nothing. If the paths look right, run:
python3 scripts/install.py --target ../your-project --skills all --apply
By default this installs only surgical-change, bug-fix-verification, and independent-review. Add more skills when you need them (--skills all is available). The optional installer uses only Python's standard library. It refuses to overwrite existing files and won't stage, commit, or contact a network service. If your project already has an AGENTS.md, merge the policies manually rather than replacing it. Installation notes.
No Python? No installer needed. Copy AGENTS.md into a new project, or merge it with your existing policy. Then copy the desired directories from .agents/skills/ into <your-project>/.agents/skills/. Keep each SKILL.md at its original path. No script is executed by a skill merely because the skill was installed.
Just want the policy? Once this repository is published, download it to a safe name for review:
curl --fail --location --silent --show-error \
https://raw.githubusercontent.com/itsofficialadi/boundiff/main/AGENTS.md \
--output AGENTS.boundiff.example.md
Don't replace an existing AGENTS.md without reading and merging it.
Personal Codex setup: Codex also discovers skills under ~/.agents/skills. Copy the selected skill directories there if you want them available across projects. Project rules belong in each project's AGENTS.md, not in your global skill instructions. See Codex skill locations.
Pick a skill
You don't need to memorize all 16. Ask Codex naturally, or explicitly mention $skill-name in Codex CLI or the IDE extension. Codex can also match skills to tasks using their descriptions.
| When you're trying to… | Skill | Changes files? |
|---|---|---|
| Turn a fuzzy request into a first useful slice | $idea-to-scope | No |
| Plan a multi-file change before writing code | $implementation-plan | No |
| Challenge a design before committing to it | $architecture-review | No |
| Implement a contained feature or fix | $surgical-change | Yes |
| Fix a bug with credible regression evidence | $bug-fix-verification | Yes |
| Explain an intermittent bug or CI failure | $root-cause-investigation | No |
| Find the important holes in a test suite | $test-gap-audit | No |
| Exercise real user flows in local/staging | $acceptance-qa | No by default |
| Review a change without modifying it | $independent-review | No |
| Evaluate a trust boundary or risky patch | $security-review | No |
| Investigate a measured slowdown | $performance-investigation | No by default |
| Update a package without dependency churn | $dependency-upgrade | Yes |
| Handle a schema change or backfill | $migration-safety | Yes locally, with boundaries |
| Keep docs aligned with working behavior | $docs-sync | Yes, docs only |
| Hand reviewers a clear diff and evidence | $pull-request-handoff | No |
| Verify a commit, release, or push boundary | $release-checkpoint | Inspection by default |
If you only install three to start with, try surgical-change, independent-review, and bug-fix-verification. Add the others when the corresponding work appears. Skill selection guide.
Three common workflows
A bug that doesn't reproduce locally
Use $root-cause-investigation for this intermittent webhook failure.
Don't edit code. Show the hypotheses you ruled out and what evidence is missing.
Then, when there is a reproducible fix path:
Use $bug-fix-verification to fix the webhook race. Keep changes to the
retry path and its tests. Show the failing and passing evidence if available.
A feature with unclear scope
Use $idea-to-scope to narrow the CSV import request to a first release.
Then use $implementation-plan. Do not implement anything yet.
A release you need to trust
Use $independent-review on the diff against main. Do not edit files.
After we resolve the findings, use $release-checkpoint in inspection mode.
List the exact staged paths, checks run, and anything still unverified.
More examples, including migration and QA handoffs, are in workflow recipes.
What is ours, and what isn't
The engineering ideas in this repository are not new in isolation. Small changes, regression testing, independent review, and careful releases were established practices before coding agents existed. Skill catalogs for Codex and other agents already cover much of this territory.
Our product hypothesis is that a small persistent policy and deliberately separated workflows can keep one consistent boundary across the job: implement narrowly, review without silent remediation, verify the right evidence, and confirm source and target state before consequential release actions. That is a design position, not a demonstrated advantage over other tools. The pack is Codex-oriented and uses its supported skill conventions, but the workflow prose is largely portable rather than uniquely tied to Codex internals.
AGENTS.md carries persistent expectations. Task-specific skills supply procedures only when relevant. A planner doesn't quietly implement. A reviewer doesn't change its review target. A local test doesn't turn into a deployment claim. A release inspection doesn't authorize a push.
We have not published Codex behavior benchmarks yet. We will not claim this pack improves outcomes until comparable real task runs support that conclusion. Read the overlap and originality assessment, evaluation criteria, an
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
.agents/skills/idea-to-scope/SKILL.md1.8 KB326bd7b7678fupstream ↗
--- name: idea-to-scope description: Turn a vague feature idea into a small, testable scope and explicit non-goals before code changes. Use for product discovery and unclear requests; not for a fully specified small fix. --- # Idea to scope Start with the user problem, not a screen or a package name. This is a **thinking workflow**; do not edit source or commit anything. 1. **Find the job.** Identify the user, the moment the problem occurs, and how they currently work around it. If the repository exists, inspect only enough to avoid proposing something it already does. 2. **Challenge the premise.** Name one smaller or simpler way to get the same result. Identify a plausible reason the requested feature might not help. 3. **Define a first slice.** Write the smallest behavior that delivers value; include a real example and a deliberate list of non-goals. Do not convert possibilities into requirements. 4. **Close consequential gaps.** Ask at most a few high-leverage questions when the answer materially changes the outcome. For ordinary decisions, propose a reversible default and mark it as an assumption. 5. **Set acceptance evidence.** Describe how a person could observe success. Include failure or edge cases that would make a superficial demo misleading. 6. **Hand off.** State scope, acceptance criteria, assumptions, rejected alternatives, and unresolved decisions. Invite `$implementation-plan` only after scope is coherent. ## Watch for - Asking ten questions where a narrow assumption would suffice. - Adding roles, dashboards, settings, and analytics before the first useful action works. - Presenting invented user research as fact. - Claiming agreement or approval that the user has not given. ## Output A one-paragraph problem statement, **first slice**, **not now**, **acceptance evidence**, and **open decisions**. No code or project state changes.README.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/itsofficialadi-boundiff-agents-skills-idea-to-scope.md