Upstream

Skill fernando-bertholdo/4-successful-AI-life/plugins/enhanced-planning/upstream

Curated Claude Code plugin marketplace — opinionated, production-ready skills for AI-assisted work, focused on craft, rigor, and practical excellence.

Install

npx -y skills add fernando-bertholdo/4-successful-AI-life --skill upstream

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Adicionar guardrails estruturais a planos de implementacao. Use ao criar planos para milestones ou detours, quando o plano abrange multiplas sessoes, ou quando ha risco de drift entre componentes. Invoque ANTES de escrever o plano. Complementa (nao substitui) writing-plans.

SKILL.md

10.9 KB, as published. Nobody here has run it

Enhanced Planning — Guardrails Estruturais para Planos

Standalone usage (fora do tech-product-template)

Este skill nasceu no tech-product-template, que tem um framework de planejamento (initiatives → milestones/detours). Você não precisa desse framework para usar os guardrails:

milestone / detour / initiative = a sua unidade de trabalho (uma feature, um épico, um fix). Onde o skill pede enhanced-planning MX.X, use qualquer rótulo: enhanced-planning checkout-v2.
{{PLANNING_DIR}} = onde você guarda planos. Default sugerido: .planning/ (ou docs/plans/). Se o seu projeto não tem esse diretório, salve o plano ao lado do código/PR.
Skills-companion opcionais (init-milestone, init-detour, validate-dor, validate-dod, archive-initiative) pertencem ao framework de origem. Se você não os tem, ignore os passos que os mencionam — os guardrails funcionam sozinhos.
As referências a writing-plans (superpowers) e a /codex:rescue (plugin Codex) são reais e recomendadas.
A seção "Mirror Upstream" no fim do arquivo é metadado de manutenção do template — ignore como usuário do plugin.

Regra de Ouro

"Todo plano de implementacao deve ter guardrails completos: checkpoints humanos, risk registry, decision locks, protocolo multi-sessao, e revisao Codex."

Quando Usar

Antes de criar plano para milestone ou detour
Quando tarefa tem 3+ PRs/deliverables
Quando plano abrange multiplas sessoes
Quando slice toca output visivel ao stakeholder (email, report, dashboard)
Quando ha risco de drift entre componentes

Quando NAO Usar

Tarefas simples (1-2 arquivos, <100 linhas)
Patches rapidos (<=2 sessoes, sem risco de regressao)
Exploracao/pesquisa sem deliverable definido
Quando writing-plans do superpowers ja foi invocado e a tarefa e trivial

Parametros

enhanced-planning [milestone-id|detour-name]

Exemplos:

enhanced-planning MX.X — Guardrails para milestone MX.X
enhanced-planning auth-refactor — Guardrails para detour
enhanced-planning — Guardrails sem initiative especifica

Guardrails Incluidos

Dimensao	Especificacao
Checkpoints humanos	6+ (por PR/fase)
Continuidade multi-sessao	Protocolo completo (tabela, CONTEXT.md, resume)
Risk registry	Completo (severidade, mitigacao, owner, status)
*Guardrails nomeados (G-)**	Obrigatorio (selecionar do catalogo, verificacao por slice)
Criterios de aceite	Checkbox + comandos de verificacao + evidencia
Verificacao cruzada docs	Tabela de isonomia completa
Revisao Codex	Por PR + meta-avaliacao via `/codex:rescue --effort xhigh`
Decision locks	Secao dedicada com tracking
Verificacao final	10+ itens
Sequencia de commits	Tabela com PR + tipo + scope

Workflow

Step 1 — Generate Planning Spec

Ler o template em references/plan-template.md.

Secoes obrigatorias:

Contexto (problema + resultado esperado)
Implementacao (PRs com slices, arquivos, criterios de aceite)
Checkpoints Humanos (tabela: design, mid-point, final, desbloqueio, +por PR)
Guardrails Nomeados G-* (do catalogo)
Riscos e Mitigacoes (registry completo com severidade, owner, status)
Tabela de Progresso
Verificacao Cruzada / Isonomia Documental
Revisao Codex com meta-avaliacao (via /codex:rescue, do protocolo)
Decision Locks
Protocolo de Conclusao de PR (passos obrigatorios)
Protocolo Multi-Sessao
Sequencia de Commits
Verificacao Final (10+ itens)

Output: Planning Spec — documento intermediario com:

Lista de secoes obrigatorias
Guardrails G-* ativos
Checkpoints humanos com momentos definidos
Template de cada secao pre-preenchido com placeholders

Step 2 — CHECKPOINT HUMANO: Confirmar Guardrails

Usar AskUserQuestion para apresentar ao usuario:

Secoes obrigatorias que serao incluidas no plano

Guardrails G-* ativos

Checkpoints humanos planejados

Perguntar: "Os guardrails estao adequados para a tarefa? Opcoes: (A) Confirmar e prosseguir, (B) Adicionar/remover guardrails especificos."

Step 3 — Inject into Plan

Inserir a Planning Spec como requisitos estruturais no plano.

Se usando writing-plans (superpowers):

A Planning Spec funciona como pre-requisito estrutural
O agente deve incluir TODAS as secoes obrigatorias no plano gerado
Checkpoints humanos devem usar AskUserQuestion nos momentos definidos

Se criando plano diretamente:

