OpenParable
Skip to content
← Back to skills

Planner

Productivity
planner

Planner is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Cria planos estruturados para features, refatorações e investigações. Use quando precisar planejar uma implementação, definir tasks e subtasks, ou organizar o trabalho antes de começar a codar.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/planning/planner-aronpc-ai/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/planner, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

planner

Resumo

Cria planos de implementação estruturados com workflows para feature, refactor, investigation e migration.

Skills Relacionadas

SkillQuando usar junto
specPara usar specs como source de requisitos
sprintPara usar sprints como source de tarefas
coderPara executar o plano criado
qaPara validar a qualidade da implementação
architecturePara definir arquitetura no plano

Quando usar

Use esta skill quando precisar:

  • Planejar a implementação de uma nova feature
  • Estruturar um refactoring complexo
  • Investigar um bug ou comportamento inesperado
  • Planejar uma migration de dados ou infraestrutura
  • Criar planos de implementação acionáveis

Não use para:

  • Tarefas triviais (use o workflow "simple")
  • Análise de codebase sem objetivo de implementação
  • Planejamento estratégico de produto (use roadmap-strategy)

Workflow Types

Escolha o workflow apropriado baseado no tipo de tarefa:

WorkflowQuando usarExemplos
featureNova funcionalidadeAdicionar autenticação OAuth, criar dashboard
refactorMelhorar código existenteExtrair componentes, renomear módulos
investigationEntender/debugarBug investigation, performance analysis
migrationMover dados/infraDatabase migration, framework upgrade
simpleTarefas diretasFix typo, atualizar config

Feature Workflow

Para novas funcionalidades que adicionam valor ao produto:

  1. Analise requisitos e dependências
  2. Design da solução (API, componentes, fluxo)
  3. Implementação por camadas (backend → frontend)
  4. Testes e validação
  5. Documentação

Refactor Workflow

Para melhorias de código sem mudança de comportamento:

  1. Identifique o que será refatorado
  2. Garanta testes existentes passando
  3. Faça mudanças incrementais
  4. Rode testes após cada mudança
  5. Valide comportamento inalterado

Investigation Workflow

Para bugs ou comportamentos inesperados:

  1. Defina o problema claramente
  2. Colete evidências (logs, stack traces)
  3. Forme hipóteses
  4. Teste hipóteses sistematicamente
  5. Documente causa raiz e solução

Migration Workflow

Para migrações de dados ou infraestrutura:

  1. Mapeie estado atual → estado desejado
  2. Identifique dependências e riscos
  3. Crie plano de rollback
  4. Execute em fases
  5. Valide cada fase

Simple Workflow

Para tarefas triviais:

  1. Entenda a mudança
  2. Implemente
  3. Verifique
  4. Commit

Estrutura do Plano

O plano de implementação segue esta estrutura JSON:

{
  "spec_id": "spec-001",
  "workflow_type": "feature",
  "phases": [
    {
      "id": 0,
      "name": "Pre-Planning",
      "subtasks": [
        {
          "id": "st-0-1",
          "title": "Load context",
          "status": "pending"
        }
      ]
    }
  ],
  "verification_strategy": {
    "type": "command",
    "command": "npm test"
  }
}

Fases do Plano

FaseNomeObjetivo
0Pre-PlanningCarregar contexto, entender requisitos
1AnalysisAnalisar codebase, identificar arquivos
2DesignDesign da solução, estrutura
3ImplementationImplementação principal
4TestingTestes unitários, integração
5ReviewCode review, ajustes
6IntegrationMerge, deployment
7VerificationValidação final

Estrutura de Subtasks

Cada subtask deve ter:

  • id: Identificador único (st-fase-numero)
  • title: Título descritivo e acionável
  • description: Detalhes da tarefa (opcional)
  • status: pending | in_progress | completed | blocked
  • verification: Como verificar conclusão (opcional)
  • files: Arquivos relacionados (opcional)

Verification Strategy

Cada plano deve incluir uma estratégia de verificação. Veja references/verification-types.md para detalhes.

TipoQuando usarExemplo
commandTestes, buildsnpm test, make build
apiAPIs REST/GraphQLcurl localhost:3000/api/health
browserUI webPuppeteer, screenshots
e2eFluxos completosPlaywright, Cypress
manualVerificação humanaCode review, UX testing
noneNão verificável automaticamenteDocumentação

Pre-Planning Checklist

Antes de criar o plano, verifique:

  • Li e entendi a spec/task
  • Identifiquei o workflow type apropriado
  • Selecionei a verification strategy
  • Mapeei arquivos que serão modificados
  • Identifiquei dependências
  • Avaliei riscos e complexidade
  • Defini critérios de sucesso

Exemplo de Plano

{
  "spec_id": "spec-add-oauth",
  "workflow_type": "feature",
  "phases": [
    {
      "id": 0,
      "name": "Pre-Planning",
      "subtasks": [
        {"id": "st-0-1", "title": "Load spec and understand requirements", "status": "pending"},
        {"id": "st-0-2", "title": "Review existing auth implementation", "status": "pending"}
      ]
    },
    {
      "id": 1,
      "name": "Analysis",
      "subtasks": [
        {"id": "st-1-1", "title": "Identify files to modify", "status": "pending"},
        {"id": "st-1-2", "title": "Check OAuth provider docs", "status": "pending"}
      ]
    },
    {
      "id": 3,
      "name": "Implementation",
      "subtasks": [
        {"id": "st-3-1", "title": "Add OAuth provider config", "status": "pending", "files": ["src/auth/config.ts"]},
        {"id": "st-3-2", "title": "Create OAuth callback handler", "status": "pending", "files": ["src/auth/oauth.ts"]},
        {"id": "st-3-3", "title": "Update login UI", "status": "pending", "files": ["src/components/Login.tsx"]}
      ]
    },
    {
      "id": 4,
      "name": "Testing",
      "subtasks": [
        {"id": "st-4-1", "title": "Add OAuth unit tests", "status": "pending"},
        {"id": "st-4-2", "title": "Test OAuth flow manually", "status": "pending"}
      ]
    }
  ],
  "verification_strategy": {
    "type": "browser",
    "steps": ["Navigate to login", "Click OAuth button", "Verify redirect", "Verify login success"]
  }
}

Referências

  • references/verification-types.md - Tipos de verificação detalhados
  • references/workflow-patterns.md - Padrões de workflow
  • references/plan-structure.md - Schema JSON completo