a192ee0695
WIP previo al lanzamiento de fn-orquestador piloto. Commit como baseline para que /autonomous-task 0120 arranque con master limpio. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4.6 KiB
4.6 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) |
| 17b | apps_subrepo.md | Apps son sub-repos Gitea (apps/* gitignored). git init dentro de cada app nueva ANTES de limpiar worktree, sino se pierde el codigo |
| 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 |
| 26 | e2e_validation.md | Contrato e2e_checks en app.md consumido por fn-analizador (fase 4 del bucle reactivo). Issue 0068 |
| 27 | registry_calls.md | Patrones canonicos para invocar funciones del registry (MCP inspect / MCP run / heredoc compose), antipatrones, excepciones, telemetria. Issue 0085 |
| 28 | delegation.md | Si vas a escribir logica reutilizable inline -> spawn fn-constructor inmediato + tag de grupo + usar en mismo turno. Issue 0086 |
| 29 | capability_groups.md | Tags planos + paginas madre docs/capabilities/<grupo>.md para desbloquear clusters de funciones en un read. Issue 0086 |
| 30 | function_growth_and_self_docs.md | Contrato self-doc de cada .md (Ejemplo + Cuando usarla + Gotchas + Growth log) + crecimiento del registry por promocion de composiciones a pipelines, NO por inflado de funciones. Issue 0087 |
| 31 | autonomous_loop.md | Reglas para fn-orquestador + /autonomous-task: sandbox obligatorio, paths protegidos, filtro proposals auto-aplicables, watchdog, idempotencia. Issue 0069 |
| 32 | ../../dev/TAXONOMY.md | Allowlist canonica para dominios/tipos/scopes/estados/prioridades + flow patterns. Aplica a dev/issues/ y dev/flows/. Issues 0100 + 0103 |