# Repo Architecture

> Reglas de decisión para archivar páginas nuevas del brain según el tema principal, no el formato ni la fuente. Referencia para todas las skills de escritura.

Fuente: https://skillsagentes.com/skills/garrytan/gbrain/repo-architecture
Markdown: https://skillsagentes.com/skills/garrytan/gbrain/repo-architecture.md

Repositorio: https://github.com/garrytan/gbrain
Autor: garrytan
Licencia: MIT
Actualizado: hace 4 meses
Coste de contexto: 38 tok instalada, 407 tok al activarse, 407 tok con todos los archivos del bundle
Bundle: 1 archivo, 2 KB
Permisos que pide: search, get_page, list_pages

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add garrytan/gbrain --skill repo-architecture --agent claude-code
# Cursor
npx -y skills add garrytan/gbrain --skill repo-architecture --agent cursor
# Codex
npx -y skills add garrytan/gbrain --skill repo-architecture --agent codex
# Gemini CLI
npx -y skills add garrytan/gbrain --skill repo-architecture --agent gemini
# Windsurf
npx -y skills add garrytan/gbrain --skill repo-architecture --agent windsurf
# Cline
npx -y skills add garrytan/gbrain --skill repo-architecture --agent cline
```

## Qué hace

- Determina en qué directorio del brain debe archivarse una página nueva, según el tema principal, no el formato ni la fuente
- Aplica un árbol de decisión: personas, empresas, conceptos, ideas originales, reuniones, medios o datos crudos
- Sugiere enlaces cruzados desde directorios relacionados y verifica la puerta de notabilidad antes de crear la página

## Cuándo usarla

- No está claro en qué directorio debe ir una página nueva
- Se necesita decidir el nombre de archivo o la ruta correcta
- Hay dudas de si archivar por formato, fuente o tema

## Qué la activa

- "¿Dónde debería archivar esta nota sobre una reunión?"
- "Voy a crear una página nueva, ¿en qué carpeta va?"
- "¿Esto se archiva como concepto o como original?"

## Antes de instalar

- Requiere acceso al brain y al archivo skills/_brain-filing-rules.md para las reglas completas.

## Archivos

- SKILL.md — 2 KB

## SKILL.md

Reproducido tal cual desde garrytan/gbrain bajo MIT. Esta sección es el documento original y está en inglés.

# Repo Architecture — Filing Rules

> **Full filing rules:** See `skills/_brain-filing-rules.md`

## Contract

This skill guarantees:
- Every new page is filed by primary subject (not format, not source)
- The decision protocol is followed for ambiguous cases
- Common misfiling patterns are caught

## Phases

1. **Identify the primary subject.** What would you search for to find this page?
2. **Walk the decision tree:**
   - About a person → `people/{name-slug}.md`
   - About a company → `companies/{name-slug}.md`
   - A reusable concept/framework → `concepts/{slug}.md`
   - An original idea → `originals/{slug}.md`
   - A meeting → `meetings/{slug}.md`
   - Media content → `media/{type}/{slug}.md`
   - Raw data import → `sources/{slug}.md`
3. **Cross-link.** Link from related directories.
4. **Check notability.** See `skills/conventions/quality.md` notability gate.

## Output Format

Advisory: "File this at `{type}/{slug}.md` because the primary subject is {reason}."

## Anti-Patterns

- Filing by format ("it's a PDF so it goes in sources/")
- Filing by source ("it came from email so it goes in sources/")
- Creating pages without checking if one already exists
- Using `sources/` for anything except raw data dumps

## Dónde encaja

- Categoría: [Documentos](https://skillsagentes.com/categorias/documentos.md) — Lee, escribe y transforma archivos PDF, DOCX, XLSX y PPTX.
- Creador: [garrytan](https://skillsagentes.com/creators/garrytan.md) — 134 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Setup](https://skillsagentes.com/skills/garrytan/gbrain/setup.md): Configura GBrain con auto-aprovisionamiento de Supabase o PGLite, inyección en AGENTS.md y primera importación.
- [Maintain](https://skillsagentes.com/skills/garrytan/gbrain/maintain.md): Chequeos de salud del brain: aplicación de back-links, auditoría de citas, validación de filing, detección de info obsoleta, páginas huérfanas y benchmarks.
- [Schema Unify](https://skillsagentes.com/skills/garrytan/gbrain/schema-unify.md): Migra un brain de gbrain-base a la taxonomía de 14 tipos canónicos de gbrain-base-v2 usando gbrain onboard --check y el handler Minion unify-types.
- [Retrieval Reflex](https://skillsagentes.com/skills/garrytan/gbrain/retrieval-reflex.md): Cuándo y qué recuperar: abre la página del brain de una entidad relevante antes de responder desde memoria.
- [Minion Orchestrator](https://skillsagentes.com/skills/garrytan/gbrain/minion-orchestrator.md): Skill unificado de Minions para jobs deterministas de shell y orquestación de subagentes LLM: cola durable, observable y controlable, más la doctrina de ejecución durable para operaciones largas.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)