Imported from YETY93/atlasmemory (
AGENTS.md). Install upstream withnpx skills add YETY93/atlasmemory. Copyright stays with the author.
AGENTS.md — {{PROJECT_NAME}} (plantilla atlasmemory)
Memoria del proyecto para agentes de IA.
El agente consulta conocimiento, no redescubre el repositorio.
Qué es
{{PROJECT_DESCRIPTION}}
Build
{{BUILD_COMMANDS}}Arquitectura y convenciones detalladas: ver CLAUDE.md y/o README.md si existen.
Reuse-first (obligatorio)
Antes de crear cualquier adaptador de persistencia (*Data), puerto (I*), caso de uso (*UC), entidad, mapper o endpoint (*RS):
- Llama a
catalog_exists(ocatalog_search) con el nombre candidato. - Si
advice=REUSE_EXISTING→ reutiliza o extiende el componente; no crees un duplicado. - Si
advice=CREATE_NEW→ sigue elcreateHint/ checklist de capas. - Tras crear o renombrar componentes relevantes →
catalog_reindex.
Orden de creación si hace falta algo nuevo (hexagonal típico):
port (I*) → adapter/data (*Data) → usecase (*UC) → wiring (UseCaseConfig / DI) → rest (*RS).
Tools de memoria
| Tool | Cuándo |
|---|---|
catalog_exists |
Siempre antes de crear Data/port/UC/entity/mapper |
catalog_search |
Explorar por nombre, método o tag |
catalog_get |
Detalle + métodos de un componente |
catalog_related |
Quién implementa / usa / produce / extends |
catalog_reindex |
Tras cambios estructurales en el código |
Store: .opencode/memory/catalog.json (generado por scripts/index-catalog.mjs).
Si este repo está en un workspace (opcional)
Cuando existe .opencode/tools/workspace.ts, este repo puede consultar las memorias de
sus repos hermanos con workspace_search. Se usa solo después de que
catalog_exists local devuelva CREATE_NEW, y devuelve PRECEDENT_FOUND: patrones a
copiar, no componentes importables. Ver la skill precedent-first y
docs/dos-niveles.md.
Nomenclatura (ajustar al proyecto)
| Rol | Patrón típico |
|---|---|
| Puerto | I* |
| Persistencia | *Data / *Repository |
| Caso de uso | *UC / *Service |
| REST | *RS / *Controller |
| DTO | *Dto |
| Entidad | @Entity |
| Mapper | *Mapper |
Invariantes (ajustar al proyecto)
- Respetar capas y dirección de dependencias del proyecto.
- No inventar componentes que ya existen en la memoria.
- Tras cambios estructurales: reindexar.
Skill
Cargar skill reuse-first cuando la tarea implique crear o localizar persistencia, puertos o casos de uso.
Primera instalación
node scripts/index-catalog.mjs
node scripts/smoke-catalog.mjs # opcional