stradinovstradinov/neb/general/agents.md

neb / general

AGENTS.md1 starsChanged 5 months agoMITView on GitHub

Claude Code expone dos capas de subagentes, con propósitos distintos: Los built-in types claude-code-guide y statusline-setup son de uso interno del harness y no se prescriben en la metodología. Orientativo, no prescriptivo. Claude elige el tipo según el contexto del prompt y el scope real de la tarea. Escalamiento Explore → general-purpose: si Explore devuelve excerpts incompletos o el resultado es ambiguo (el símbolo puede estar en más archivos de los que reportó), relanzar la búsqueda con general-purpose y scope…

In this repository4 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- logbookSkill
- pendings-reviewSkill
- wakeupSkill

The file

Create a free account to mount

Files

agents.md

Tipos de subagente de Claude Code

Claude Code expone dos capas de subagentes, con propósitos distintos:

Capa	Definición	Dónde se configura
Built-in agent types	Predefinidos por Claude Code. Este documento los cubre.	Internos al harness
Custom role agents	Definidos por el equipo en `agents/<nombre>.md`.	`methodology/roles-catalog.md` "Implementación de roles"

Catálogo de built-in agent types

Tipo	Propósito	Tools disponibles	Limitaciones clave
`Explore`	Búsqueda rápida read-only: localizar archivos por patrón, grep de símbolos, responder "¿dónde está definida X?"	Glob, Grep, Read, WebFetch, WebSearch	Lee excerpts — puede perder contenido fuera de la ventana de lectura. NO usar para revisión de diseño, auditoría cross-file ni análisis abierto.
`Plan`	Diseñar planes de implementación: pasos detallados, archivos críticos, trade-offs arquitectónicos	Todo excepto Agent, ExitPlanMode, Edit, Write, NotebookEdit	Devuelve un plan, no implementa. No busca en el codebase (use `Explore` primero).
`general-purpose`	Investigación compleja, búsqueda multi-step, tareas que cruzan múltiples ubicaciones cuando el scope es incierto	Casi todos (*): no recibe las herramientas propias del hilo principal, como AskUserQuestion, plan mode y Workflow (supuesto R17 de `platform-assumptions.md`)	Más costoso y lento que `Explore` para búsquedas simples. Escalar desde `Explore` solo cuando sea necesario.

Los built-in types claude-code-guide y statusline-setup son de uso interno del harness y no se prescriben en la metodología.

Mapeo fase → tipo de agente recomendado

Orientativo, no prescriptivo. Claude elige el tipo según el contexto del prompt y el scope real de la tarea.

Fase	Tipo recomendado	Cuándo
1 Clarificación	`Explore`	Lookup puntual: localizar un símbolo, archivo o path específico. Una sola búsqueda bien definida.
1 Clarificación	`general-purpose`	Investigación abierta: scope incierto, múltiples ubicaciones posibles, pregunta que requiere síntesis.
2 Estimación	`Explore`	Enumerar dependientes (escritura + lectura/display) vía grep cuando el nombre del símbolo es conocido.
2 Estimación	`general-purpose`	Dependientes dispersos, nombre ambiguo o múltiples variantes del símbolo.
3 Plan (diseño)	`Plan`	REQ con múltiples archivos, trade-offs arquitectónicos, o cuando conviene ver el plan antes de ejecutar.
3 Plan-review	Custom role agents	`qa-process-engineer`, `process-improvement-analyst`, etc. Ver `process/plan-review.md`.
4 Implementación	`Explore`	Verificar existencia o signatura de un método antes de editar. Lookup puntual.
4 Implementación	`general-purpose`	Subtarea compleja que requiere búsqueda + análisis + decisión antes de escribir código.
5 Validación	`Explore`	Verificar que un cambio quedó aplicado en todos los archivos esperados (grep de nombre/constante).
9 Improvement	`general-purpose`	Diagnóstico de defecto cross-REQ, revisión de métricas y de la pertinencia de roles.

Regla de selección y escalamiento

Lookup puntual y bien definida          → Explore
Investigación abierta o multi-step     → general-purpose
Diseño de plan arquitectónico          → Plan
Revisión adversarial del plan          → Custom role agent (process/plan-review.md)

Escalamiento Explore → general-purpose: si Explore devuelve excerpts incompletos o el resultado es ambiguo (el símbolo puede estar en más archivos de los que reportó), relanzar la búsqueda con general-purpose y scope explícito. No asumir que el resultado de Explore es exhaustivo.

Cuándo NO usar cada tipo

Tipo	No usar para
`Explore`	Revisión de diseño, auditoría cross-file, análisis que requiere leer archivos completos, preguntas de consistencia global
`Plan`	Buscar en el codebase, implementar código, decisiones que dependen del contexto conversacional activo
`general-purpose`	Lookups simples donde `Explore` basta — costo y latencia innecesarios

Limitación de sesión (custom role agents)

Los custom role agents del plugin de Neb se auto-cargan al inicio de la sesión — no se copian a ~/.claude/agents/. Un agent agregado o editado durante una sesión no está disponible hasta la siguiente (el harness carga las definiciones al arranque); ejecutar /reload-plugins fuerza la recarga sin reiniciar la sesión.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free