Opcional · compañeros de cursada
Página de primera vez: qué es un agente, cómo dejar reglas en tu repo y qué no pedir. No es trabajo de la materia ni un proceso nuevo del equipo. El manual largo sigue en el otro HTML.
Es un asistente dentro del editor. Puede leer archivos del proyecto, proponer cambios y, si lo permitís, editar o correr comandos. No es un buscador ni el corrector de la cursada: vos pedís una tarea concreta y revisás lo que hace.
Usarlo es opcional. No reemplaza al profesor ni al equipo.
Cada conversación es un hilo aparte. El agente no trae el chat de ayer salvo que vos se lo pegues. Por eso las reglas que querés siempre (cómo commitear, qué no tocar, el stack) no se escriben en el chat: van en un archivo del repo.
AGENTS.md en tu repoEl archivo vive en la raíz de tu proyecto (el de la materia o el del trabajo), no en este kit. Cursor suele leer AGENTS.md; Claude Code, CLAUDE.md. La herramienta lo carga sola: no lo pegues en el chat.
docs/).AGENTS.md (Cursor y la mayoría). Si usás Claude Code, creá CLAUDE.md o un CLAUDE.md de una línea que importe @AGENTS.md.# AGENTS.md
- Stack: React + Vite. Rutas en `src/pages/`, UI en `src/components/`, HTTP en `src/api/`.
- El componente no llama `fetch` ni `axios`. Usa el cliente de `src/api/`.
- No inventes endpoints, pantallas de login ni datos de negocio que el ticket no nombre.
- Ticket acotado: tocá solo los archivos nombrados.
- Sin store nuevo (Redux / Zustand) si nadie lo pidió.
- Tests: `npm test`. Si hay spec del síntoma, extendelo; no armes Cypress de paso.
- No commit ni push salvo que lo pida el chat.# AGENTS.md
- Stack: Spring Boot, un deploy. Controller → service → repository.
- El controller no tiene SQL ni EntityManager. JSON = DTO, no entidad JPA.
- No inventes tablas, endpoints ni módulos Maven que el ticket no nombre.
- Un GET o POST nuevo copia el vecino del mismo paquete.
- Sin hexagonal ni microservicio de paso.
- Tests: `./mvnw test`. JUnit del patrón del módulo.
- No commit ni push salvo que lo pida el chat.Si el repo es mixto (front + API), la raíz nombra quién habla con quién; el detalle de React o de JPA va en un MD anidado. Ficha: portable-agents.md.
El MD se inyecta al abrir la sesión. Editar el archivo a mitad de conversación no actualiza ese hilo solo.
Carga el MD actual del disco. Usalo después de editar reglas, si el hilo está inflado, o para un ticket distinto.
Sigue con lo que ya inyectó (y con el historial). Útil para el mismo síntoma. No sirve para “probar” un MD recién cambiado.
Claude Code lee CLAUDE.md al inicio. No lo relee en cada turno. Un cambio entra en la próxima sesión, o en la actual con /compact o /memory. Cursor combina AGENTS.md y reglas .mdc; no dupliques el mismo texto en ambos. Pedirle al agente que lea el path es un parche, no la inyección automática.
Fuentes: CLAUDE.md (Anthropic) · Give Claude context · Cursor Rules.
Los nombres de menú cambian; la lógica no. Ticket chico o un typo: modelo rápido. Arquitectura, diseño o “por qué falla esto”: modelo que razona.
Al filtrar el listado de pedidos, la página no vuelve a 1. Archivos: OrderFilter.tsx, OrderList.tsx. Mismos componentes, mismo cliente HTTP.
El listado y el detalle no comparten el estado del envío. Hay que decidir un solo lugar, sin meter un store que el repo no tiene.
El MD está en el repo. Quien clone tiene las mismas reglas. No vive en tu cuenta del editor ni en un chat. Un PR de reglas viaja con el código.
El GET de envíos ya existe. El ticket pide eventos del envío. Mismo paquete, mismas capas. No un events-service.
Scaffold fresco (Vite + Spring o el par del equipo). Primero el mapa de carpetas en el MD. La primera pantalla es otro chat.
Fichas para enviar: casos-practicos-legacy-y-nuevos.html.
Cada línea del archivo entra en cada chat. Quince líneas del mapa se leen y se respetan. Un tratado de 400 se paga en tokens y el medio se ignora. No dupliques las mismas reglas en AGENTS.md y en .cursor/rules.
Anthropic recomienda CLAUDE.md corto (~200 líneas): más texto reduce el cumplimiento. Cursor: reglas de proyecto por debajo de ~500 líneas. Un archivo enorme no es un candado de seguridad: secretos y prod se cubren con permisos, hooks y CI.
Capítulo: #cuidar-tokens.
Los HTML se abren en el navegador (doble clic o “Open in Browser”). En GitHub, la vista “blob” muestra el código crudo. Los .md en Pages suelen bajarse o verse como texto.
Versión publicada: webconreeb.com/docs/guia-principiantes.html.
CLAUDE.md: code.claude.com/docs/en/claude-md