From bb15b142bfefd7c5aeffda8e27c26f9ace10ac54 Mon Sep 17 00:00:00 2001
From: Egutierrez <egutierrez@dead.dd>
Date: Thu, 16 Apr 2026 23:41:47 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20a=C3=B1adir=20workspace=20efimero=20tem?=
 =?UTF-8?q?p/?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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/.
---
 .claude/CLAUDE.md                  | 1 +
 .claude/rules/apps_vs_functions.md | 9 +++++++++
 .gitignore                         | 3 +++
 3 files changed, 13 insertions(+)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index bb382fd6..464df20a 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -102,6 +102,7 @@ fn-registry/
   cmd/fn/                 # CLI principal
   docs/                   # Specs de diseño
   docs/templates/         # Plantillas de frontmatter
+  temp/                   # Workspace efimero — pruebas, APIs, prototipos (gitignored, no indexado)
 ```
 
 ---
diff --git a/.claude/rules/apps_vs_functions.md b/.claude/rules/apps_vs_functions.md
index 851b64e2..8a8d3dfb 100644
--- a/.claude/rules/apps_vs_functions.md
+++ b/.claude/rules/apps_vs_functions.md
@@ -7,3 +7,12 @@ Criterios para decidir:
 - **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
diff --git a/.gitignore b/.gitignore
index 8a8bcc66..14af4034 100644
--- a/.gitignore
+++ b/.gitignore
@@ -50,6 +50,9 @@ vaults/*/
 # Sources — repos externos clonados (solo se versiona el manifest)
 sources/*/
 
+# Temp — workspace efimero para pruebas rapidas (APIs, scripts, analisis)
+temp/
+
 # C++ build artifacts
 cpp/build/