Usar o template de plan-template.md como esqueleto
Preencher com conteudo especifico da tarefa
Garantir que nenhuma secao obrigatoria foi omitida

Step 4 — Validate Plan Completeness

Apos o plano ser escrito, validar (10 checks):

Se validacao falhar, informar quais secoes estao faltando e sugerir correcoes.

Integracao com Skills Existentes

Skill	Relacao com enhanced-planning
`writing-plans` (superpowers)	enhanced-planning gera spec ANTES; writing-plans preenche conteudo DEPOIS
`validate-dor`	Usar ANTES de enhanced-planning para validar pre-requisitos do milestone
`validate-dod`	Usar DEPOIS da implementacao para validar completude
`fresh-context`	Invocar nos pause points definidos pelo protocolo multi-sessao
`organize-commits`	Seguir sequencia de commits definida no plano
`init-milestone`	Invocar ANTES de enhanced-planning para criar infraestrutura (milestones)
`init-detour`	Invocar ANTES de enhanced-planning para criar infraestrutura (detours)
`agent-team`	Compativel — plano com guardrails pode ser executado por equipe

Fluxo Completo

[1] init-milestone MX.X | init-detour <nome>  (criar infra)
[2] validate-dor MX.X | <nome>               (validar pre-requisitos)
[3] enhanced-planning MX.X | <nome>          (definir guardrails)    <-- ESTA SKILL
[4] writing-plans / plano direto              (escrever plano COM guardrails)
[5] implementar slices                        (seguir plano)
[6] validate-dod MX.X | <nome>               (validar completude)

Plan Lifecycle (Criacao → Commit → Arquivamento)

Planos gerados por esta skill ou pelo writing-plans do superpowers tem ciclo de vida definido. A regra central e: planos sao artefatos de trabalho, nao documentacao permanente.

Tipos de artefato de plano

Origem	Diretorio	Lifecycle	Exemplo
`enhanced-planning` / `writing-plans`	`.claude/superpowers/plans/`	Commit ao criar → Archive ao concluir	`2026-03-23-feature-x.md`
`brainstorming` (design specs)	`.claude/superpowers/specs/`	Commit ao criar → Archive ao concluir	`2026-03-22-feature-x-design.md`
Plan mode (Claude Code)	`.claude/plans/`	Gitignored — efemero, nao commitar	`cuddly-inventing-panda.md`

Na criacao do plano

Salvar o plano no diretorio de superpowers (ou {{PLANNING_DIR}}<initiative>/plans/ se preferir co-localizar)

Commitar como parte do setup do milestone/detour:

chore(planning): adiciona plano de implementacao para [initiative-id]

Registrar referencia no CONTEXT.md da initiative (se existir)

Durante a execucao

O plano e a referencia viva — atualizar tabela de progresso, checkboxes, decision locks
Commitar atualizacoes de progresso junto com os slices (nao em commits separados)

Na conclusao (pos-DoD)

Quando validate-dod retornar PASS e archive-initiative for invocado:

Planos em .claude/superpowers/: archive-initiative move para _archive/<initiative>/plans/
Planos ja co-localizados em {{PLANNING_DIR}}<initiative>/plans/: movidos automaticamente com o diretorio pai
Plan mode (.claude/plans/): ja gitignored — deletar localmente se desejado

Limpeza periodica

Se planos se acumularem sem initiative associada:

Verificar se foram implementados (cruzar com git log)
Se implementados → deletar (codigo e commits sao a fonte de verdade)
Se parcialmente implementados → mover para {{PLANNING_DIR}}detours/<nome>/plans/ ou {{PLANNING_DIR}}scratch/
Se obsoletos → deletar

Regra: Planos executados nao sao documentacao. O codigo, os commits e os docs core sao a fonte de verdade pos-implementacao.

Mirror Upstream

Esta skill usa placeholders para neutralizacao ao exportar para templates:

Placeholder	Descricao
`{{PROJECT_NAME}}`	Nome do projeto
`{{CODEX_MODEL}}`	Modelo Codex para revisao
`{{PLANNING_DIR}}`	Diretorio de planning
`{{DOCS_DIR}}`	Diretorio de docs core

Ao executar mirror-upstream, substituir valores concretos por placeholders.

Versao: 2.0.0 Ultima atualizacao: 24/Marco/2026 Autor: Fernando Bertholdo

Changelog

v2.0.0 (24/Marco/2026)

BREAKING: Remove sistema de 3 tiers (LOW/MEDIUM/HIGH) — agora existe um unico modo equivalente ao antigo HIGH
Remove Step "Tier Assessment" (scoring, classificacao) — nao ha mais selecao de tier
Remove Tier Comparison Matrix
Parametros simplificados: enhanced-planning [initiative-id] (sem tier)
Template unico em plan-template.md (substitui tier-templates.md)
Codex Review Protocol simplificado (sempre por PR + meta-avaliacao, effort xhigh)
Workflow reduzido de 5 para 4 steps
Validacao unificada em 10+ checks (sem separacao por tier)

v1.1.0 (23/Marco/2026)

Adiciona secao "Plan Lifecycle" com regras para commit, co-localizacao, e arquivamento de planos

v1.0.0 (20/Marco/2026)

Criacao inicial: workflow 5-step, tier matrix, auto-assessment, integracao com skills existentes