# MODULAR_EXTENSIONS_GESTURES.md  
### Extensiones de Gestos del Organismo 4GatosCoin  
### Versión 1.0 — 2 de enero 2026

---

## 1. Propósito del documento

Este documento define cómo crear, extender y activar **gestos** dentro del organismo 4GatosCoin.  
Los gestos son la unidad mínima de acción ritual y energética.  
Son el equivalente a “acciones” en otros sistemas, pero aquí tienen significado simbólico y metabólico.

Los gestos:

- generan puntos (respetando el límite diario)  
- activan rituales  
- modifican estados del avatar  
- alimentan el feed vivo  
- despiertan zonas del territorio  
- influyen en seasons  
- generan ecos narrativos  

Las extensiones permiten añadir nuevos gestos, nuevas categorías y nuevas interacciones simbólicas.

---

## 2. ¿Qué es un gesto?

Un gesto es una **acción ritual** emitida por una wallet.

Ejemplos del organismo base:

- `pulse`  
- `echo`  
- `reflection`  
- `loop`  
- `mirror`  
- `dropPlay`  

Ejemplos de extensiones:

- `inner_flame`  
- `forest_whisper`  
- `shadow_step`  
- `resonance_touch`  

Cada gesto tiene:

```json
{
  "type": "gesture_type",
  "wallet": "0x123...",
  "timestamp": 123456789,
  "payload": { ... }
}
3. Categorías de gestos
✔️ 3.1. Gestos energéticos
Aumentan o reflejan energía.

Ejemplos:
pulse, inner_flame, charge

✔️ 3.2. Gestos narrativos
Generan ecos o activan lore.

Ejemplos:
echo, whisper, shadow_step

✔️ 3.3. Gestos sociales
Interacciones simbólicas entre wallets.

Ejemplos:
pulse_to, mirror, echo_to

✔️ 3.4. Gestos rituales
Activan rituales individuales o colaborativos.

Ejemplos:
loop, resonance_touch, eclipse_signal

✔️ 3.5. Gestos territoriales
Interactúan con zonas del territorio.

Ejemplos:
forest_whisper, ignite_zone

✔️ 3.6. Gestos estacionales
Solo existen en ciertas seasons.

Ejemplos:
north_flame, eclipse_mark

✔️ 3.7. Gestos on‑chain (futuros)
Validan acciones mediante transacciones.

Ejemplos:
verified_pulse

4. Hooks disponibles para gestos
Las extensiones pueden escuchar:

onGesture(type)

onGestureSequence([...])

onPointsAwarded

onStreakReached

onRitualTriggered

onTerritoryShift

onSeasonChange

onEcho

5. Endpoints para gestos
5.1. Emitir gesto
json
POST /api/actions/gesture
{
  "wallet": "0x123...",
  "type": "inner_flame"
}
5.2. Consultar gestos de una wallet
json
GET /api/gestures/:wallet
5.3. Emitir gesto social
json
POST /api/actions/gesture
{
  "wallet": "0xAAA...",
  "type": "pulse_to",
  "target": "0xBBB..."
}
6. Arquitectura de un gesto
Un gesto puede incluir:

✔️ 6.1. Tipo
Nombre simbólico del gesto.

✔️ 6.2. Payload
Información adicional opcional.

✔️ 6.3. Impacto energético
Puntos otorgados (si aplica).

✔️ 6.4. Impacto narrativo
Eco, mensaje o trigger.

✔️ 6.5. Impacto ritual
Activación de rituales.

✔️ 6.6. Impacto territorial
Despertar o mutación de zonas.

✔️ 6.7. Impacto en avatar
Cambio de estado o aura.

7. Ejemplos de gestos listos para implementar
7.1. Gesto “Inner Flame”
Categoría: energético

Efecto: +2 puntos

Eco: “Tu llama interior se enciende.”

7.2. Gesto “Forest Whisper”
Categoría: territorial

Efecto: activa WHISPERING_FOREST

Eco: “El bosque te escucha.”

7.3. Gesto “Pulse To”
Categoría: social

Efecto: gesto dirigido a otra wallet

Impacto: activa rituales colaborativos

7.4. Gesto “Eclipse Signal”
Categoría: ritual

Efecto: parte de la secuencia del ritual Eclipse Colectivo

7.5. Gesto “Shadow Step”
Categoría: narrativo

Efecto: activa eco oscuro

Impacto: avatar → shadowed

7.6. Gesto “North Flame”
Categoría: estacional

Efecto: solo disponible en Season 03

Impacto: aura +5

8. Secuencias de gestos
Las extensiones pueden definir secuencias:

Ejemplo:

json
{
  "sequence": ["pulse", "echo", "inner_flame"],
  "effect": "ritual_triggered"
}
Esto permite:

rituales complejos

activación de zonas

transformaciones del avatar

eventos narrativos encadenados

9. Reglas de seguridad para gestos
✔️ No pueden romper el límite de 50 puntos/día
Incluso si son gestos energéticos.

✔️ No pueden introducir toxicidad
Nada agresivo o competitivo.

✔️ No pueden crear jerarquías
Nada de “gestos más valiosos”.

✔️ No pueden saturar el feed
Rate limiting aplicado.

✔️ No pueden contradecir el lore
El nombre y efecto deben ser coherentes.

✔️ No pueden activar loops infinitos
Secuencias deben tener fin.

10. Buenas prácticas para diseñar gestos
✔️ Mantener lo simbólico
El nombre debe evocar una imagen ritual.

✔️ Mantener lo simple
Un gesto debe ser fácil de entender.

✔️ Mantener impacto
Debe sentirse significativo.

✔️ Mantener modularidad
Debe poder existir sin romper otros módulos.

11. Conclusión
Los gestos son el latido mínimo del organismo.
Las extensiones permiten:

nuevos gestos

nuevas secuencias

nuevas interacciones

nuevas resonancias

nuevas conexiones con avatar, territorio y seasons

El organismo está listo para nuevos gestos.
Las rutas están abiertas.