Habilidades planning-with-files
📦

planning-with-files

Seguro ⚙️ Comandos externos🌐 Acesso à rede📁 Acesso ao sistema de arquivos

Planeje Tarefas Complexas com Arquivos

Também disponível em: AmmarCodes,OthmanAdi

Agentes de IA perdem o controle dos objetivos durante tarefas longas. Esta habilidade usa arquivos markdown persistentes como memória externa para que agentes possam lidar com projetos complexos de múltiplas etapas sem perder o contexto.

Suporta: Claude Codex Code(CC)
🥈 80 Prata
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "planning-with-files". Research the benefits of morning exercise and write a summary

Resultado esperado:

Criado task_plan.md com fases: Criar plano, Buscar fontes, Sintetizar descobertas, Entregar resumo. Fase 1 completa. Pronto para buscar fontes.

A utilizar "planning-with-files". Fix the login bug in the authentication module

Resultado esperado:

Criado task_plan.md com fases: Entender bug, Localizar código, Identificar causa raiz, Implementar correção, Testar. Atualmente na Fase 3 - causa raiz encontrada.

A utilizar "planning-with-files". Add dark mode toggle to settings page

Resultado esperado:

Criados task_plan.md, findings.md com análise do sistema de temas existente e progress.md. Fase 1 completa - arquivos de tema identificados para modificação.

Auditoria de Segurança

Seguro
v1 • 2/24/2026

Static analysis flagged 101 potential issues but evaluation confirms all are FALSE POSITIVES. The detected external_commands are markdown documentation examples showing AI tool usage, not actual shell execution. Network access is limited to a single legitimate reference URL. Filesystem access is standard file operations. The skill implements Manus-style planning methodology with no malicious intent. Safe for publication.

8
Arquivos analisados
1,144
Linhas analisadas
3
achados
1
Total de auditorias

Fatores de risco

⚙️ Comandos externos (78)
🌐 Acesso à rede (2)
📁 Acesso ao sistema de arquivos (1)

Padrões Detectados

External Commands (Markdown Documentation Examples)Hardcoded URL (Reference Link)Browser Storage Access (Documentation Example)Critical Heuristic: Code Execution + Network + Credentials
Auditado por: claude

Pontuação de qualidade

59
Arquitetura
100
Manutenibilidade
87
Conteúdo
50
Comunidade
100
Segurança
100
Conformidade com especificações

O Que Você Pode Construir

Projetos de Pesquisa

Use task_plan.md para rastrear fases de pesquisa, findings.md para armazenar descobertas e progress.md para registrar atividades da sessão. Previne a perda de fontes e insights.

Correção de Bugs

Crie um plano de tarefa com fases para diagnóstico, identificação da causa raiz, implementação da correção e testes. Rastreie erros encontrados para evitar repetir abordagens falhas.

Desenvolvimento de Funcionalidades

Planeje a implementação de funcionalidades com fases, armazene decisões de design em findings.md e registre o progresso durante o desenvolvimento. Mantém o foco em muitas etapas de implementação.

Tente Estes Prompts

Planejamento Básico de Tarefas
Create a task_plan.md file with phases for: [describe your task]. Use the planning-with-files skill structure.
Pesquisa com Descobertas
Set up planning files for a research task on [topic]. Create task_plan.md with phases, findings.md for storing sources, and progress.md for logging.
Sessão de Depuração
Use planning-with-files to debug [issue]. Create task_plan.md with diagnosis phases, track errors encountered to avoid repeating failed approaches.
Fluxo de Trabalho Completo do Projeto
Apply the complete planning-with-files workflow: create all three planning files, implement the 2-action rule, use the 3-strike error protocol, and apply read-before-decide pattern.

Melhores Práticas

  • Crie task_plan.md ANTES de iniciar qualquer tarefa complexa com mais de 5 chamadas de ferramenta
  • Releia o arquivo de plano antes de tomar decisões importantes para refrescar objetivos no contexto
  • Atualize task_plan.md após cada fase para rastrear progresso e marcar status de conclusão

Evitar

  • Usar TodoWrite para persistência em vez de criar arquivos task_plan.md
  • Iniciar execução imediatamente sem criar um arquivo de plano primeiro
  • Ocultar erros e tentar novamente silenciosamente em vez de registrar no arquivo de plano

Perguntas Frequentes

Onde devo criar os arquivos de planejamento?
Crie task_plan.md, findings.md e progress.md no diretório do seu projeto, não na pasta de instalação da habilidade. Isso mantém seus arquivos de planejamento junto com seu código.
Quando devo usar esta habilidade?
Use planning-with-files para qualquer tarefa que requeira mais de 5 chamadas de ferramenta, projetos de pesquisa, implementações de múltiplas etapas ou qualquer coisa que requeira organização.
O que é a regra de 2 ações?
Após cada 2 operações de visualização, navegação ou pesquisa, salve imediatamente as descobertas principais em arquivos. Isso previne que informações visuais e multimodais sejam perdidas.
Como funciona o protocolo de erro de 3 tentativas?
Tentativa 1: Diagnosticar e corrigir. Tentativa 2: Tentar abordagem alternativa. Tentativa 3: Repensar de forma mais ampla. Após 3 falhas: escalar para o usuário com o que foi tentado.
O que é o padrão read-before-decide?
Antes de decisões importantes, leia task_plan.md para trazer objetivos de volta para sua janela de atenção. Isso previne perder o controle dos objetivos originais durante tarefas longas.
O que é KV-cache e por que importa?
KV-cache é um mecanismo para cache de tokens computados. Uma alta taxa de acerto reduz custos significativamente (10x mais barato). Prompts estáveis mantêm a validade do cache.

Detalhes do Desenvolvedor

Estrutura de arquivos