grzadr/agent-skills

Skill de Blueprint de Criação

Quando solicitado a projetar ou inicializar um projeto de aprendizado, gere um arquivo ROADMAP.md estruturado na raiz do workspace. NÃO escreva nenhum código de aplicação ou implementação.

Princípios Centrais de Design

1. Micro-Sprints (Ritmo Baseado em Dopamina): Cada passo deve ser concluível em 15 a 30 minutos de codificação focada. Se uma funcionalidade levar mais tempo, divida-a em sub-passos.
2. Fatias Verticais em vez de Camadas Horizontais: Nunca crie um estágio que seja "Escreva todos os modelos de dados" seguido por "Escreva todas as consultas ao banco de dados." Em vez disso, o Estágio 1, Passo 1.1 deve receber uma única entrada e produzir uma saída visível e testável imediatamente.
3. Agnosticismo de Linguagem: Estruture as especificações em torno de comportamento observável (entradas, saídas, mudanças de estado, códigos de saída, valores de retorno ou respostas de API) em vez de código repetitivo específico de linguagem.

Protocolo

1. Esclarecer Contexto Mínimo (apenas se estiver faltando)

Se o usuário não especificou:

• Projeto Alvo (ex.: Aplicativo de Tarefas, cliente BitTorrent, armazenamento Chave-Valor, servidor HTTP)
• Linguagem / Runtime Alvo (ex.: Go, Rust, Python, TypeScript, C, Zig)
• Tipo de Interface (ex.: CLI, API HTTP, TUI, Biblioteca)

Faça no máximo 2 perguntas breves para definir esses pontos antes de gerar o ROADMAP.md.

2. Gerar ROADMAP.md

Crie ROADMAP.md usando a seguinte estrutura:

• Visão Geral do Projeto: Um resumo de 2 frases do que está sendo construído e os principais conceitos de linguagem que o aluno praticará (ex.: gerenciamento de memória, concorrência, structs/interfaces, I/O assíncrono, tratamento de erros).
• Rastreador de Progresso:
  • Ponteiro de Estágio e Passo atuais (ex.: Passo Ativo: Estágio 1 - Passo 1.1)
  • Legenda de status: [ ] Bloqueado/Pendente, [~] Em Progresso, [x] Concluído
• Estágios (4 a 6 Estágios no total):
  • Estágio 1: O Coração (Esqueleto Funcional): Fazer o comando ou função mais simples possível funcionar de ponta a ponta.
  • Estágio 2: Estado Central & Caminho Feliz: Implementar as estruturas de dados primárias e operações principais em memória.
  • Estágio 3: Persistência / I/O & Casos de Borda: Salvar estado, analisar entradas complexas e tratar erros com elegância.
  • Estágio 4: Funcionalidades Avançadas da Linguagem: Introduzir concorrência, streaming, middleware ou otimização de desempenho.
• Passos (2 a 4 Passos por Estágio): Para cada Passo, inclua:
  • Objetivo: Uma frase descrevendo o que o usuário construirá.
  • Conceitos de Linguagem Praticados: 2 a 3 funcionalidades específicas da linguagem necessárias para este passo.
  • Especificação & Critérios de Aceitação: Comportamentos concretos e testáveis ​​(caixa preta) (assinaturas exatas de funções, argumentos de CLI, stdout/stderr esperados, ou status/payloads HTTP) que o craft-gatekeeper usará para escrever testes automatizados.

Guardrails

• NUNCA gere arquivos de código fonte ou trechos de solução ao executar esta skill.
• Termine sua resposta apontando o usuário para o Estágio 1, Passo 1.1 e sugerindo que ele execute /craft-bootstrap (para configurar o esqueleto do projeto vazio) ou /craft-gatekeeper (para gerar o primeiro teste falho).