fn_registry/.claude/rules/INDEX.md

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). El padre NUNCA trackea contenido de artefactos hijos (solo .gitkeep); nada de git add -f sobre apps/analysis/projects o deja el padre dirty. 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
33	project_commands.md	Slash commands por project (.claude/commands/<project>/) expuestos via symlink. Desde fn_registry: /<project>:foo. Desde el project: /foo. Sin colision.
34	dod_quality.md	DoD Quality Triada: Mecanica + Cobertura (golden + edge + error path con evidencia ejecutable) + Vida util validada (>=7 dias uso real). Cierra anti-criterios contra checkbox vago. Aplica a dev/flows/ y issues user-facing.
35	llm_invocation.md	Invocacion de LLM: SIEMPRE ask_llm (grupo claude-direct, API directa, arranque 0), NUNCA claude -p (lento, cold start). One-shot/streaming/tool-loop + legacy claude_stream_go_core deprecado.