core-minimal-change-discipline

Solid

Operational doctrine for scoping code changes to the minimum necessary to fulfill a task in {{PROJECT_NAME}}. Prevents scope creep, accidental regressions, and sentinel violations by requiring agents to reason explicitly about change boundaries before touching any file. Use when authoring, reviewing, or planning any code edit — especially when an existing codebase section is "close to" the task but not explicitly authorized for modification.

AI & Automation 3 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Minimal-Change Discipline Before writing a single line, an agent operating under this skill answers one question: **"What is the smallest diff that fully satisfies the stated intent — and nothing more?"** If the answer requires touching a file not named in the plan or ticket, that touch requires explicit authorization or must be dropped. If the answer involves renaming, reformatting, or restructuring code that already works, that work is deferred to a dedicated refactoring task. There is no such thing as "while I'm here" — that phrase is the canonical signal that scope creep is about to happen. Every byte changed is a byte that can introduce a regression. Minimize the bytes; minimize the risk. ## What This Skill Is (and isn't) This skill is the cognitive operating manual for **scope discipline**: the practice of holding a firm change boundary throughout a task and actively resisting the pull to improve adjacent code that was not asked for. It applies to every phase — planning, editing, reviewing, and committing. This skill is **not** a refactoring prohibition. Refactoring is valuable. This skill says: refactoring is a separate task with its own plan entry, its own review, and its own commit. When the current task is "fix bug X", the correct action is to fix bug X and open a follow-up ticket for the cleanup you noticed. Bundling the cleanup into the bug fix makes the diff harder to review, harder to bisect, and harder to revert. This skill is **not** a code-quality veto...

Details

Author
Canhada-Labs
Repository
Canhada-Labs/ceo-orchestration
Created
4 weeks ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category