egutierrez
4d5a5bd3ea
- db_migrations.md (nuevo): doctrina archivos numerados, aditivo, idempotente, embed.FS pattern, branch-by-abstraction para destructivos, anti-patrones, inventario retroactivo del ecosistema - INDEX: entrada 25 - CLAUDE.md: nota en cabecera Aplicado retroactivamente en commit paralelo: kanban (003-005), deploy_server (001-002), agents_and_robots/memory (001). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.0 KiB
3.0 KiB
Rules Index
Reglas operativas del proyecto. Cada archivo es una regla independiente.
| # | Archivo | Regla |
|---|---|---|
| 01 | db_locations.md | Ubicacion de registry.db y operations.db |
| 02 | ids_naming.md | Formato de IDs y convenciones de nombres |
| 03 | purity.md | Reglas de pureza funcional |
| 04 | types_in_signatures.md | Tipos nativos en firmas, registry types en .md |
| 05 | stubs.md | Stubs impuros para dependencias externas |
| 06 | assertions.md | Kinds de assertions son texto libre |
| 07 | proposals.md | Quien crea proposals y cuando |
| 08 | function_tags.md | Tags con significado especial: launcher, service |
| 09 | go_packages.md | Nombre de paquete Go = nombre del directorio |
| 10 | apps_vs_functions.md | Codigo reutilizable en functions/, no reutilizable en apps/ |
| 11 | sources.md | Extraccion de funciones desde repos externos |
| 12 | notebook_collaboration.md | Colaboración en notebooks Jupyter via funciones del registry |
| 13 | frontend_theming.md | Componentes propios y sistema de temas en frontends |
| 14 | deploy.md | Deploy de apps a VPS remotos via SSH + systemd + rsync |
| 15 | projects.md | Projects: agrupar apps, analysis y vaults bajo un tema |
| 16 | kiss.md | KISS en proyectos y apps: cuestionar herramientas externas, sin abstracciones especulativas |
| 17 | apps_tbd.md | Trunk-based development obligatorio en apps generadas con fn (registry exento) |
| 18 | uses_functions.md | Convencion de uses_functions para C++: el .md del consumidor declara las dependencias |
| 19 | cpp_apps.md | Estandarizacion de apps C++: estructura, CMake, app.md, sub-repo, runtime — apunta a cpp/PATTERNS.md y cpp/DESIGN_SYSTEM.md como autoritativas |
| 20 | artefactos.md | Termino paraguas para apps, analysis, vaults, projects y playgrounds (todo lo que no es codigo reutilizable) |
| 21 | playgrounds.md | Prototipos rapidos dentro de un artefacto padre — heredan entorno, no se indexan, no tienen repo propio |
| 22 | registry_first.md | Antes de escribir codigo en un artefacto: buscar en el registry, reutilizar si existe, delegar a fn-constructor si falta |
| 23 | fn_doctor.md | fn doctor: diagnostico read-only de artefactos, services, sync drift, uses_functions, unused — wrappers de funciones del registry |
| 24 | feature_flags.md | TBD: feature flags para mergear codigo incompleto sin romper master. Patrones por stack (Go/TS/Bash/Py), branch-by-abstraction, anti-patrones |
| 25 | db_migrations.md | Migraciones SQLite obligatorias para cualquier cambio de schema. Aditivas, idempotentes, archivos numerados. Nunca borrar .db ni modificar migraciones existentes |