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/.
19 lines
1.3 KiB
Markdown
19 lines
1.3 KiB
Markdown
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 fuera `sources/`)
|
|
- **Limpieza**: se puede borrar el contenido en cualquier momento sin consecuencias
|