Sobre o projeto

Jules Prompts é uma biblioteca curada de prompts de tarefas legíveis por máquina, Agent Skills e fixtures com falhas plantadas, projetada para agentes de codificação. O nome é histórico; as instruções são independentes de ferramentas específicas e não dependem de nenhum produto como Jules, Claude Code, Codex ou Cursor. O repositório está organizado em várias camadas: - `_prompts/`: Texto canônico dos procedimentos, incluindo um site, índice JSON e comandos de barra MCP. - `skills/`: O mesmo texto formatado como Agent Skills, gerado a partir de `_prompts/`, pronto para copiar em `.claude/skills/` ou `.agents/skills/`. - `fixtures/`: Repositórios em miniatura com defeitos plantados para demonstrar como as skills falham. - `plugin/`: A biblioteca inteira como um pacote instalável com manifesto, skills e comandos de barra. - `library.json`: Uma lista legível por máquina de cada procedimento, sua categoria e nível. Todas as saídas geradas são verificadas byte a byte no CI para garantir que permaneçam sincronizadas com a fonte. Adicionar um novo formato de saída é uma única entrada na lista `TARGETS` de `scripts/emit.py`. Os procedimentos são classificados como `core`, a menos que marcados com `status: legacy`. Os procedimentos core abordam as falhas que os agentes realmente têm, enquanto os procedimentos legacy são textos de tarefas de propósito geral de 2025 que permanecem úteis, mas não são o que torna esta biblioteca única. A biblioteca inclui uma doutrina permanente para `AGENTS.md` em `harness/AGENTS.md` para garantir que ela seja acionada quando nenhuma skill for selecionada. Guias de início rápido são fornecidos em `PROMPTS_GUIDE.md` (explica cada prompt e a sequência recomendada) e `ENVIRONMENT_SETUP.md` (preparando um repositório para clonagem, instalação e teste por agentes). As opções de uso incluem: - Como Agent Skills: Copie os diretórios de skills para `.claude/skills/` e cole `harness/AGENTS.md` no `AGENTS.md` do projeto. - Como servidor MCP: Configure o servidor em `mcpServers` para expor prompts como comandos de barra no Claude Code, Claude Desktop, VS Code/Copilot Chat, Windsurf e Zed. O servidor lê o repositório ao vivo, e espaços reservados como `<PR_URL_OR_DIFF_RANGE>` são expostos como argumentos. - Para humanos: Copie o corpo de um arquivo de prompt após o front matter YAML e cole-o na entrada de instruções do agente. - Para agentes: Busque `https://jules-prompts.wecanuseai.com/prompts.json`, selecione um prompt por título/descrição/categoria e busque o prompt renderizado de sua URL ou leia `_prompts/<slug>.md`. - Contra fixtures: Use `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` para pontuar uma fixture, com veredictos de holds/broken/skipped e uma linha de cobertura. As diretrizes de contribuição enfatizam adicionar prompts apenas para tarefas recorrentes ainda não cobertas, manter o front matter YAML alinhado, escrever instruções independentes de ferramentas, regenerar skills, atualizar guias e fluxo de trabalho, adicionar fixtures para prompts que capturam falhas e passar nas verificações de integridade.