egutierrez
c74d316f00
Documenta la carpeta temp/ como workspace desechable para pruebas rapidas (APIs, scripts exploratorios, prototipos) y la añade a .gitignore. Cambios: - .claude/CLAUDE.md: incluye temp/ en el arbol de estructura del proyecto con la nota de que es efimero, gitignored y no indexado. - .claude/rules/apps_vs_functions.md: nueva seccion "temp/ — workspace efimero" con las reglas de uso (no es codigo del registry, estructura libre, se extrae al registry si algo resulta util, se puede borrar). - .gitignore: añade temp/ para que su contenido nunca se versione. Impacto: los agentes y el humano tienen ahora un lugar claro donde probar cosas sin contaminar el registry ni preocuparse por limpieza. No toca codigo existente ni la estructura de apps/ o functions/.
1.3 KiB
1.3 KiB
Solo codigo reutilizable y componible va en functions/, python/functions/, bash/functions/, frontend/functions/.
Scripts especificos, dashboards hardcodeados, CLIs de un solo uso, y cualquier codigo que no sea una primitiva componible va en apps/. Cada app en apps/ es independiente: puede importar funciones del registry pero nunca al reves.
Criterios para decidir:
- functions/: firma generica, sin credenciales ni config hardcodeada, util en multiples contextos
- apps/: orquesta funciones del registry para un caso concreto, tiene config/credenciales, layout fijo
Las apps Python importan funciones del registry con: sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "python", "functions")) y luego from <paquete> import ... (sin prefijo functions.).
temp/ — workspace efimero
temp/ es un espacio de trabajo desechable para pruebas rapidas: probar una API, un script exploratorio, un analisis puntual, prototipos. Todo gitignored.
- NO es codigo del registry — nada en
temp/se indexa ni se versiona - Estructura libre — subcarpetas por tema:
temp/api_test/,temp/quick_analysis/, etc. - Extraccion: si algo en
temp/resulta util, se extrae al registry con el flujo normal (como si fuerasources/) - Limpieza: se puede borrar el contenido en cualquier momento sin consecuencias