Files
fn_registry/.claude/rules/INDEX.md
T
egutierrez 4e8b5af6c4 feat(infra): auto-commit con 29 cambios
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 02:06:44 +02:00

4.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
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