Sobre el proyecto

Jules Prompts es una biblioteca curada de prompts de tareas legibles por máquina, Agent Skills y fixtures de fallos plantados diseñados para agentes de código. El nombre es histórico; las instrucciones son agnósticas al entorno y no dependen de ningún producto específico como Jules, Claude Code, Codex o Cursor. El repositorio está organizado en varias capas: - `_prompts/`: Texto de procedimientos canónicos, incluyendo un sitio web, un índice JSON y comandos slash de MCP. - `skills/`: El mismo texto formateado como Agent Skills, generado desde `_prompts/`, listo para copiar en `.claude/skills/` o `.agents/skills/`. - `fixtures/`: Repositorios en miniatura con defectos plantados para demostrar cómo fallan las skills. - `plugin/`: Toda la biblioteca como un bundle instalable con manifiesto, skills y comandos slash. - `library.json`: Una lista legible por máquina de cada procedimiento, su categoría y nivel. Todas las salidas generadas se verifican byte por byte en CI para asegurar que permanezcan sincronizadas con la fuente. Añadir un nuevo formato de salida es una sola entrada en la lista `TARGETS` de `scripts/emit.py`. Los procedimientos se clasifican como `core` a menos que estén marcados con `status: legacy`. Los procedimientos core abordan los fallos reales que tienen los agentes, mientras que los procedimientos legacy son texto de tareas de uso general de 2025 que siguen siendo útiles pero no son lo que hace única a esta biblioteca. La biblioteca incluye una doctrina permanente para `AGENTS.md` en `harness/AGENTS.md` para garantizar que se active cuando no se seleccione ninguna skill. Se proporcionan guías de inicio en `PROMPTS_GUIDE.md` (explica cada prompt y la secuencia recomendada) y `ENVIRONMENT_SETUP.md` (preparar un repositorio para la clonación, instalación y pruebas de agentes). Las opciones de uso incluyen: - Como Agent Skills: Copia los directorios de skills en `.claude/skills/` y pega `harness/AGENTS.md` en el `AGENTS.md` del proyecto. - Como servidor MCP: Configura el servidor en `mcpServers` para exponer los prompts como comandos slash en Claude Code, Claude Desktop, VS Code/Copilot Chat, Windsurf y Zed. El servidor lee el repositorio en vivo, y placeholders como `<PR_URL_OR_DIFF_RANGE>` se exponen como argumentos. - Para humanos: Copia el cuerpo de un archivo de prompt después del front matter YAML y pégalo en la entrada de instrucciones del agente. - Para agentes: Obtén `https://jules-prompts.wecanuseai.com/prompts.json`, selecciona un prompt por título/descripción/categoría y obtén el prompt renderizado desde su URL o lee `_prompts/<slug>.md`. - Contra fixtures: Usa `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` para puntuar un fixture, con veredictos de holds/broken/skipped y una línea de cobertura. Las pautas de contribución enfatizan añadir prompts solo para tareas recurrentes no cubiertas, mantener el front matter YAML alineado, escribir instrucciones agnósticas al entorno, regenerar skills, actualizar guías y flujos de trabajo, añadir fixtures para prompts que detectan fallos y pasar las comprobaciones de integridad.