Skill Scope Control
Use quando a conversa indicar que uma mudança pode ter crescido além do objetivo: “essa alteração ficou grande demais”, “o diff saiu do escopo”, “o PR está misturado” ou “o que não deveria estar aqui?”.
Fluxo conversacional
- Registre o objetivo em uma frase. Se ele não estiver claro, peça essa frase antes de classificar o diff.
- Faça um inventário dos arquivos, subsistemas, dependências e comportamentos alterados.
- Classifique cada descoberta com uma categoria canônica:
IN_SCOPE, REQUIRED_DEPENDENCY, DISCOVERED_WORK ou OUT_OF_SCOPE.
IN_SCOPE pode ser executado quando atende diretamente um critério de aceitação. REQUIRED_DEPENDENCY só pode ser executado com justificativa, impacto e evidência da necessidade.- Registre
DISCOVERED_WORK no mecanismo existente de follow-up/handoff e não o inclua silenciosamente no plano. Bloqueie OUT_OF_SCOPE.
- Recomende manter, separar ou justificar explicitamente, sempre apontando a evidência.
- Entregue um resumo curto com itens, risco de mistura e próximo passo.
O padrão é somente leitura: não edite, reverta, faça stage, commit ou push. A skill pode ser usada antes ou durante revisão de código, release ou planejamento.
Contenção no autopilot
Para cada descoberta, atualize o task ledger ou handoff existente antes de agir. Somente IN_SCOPE e REQUIRED_DEPENDENCY justificada são elegíveis para execução. Uma tentativa de executar descoberta sem justificativa deve virar bloqueio, não uma autorização implícita.
Ferramenta opcional
Se scripts/scope_creep.py já estiver disponível no projeto, ele pode ser usado para uma análise offline e reproduzível. Não instale nem execute código externo sem autorização. Passe o objetivo e os caminhos de forma segura, sem interpolar texto da conversa em comandos de shell.
Guardrails
- Keep this skill compact; move long details into
references/ and link them from this file.
- Do not include tokens, local paths, logs, private project names, or stale API examples.
- Prefer project evidence over generic assumptions.
Verification
- Confirm the requested behavior or decision is covered by local evidence.
- Run the relevant project validation gate when code, config, or operational behavior changes.
Related Skills
skill-preflight para definir o escopo antes de implementar.code-review para revisar qualidade e regressões depois da classificação.skill-release-engineering para separar mudanças antes de uma entrega.
1---2name: skill-scope-control3description: Analisa se alterações, diffs e PRs continuam alinhados ao objetivo declarado, identificando escopo extra e propondo manter, separar ou justificar.4---56# Skill Scope Control78Use quando a conversa indicar que uma mudança pode ter crescido além do objetivo: “essa alteração ficou grande demais”, “o diff saiu do escopo”, “o PR está misturado” ou “o que não deveria estar aqui?”.910## Fluxo conversacional11121. Registre o objetivo em uma frase. Se ele não estiver claro, peça essa frase antes de classificar o diff.132. Faça um inventário dos arquivos, subsistemas, dependências e comportamentos alterados.143. Classifique cada descoberta com uma categoria canônica: `IN_SCOPE`, `REQUIRED_DEPENDENCY`, `DISCOVERED_WORK` ou `OUT_OF_SCOPE`.154. `IN_SCOPE` pode ser executado quando atende diretamente um critério de aceitação. `REQUIRED_DEPENDENCY` só pode ser executado com justificativa, impacto e evidência da necessidade.165. Registre `DISCOVERED_WORK` no mecanismo existente de follow-up/handoff e não o inclua silenciosamente no plano. Bloqueie `OUT_OF_SCOPE`.176. Recomende manter, separar ou justificar explicitamente, sempre apontando a evidência.187. Entregue um resumo curto com itens, risco de mistura e próximo passo.1920O padrão é somente leitura: não edite, reverta, faça stage, commit ou push. A skill pode ser usada antes ou durante revisão de código, release ou planejamento.2122## Contenção no autopilot2324Para cada descoberta, atualize o task ledger ou handoff existente antes de agir. Somente `IN_SCOPE` e `REQUIRED_DEPENDENCY` justificada são elegíveis para execução. Uma tentativa de executar descoberta sem justificativa deve virar bloqueio, não uma autorização implícita.2526## Ferramenta opcional2728Se `scripts/scope_creep.py` já estiver disponível no projeto, ele pode ser usado para uma análise offline e reproduzível. Não instale nem execute código externo sem autorização. Passe o objetivo e os caminhos de forma segura, sem interpolar texto da conversa em comandos de shell.2930## Guardrails3132- Keep this skill compact; move long details into `references/` and link them from this file.33- Do not include tokens, local paths, logs, private project names, or stale API examples.34- Prefer project evidence over generic assumptions.3536## Verification3738- Confirm the requested behavior or decision is covered by local evidence.39- Run the relevant project validation gate when code, config, or operational behavior changes.4041## Related Skills4243- `skill-preflight` para definir o escopo antes de implementar.44- `code-review` para revisar qualidade e regressões depois da classificação.45- `skill-release-engineering` para separar mudanças antes de uma entrega.
IAPro-Community