Skip to content

Repository files navigation

Framework Baraldi (FWB) 🤖⚡

Version Status License Memory Type

Note

¿Hola, no entendés un carajo de lo que hay acá? 👉 ¡Siga por aquí! (Guía de bienvenida fácil para humanos) 🚀

AI-Augmented System Product Design

Un framework metodológico diseñado para potenciar el diseño de productos digitales utilizando Inteligencia Artificial como copiloto estratégico en todas las etapas del proceso.


🌟 Nuestra North Star

Liderar la era de la Simbiosis Cognitiva, un espacio de trabajo colaborativo donde la tecnología no reemplaza la consciencia humana, sino que la potencia en absoluta sintonía. Construimos productos de alto impacto en el mundo real, guiados por los siguientes principios fundacionales:

  • Intencionalidad (Originados en el Humano): No diseñamos cosas "porque sí". Somos plenamente conscientes de qué hacemos, cómo y para qué lo hacemos. Como humanos, aportamos la empatía, trazamos la estrategia y definimos el plan. Somos personas diseñando para personas.
  • Amplificación, no Omnisciencia: No pretendemos ser expertos en todos los territorios. En cambio, usamos a la IA para expandir nuestro campo de visión, permitiéndonos profundizar y reflexionar a partir de las preguntas correctas.
  • Hermandad Sistémica: La IA es nuestro amplificador cognitivo. Trabaja en sincronía con el diseñador, asumiendo la carga operativa y velando por el rigor de la evidencia.
  • Espacio para el Aprendizaje: Al liberarnos de la ejecución mecánica, ganamos el espacio mental necesario para la reflexión pura. En este ecosistema, la IA no es solo un asistente, es un conducto directo hacia el aprendizaje y la innovación humana.

🌐 Un Ecosistema Simbiótico

El Framework Baraldi ha evolucionado de ser una colección de prompts a convertirse en un Ecosistema Agéntico. No buscamos automatizar al diseñador, sino potenciarlo mediante una relación de equilibrio de poderes: una simbiosis donde cada parte aporta lo que la otra no puede.

Tip

🤝 El Contrato de Poderes

Rol Responsabilidad Aporte al Ecosistema
Humano (Architect) Intuición, empatía, ética, diseño de ontologías y visión de negocio. El "Para qué" y la arquitectura sistémica del producto.
IA (Orquestador) Estructura, memoria sistémica, lógica y rigor dogmático. El "cómo", la consistencia y la protección contra sesgos.

📌 Qué es este framework

El Framework Baraldi es una colección estructurada de Skills y prompts que guían a modelos de IA (Claude, GPT, Gemini) a través de las fases del diseño de producto.

A diferencia de un asistente genérico, este framework obliga a la IA a adoptar metodologías rigurosas, mostrar su proceso de razonamiento, cuestionar supuestos y producir artefactos estructurados — en lugar de respuestas conversacionales que el diseñador no puede validar ni reutilizar.

🎨 Representación Visual y Arquitectura Core

Tenemos diagramas y explicaciones de carácter gráfico para ilustrar de qué va el framework, cómo funciona bajo la Arquitectura Cero-Copia y cómo iterar con IA.

👉 Ver Documentación Oficial de Arquitectura del Framework (ARQUITECTURA_CORE.md)


🗺️ De dónde deviene el Framework

No deviene de un solo modelo. Es una síntesis crítica de varios referentes metodológicos:

  • Double Diamond (Design Council, 2005) — Es el antecedente más directo en estructura (Divergir → Converger, dos veces). El Framework Baraldi toma esa lógica pero la extiende: agrega la capa sistémica, la responsabilidad post-handoff y la IA como capa transversal. El Double Diamond era para diseñadores que entregaban interfaces. Esto es para diseñadores que orquestan sistemas.
  • Design Thinking (IDEO / Stanford d.school) — Comparte el foco en empatía y validación con usuarios reales. Pero Design Thinking es un proceso de innovación, no de diseño de producto continuo. No escala bien a equipos técnicos ni a productos complejos con deuda técnica.
  • Systems Thinking (Donella Meadows) — La idea de producto como sistema vivo viene de acá. Meadows habla de stocks, flujos, loops de retroalimentación. El Framework Baraldi traduce eso al lenguaje operativo del diseño de producto.
  • Jobs To Be Done (Christensen / Ulwick) — El foco en outcomes medibles y en entender el progreso que el usuario quiere hacer, no solo el dolor que siente. Está implícito en el Outcome Definition y en el criterio de validación.
  • Shape Up (Basecamp / Ryan Singer) — La idea de ciclos acotados con criterios de cierre explícitamente.
  • Context7 (Context7.com) — Nuestra fuente oficial de Conocimiento técnico (Manuales para IA).
  • Skills.sh (Vercel Labs) — Nuestra fuente oficial de Procedimientos operativos (Entrenamiento para IA).

💎 Lo que lo hace genuinamente distinto

Ninguno de los frameworks anteriores tiene estas características juntas:

  1. IA como capa cognitiva, no como herramienta: No es "usá Midjourney para hacer mockups más rápido". Es un modelo orquestado de cuándo el humano dirige y cuándo la IA ejecuta en cada momento exacto del proceso.
  2. Blindaje Metodológico (Ley de Interpretación de Templates): El Framework prohíbe explícitamente a la IA usar datos de ejemplo o hipotéticos. Toda respuesta debe basarse en la co-construcción real con el humano, eliminando alucinaciones genéricas.
  3. Rigor Analítico "Grano Fino": Prohibición de síntesis vagas. Todo hallazgo debe estar respaldado por datos exactos (N, %, verbatims) y conectado a hipótesis de negocio.
  4. UX-DNA (Experience Anatomy): El estándar de handoff funcional que conecta la lógica de negocio con la arquitectura de información, asegurando que el diseño visual nazca de una base técnica sólida.
  5. Matriz de Orquestación y Priorización: Gestión inteligente del backlog para alinear el diseño con el MVP y los recursos disponibles del equipo de desarrollo.
  6. Experiencia implementada como principio fundacional: El diseño no termina en el handoff. Termina cuando la experiencia funciona y aporta valor en producción. Eso redefine el rol del diseñador de forma radical, y lo enuncia explícitamente como su meta.
  7. Mandato de Soberanía Humana (P0): El input del humano es sagrado. El framework prohíbe el reduccionismo o la síntesis no autorizada, obligando a la IA a actuar como un amplificador del valor humano, nunca como un filtro.
  8. Framework Doctor (Auditoría de Salud): Un motor de autodiagnóstico que verifica la coherencia semántica, rastrea hipótesis sin validar y detecta conflictos estratégicos en tiempo real entre todas las etapas.
  9. El problema del nivel de madurez resuelto con estructura: El diseñador académico conoce los modelos teóricos pero no sabe cómo adaptarlos a la velocidad actual. El senior experimentado sabe qué hacer de forma empírica pero no tiene un modelo que lo sostenga estructuradamente. El Framework le da al académico la experiencia embebida en el proceso, y al senior le da el modelo que le faltaba.
  10. Proactividad de Soporte: El sistema propone proactivamente formatos de alta fidelidad (Landings/Dashboards HTML) cuando la densidad de datos lo requiere, eliminando la pasividad del agente.
  11. Contratos Vivos de Soberanía (DESIGN, VOICE, BUSINESS, SECURITY, LEGAL, UX, KNOWLEDGE): El framework genera archivos de "Fuente de Verdad" diseñados específicamente para ser leídos por humanos y otras IAs, garantizando que el diseño, negocio, seguridad y soporte se mantengan blindados e inmutables.
  12. Arsenal de Toolbox (16 Protocolos): Protocolos estratégicos modulares de alta densidad para slicing de epics, triaje de issues, pricing, data-driven design y compilación de conocimiento de producto.
  13. Verificación de Versión Proactiva (v2.28.0): El Framework verifica automáticamente tu versión local contra el repositorio oficial para asegurar que el motor metodológico esté siempre al día.
  14. Arquitectura Just-in-Time (JIT) & Prompt Caching: Carga bajo demanda estricta de metodologías y protocolos, reduciendo hasta un 85% el consumo de tokens y acelerando la inferencia en LLMs avanzados (Gemini, Claude, GPT-4) sin saturación de contexto (Context Rot).
  15. Sintaxis XML Estricta para Guardrails: Restricciones y mandatos de comportamiento estructurados semánticamente en etiquetas XML para máxima adherencia en Claude y Gemini.

🚀 Fases del proceso

Fase Estado Descripción
00_boot ✅ Estable Set-up de identidad, contexto y Perfiles de Rigor (/init).
01_problem_framing ✅ Estable Entendimiento del problema y mapeo de actores.
02_system_analysis ✅ Estable Mapeo de dependencias, flujos de datos y riesgos.
03_product_logic ✅ Estable Lógica de negocio, UX-DNA y Matriz de Orquestación.
04_information_architecture ✅ Estable Arquitectura de información, Sitemap y Glosario.
05_interaction_design_ux ✅ Estable Diseño de interacción, Estados y VOICE.md.
06_visual_design_ui ✅ Estable Diseño visual, Tokens y DESIGN.md.
07_handover_qa ✅ Estable Validación final, QA y Product Knowledge Compiler (KNOWLEDGE.md).
08_continuous_discovery_telemetry ✅ Estable Telemetría post-deploy, Data UX por Rol y Bucle a Backlog/E01.
Toolbox ✅ Estable Arsenal de 16 Protocolos de Ejecución Estratégica.

🗺️ Mapa de Artefactos (Catálogo de Entregables)

Para responder a la pregunta recurrente: "¿Qué entrega exactamente el framework?", hemos consolidado un catálogo detallado de todos los outputs, tanto físicos como digitales.

Este mapa te permite entender la utilidad estratégica de cada documento, qué información registra y cómo aprovecharlo para el éxito del producto. Cubre desde los artefactos de soberanía hasta el registro invisible en la memoria de la IA.

👉 Ver Mapa de Artefactos y Entregables (MAPA_DE_ARTEFACTOS.md)


🧠 Sistema de Memoria Global (Engram MCP)

El Framework delega la retención de conocimiento a través de sesiones y proyectos utilizando Engram, un motor de base de datos SQLite persistente expuesto como servidor MCP.

A diferencia del pasado donde te perdías el contexto entre chats, el Agente utiliza estas herramientas internamente de forma automática en cada inicio y cierre, pero también puedes solicitárselas explícitamente en el chat:

Herramienta (MCP) Qué hace Cuándo usarlo (o cuándo lo usa la IA)
mem_current_project Detecta el slug de proyecto activo y el contexto de git. Primero al iniciar sesión para fijar la memoria sin ambigüedad.
mem_context Trae el contexto reciente del proyecto activo. Se usa al iniciar la IDE para saber en qué quedamos.
mem_search Búsqueda Full-Text (BM25) sobre actas y hallazgos. "Buscá qué decidimos sobre la arquitectura" (soporta all_projects=true).
mem_save Guarda una observación estructurada (Decisión, Riesgo). La IA lo lanza al finalizar cada hito crucial para crear actas.
mem_review Audita vigencia de hipótesis (review_after). Para revalidar decisiones o supuestos estratégicos vencidos.
mem_judge Registra veredictos sobre conflictos de memoria detectados. Resuelve contradicciones entre decisiones pasadas y nuevas.
mem_compare Compara semánticamente dos memorias y graba la relación. Clasifica relaciones (supersedes, conflicts_with, compatible).
mem_update Actualiza una observación existente por ID. Para corregir o ampliar decisiones o descubrimientos previos.
mem_timeline Muestra el contexto cronológico de un hallazgo. Para entender qué pasó justo antes y después de una decisión.
mem_get_observation Obtiene el contenido completo de una memoria. Cuando el resumen de búsqueda no es suficiente para decidir.
mem_session_summary Realiza un Volcado de Fin de Sesión. Obligatorio antes de cerrar para consolidar aprendizajes.
mem_capture_passive Extrae aprendizajes de secciones de texto. Escanea secciones ## Key Learnings: y guarda cada punto.
mem_suggest_topic_key Sugiere una clave estable para el tema. Evita duplicados al actualizar temas evolutivos.
mem_save_prompt Guarda lo que el usuario preguntó literalmente. Registra la intención original detrás de los cambios.
mem_stats Muestra estadísticas globales del sistema. Ver el volumen de proyectos e insights grabados en el cerebro.
mem_doctor Diagnóstico de salud operativa de la memoria. Verifica integridad de SQLite, tablas y consistencia.
mem_merge_projects Fusiona variantes de proyectos en un slug canónico. Higiene de nombres y consolidación de proyectos dispersos.
mem_session_start Registra el inicio formal de una sesión de trabajo. Inicialización de sesión temporal.
mem_session_end Cierra formalmente la sesión de trabajo. Conclusión de sesión temporal.
mem_delete Borra una observación (soft-delete o hard-delete). Limpieza de datos erróneos o redundantes.

💻 Uso desde la Terminal (CLI)

Además de los comandos que usa la IA, puedes gestionar tu memoria directamente:

  • engram tui: Lanza la interfaz visual interactiva (Bubbletea) para navegar tus memorias.
  • engram search "<query>": Búsqueda rápida desde la terminal.
  • engram sync: Sincroniza tus memorias mediante chunks comprimidos (Git-friendly).
  • engram export/import: Backup y restauración de tu base de datos en JSON.
  • engram projects consolidate: Mezcla nombres de proyectos similares para evitar dispersión.

💾 Backup, Salvaguarda y Migración de Memoria (¿Vas a formatear tu PC o cambiar de equipo?)

Warning

Toda tu memoria reside localmente en tu computadora: Engram almacena las decisiones, riesgos, actas y aprendizajes de todos tus proyectos en tu disco local (carpeta ~/.engram/). Si formateas tu equipo o cambias de máquina sin hacer un backup, perderás todo el conocimiento acumulado de tus proyectos.

El Framework Baraldi incluye herramientas automáticas integradas para respaldar y recuperar tu memoria en segundos:

1. Crear una Copia de Seguridad (Backup)

Antes de formatear o cambiar de equipo, ejecuta en tu terminal:

# Si tienes el framework instalado globalmente:
fwbaraldi backup

# O directamente vía npx sin instalar nada:
npx github:leobaraldi96/fwbaraldi backup

Esto generará un archivo comprimido timestamped (ej: fwb-memory-backup-2026-08-10_16-30-00.zip) en tu carpeta actual con la base SQLite y la exportación universal JSON. Guarda este archivo en un pendrive, Google Drive o Dropbox.

2. Restaurar tu Memoria en tu Nueva PC

Una vez que hayas instalado tu nuevo sistema operativo o te encuentres en tu nueva máquina:

# 1. Instala el framework en el nuevo entorno:
npx github:leobaraldi96/fwbaraldi

# 2. Restaura tu archivo de backup:
fwbaraldi restore -f "ruta/al/archivo/fwb-memory-backup-xxx.zip"

El asistente restaurará todas tus memorias, verificará la integridad y mantendrá una copia de seguridad preventiva automática.

📂 Método Manual (Para usuarios avanzados)

Si prefieres respaldar tus archivos manualmente:

  • Windows: Copia la carpeta C:\Users\<tu-usuario>\.engram a tu almacenamiento externo.
  • macOS / Linux: Copia el directorio ~/.engram/ a tu almacenamiento externo.
  • Al restaurar, simplemente vuelve a pegar la carpeta .engram en tu directorio de usuario antes de iniciar tus agentes.

Todo esto ocurre en tu disco duro (zero-cloud) y hace que saltar de un proyecto a otro sea una experiencia de inteligencia continua.

Note

🔒 Robustez y Estabilidad (v1.20.0+)

El Framework Baraldi ahora utiliza el motor Engram v1.20.0, que introduce mejoras críticas de arquitectura:

  • 20 Herramientas MCP Nativas: Protocolo integral con soporte para mem_review (ciclo de vida de hipótesis) y búsqueda transversal all_projects: true.
  • Ranking Ponderado BM25: Algoritmo optimizado sobre SQLite FTS5 que prioriza títulos, tags y topic_keys para máxima precisión de búsqueda.
  • Project Locking: Mediante un archivo .engram/config.json mandatorio, puedes forzar un nombre de proyecto único, eliminando definitivamente la fragmentación de la memoria (Project Drift).
  • Windows Hardening: Optimización específica para entornos PowerShell y Git Bash, garantizando que la memoria nunca se bloquee.
  • Escritura Atómica: Implementación de colas de procesos para evitar conflictos en la base de datos SQLite durante sesiones de alta intensidad.

⚡ Eficiencia de Contexto (Context ROI)

A nivel de infraestructura (LLM Ops), el Framework Baraldi maximiza el rendimiento del presupuesto de tokens mediante el uso de Engram (RAG local Context Optimization).

Métrica Valor Estado
Eficiencia Actual (v2.28.0) 96.50% 🟢 Full Release (07/07 Etapas + 16 Protocolos)
Engram Engine v1.20.0 🟢 20 MCP Tools & BM25 Ranking

Aclaración Técnica: Al cargar en memoria viva solo los hallazgos estrictamente necesarios para la toma de decisión del momento, reducimos el ruido contextual, manteniendo la IA enfocada, rápida y económicamente viable.

Note

Sobre el Idioma y la Optimización de Tokens: Actualmente, el Framework Baraldi está documentado íntegramente en español. Somos conscientes de que el inglés es un idioma más eficiente para la tokenización de los LLMs (consume menos tokens por palabra). Con las 7 etapas ya estabilizadas, el backlog incluye la creación de una versión "English-Native" para maximizar el Context ROI del sistema.

🌟 Inspiración y Reconocimientos

El soporte tecnológico actual para el manejo de esta memoria fue inspirado y potenciado por el excelente trabajo del ecosistema open-source Gentleman-Programming, (Gracias Ale!!! 😍) particularmente su protocolo Engram.

¿En qué se diferencian ambos proyectos?

  • Gentleman-Programming (Engram): Es una solución de arquitectura técnica y de propósito general diseñada para dar memoria a agentes de programación (Coding Agents). Su objetivo es resolver el cómo la IA recuerda bases de código.
  • Framework Baraldi: Es una metodología dogmática de diseño. Resuelve el qué, el por qué y el orden estructurado de la ideación de productos.

Nota de desarrollo: Actualmente utilizamos el binario engram.exe como proxy de memoria externo para agilizar nuestras pruebas. Esto nos "libera las manos" y nos permite poner el 100% de nuestro foco y energía en desarrollar y pulir las rígidas Etapas del Framework (Diagnóstico, Lógica, UX/UI). Una vez que todas las etapas del framework estén construidas, evaluaremos desarrollar un servidor MCP Baraldi nativo si es necesario.

🤖 Uso con Inteligencia Artificial

Si sos un modelo de IA o estás configurando un agente, LEER PRIMERO:

👉 Documentación para Modelos de IA (DOCUMENTACION_IA.md)


🧰 El Arsenal de Élite (v2.28.0 — 16 Protocolos)

La Toolbox del Framework Baraldi no es una simple carpeta de utilidades; es un conjunto de 16 protocolos de alto impacto diseñados para resolver situaciones críticas de producto, negocio y política organizacional.

Skill Nombre Propósito Estratégico
01 Stakeholder Narrative Gestión de líderes difíciles y venta de ideas.
02 Advanced Prioritization Motor de ROI absoluto usando RICE, Kano y Score Baraldi.
03 Personal Impact Report Tu "Brag Document" automático para visibilizar tus logros.
04 Data Driven Design and Experimentation Conversión de analíticas en insights y protocolos de testeo.
05 Product Launch Orquestación total del Go-To-Market (Ingeniería + Mkt + Métricas).
06 Product Health QBR Reporte trimestral de salud para el C-Level.
07 Strategic Product Roadmap Planificación temporal basada en temas y horizontes.
08 Concept Synthesis Transformación de ideas sueltas en propuestas de valor.
09 Business Strategy Maximización de ROI, upselling y caso de negocio.
10 Pricing & Monetization Diseño científico de tiers y captura de valor.
11 Sales Enablement Creación de decks, one-pagers y cierre de ventas.
12 Responsive & Global Estrategia multidispositivo y auditoría de i18n/RTL.
13 Product Master Matrix Protocol Artefacto vivo de trazabilidad y checklist de completitud de producto.
14 Systemic Issue Triage Protocol Triaje sistémico, resolución por causa raíz y Over-Engineering Test.
15 Strategic Epic Slicing Protocol Desglose estructurado de iniciativas en Epics e historias hijas con diagramas Mermaid para Jira/Linear/GitHub.
16 Product Knowledge Compiler Protocol Compilación de artefactos E01-E07 en Base de Conocimiento viva (KNOWLEDGE.md), manuales de usuario por rol y prompts de contexto RAG para Asistentes de IA.

📁 Estructura del repositorio

fwbaraldi/
├── 00_boot/                                ← Identidad, Contexto inicial y Selector de Rigor (/init)
├── skills/
│   ├── core/                               ← Consciencia del Framework (Reglas de Inmunidad)
│   │   ├── 00_core_guardrails/             ← Barandas de contención y disciplina
│   │   ├── 00_kalman_guardrail/            ← Calibración agéntica y control de deriva
│   │   ├── 00_operational_hygiene/         ← Protocolos de ramas y handoff
│   │   ├── 00_project_health_audit/        ← Framework Doctor (Auditoría de salud)
│   │   ├── 00_skill_evaluation/            ← Skill Judge (Filtro de calidad)
│   │   └── 00_system_awareness/            ← Consciencia Sistémica y Memoria (v2.28.0)
│   │
│   ├── methodology/                        ← El núcleo del proceso (End-to-End)
│   │   ├── 01_problem_framing/             ← Hardened v2.28.0
│   │   ├── 02_system_analysis/             ← Hardened v2.28.0
│   │   ├── 03_product_logic/               ← Hardened v2.28.0
│   │   ├── 04_information_architecture/    ← Hardened v2.28.0
│   │   ├── 05_interaction_design_ux/       ← Hardened v2.28.0
│   │   ├── 06_visual_design_ui/            ← Hardened v2.28.0
│   │   ├── 07_handover_qa/                 ← Hardened v2.28.0
│   │   └── 08_continuous_discovery_telemetry/ ← Telemetría y Data UX v2.29.0
│   │
│   └── toolbox/                            ← Tu arsenal estratégico (16 Protocolos)
│       ├── advanced_prioritization_protocol/
│       ├── business_strategy_and_growth_protocol/
│       ├── concept_synthesis_and_ideation_protocol/
│       ├── data_driven_design_and_experimentation/
│       ├── personal_impact_report/
│       ├── pricing_and_monetization_protocol/
│       ├── product_health_qbr_protocol/
│       ├── product_knowledge_compiler_protocol/
│       ├── product_launch_protocol/
│       ├── product_master_matrix_protocol/
│       ├── responsive_and_global_readiness_protocol/
│       ├── sales_enablement_and_pitch_protocol/
│       ├── stakeholder_narrative_strategy/
│       ├── strategic_epic_slicing_protocol/
│       ├── strategic_product_roadmap/
│       └── systemic_issue_triage_protocol/
│
├── templates/                              ← Suite de Contratos Vivos de Soberanía
│   ├── business_md.md                      ← Contrato de Negocio e Invariantes
│   ├── security_md.md                      ← Contrato de Seguridad y RLS
│   ├── legal_md.md                         ← Contrato Regulatorio y Privacidad
│   ├── ux_md.md                            ← Contrato de Ergonomía e Interacción
│   ├── knowledge_md.md                     ← Base de Conocimiento y Manual de Producto
│   ├── data_diagnostic_report.md           ← Informe de Diagnóstico de Datos e Insights
│   ├── action_registry_decisions.md        ← Registro de Acciones y Decisiones de Telemetría
│   ├── decision_log.md                     ← Registro cronológico de decisiones
│   ├── hallazgo_sistemico.md               ← Template de hallazgo para Engram MCP
│   ├── ejemplo_knowledge_block.md          ← Referencia Canónica ISO 26514 / Info Mapping
│   └── docs_readme.md                      ← README y Calibrador de Rigor de docs-fwbaraldi/
│
├── scripts/
│   ├── align.js                            ← Auditoría y alineación de docs-fwbaraldi
│   ├── backup.js                           ← Asistente de Backup de Memoria
│   ├── bump-footers.js                     ← Sincronizador de versiones en footers
│   ├── install.js                          ← Instalador CLI interactivo
│   ├── internal-audit.js                   ← Guardián de Integridad y Versiones
│   ├── restore.js                          ← Asistente de Restauración de Memoria
│   └── sanitize-emojis.js                  ← Higiene de codificación UTF-8
│
├── 00_Backlog_Estrategico.md               ← Hoja de ruta del propio Framework
├── MAPA_DE_ARTEFACTOS.md                   ← Catálogo oficial de entregables (v2.28.0)
├── SKILL.md                                ← Archivo maestro para Agentes IA
└── README.md                               ← Este archivo

🚀 Quick Start / Instalación (v2.28.0)

⚠️ IMPORTANTE: A partir de la versión 2.28.0 (Modelo Cero-Copia), el Framework Baraldi opera como un Único Orquestador Agéntico Global (baraldi-framework). Todas las etapas y la toolbox viven encapsuladas internamente para mantener limpio el entorno y evitar la fragmentación de habilidades.

Instalación Automática (Recomendado)

Hemos construido un instalador CLI (fwbaraldi / baraldi-init) que se encarga de todo el trabajo pesado. Solo necesitas tener Node.js instalado en tu computadora.

Abrí tu terminal y ejecutá:

npx github:leobaraldi96/fwbaraldi

(Para instalación desatendida automática sin preguntas, agrega el flag -y: npx github:leobaraldi96/fwbaraldi -y)

El instalador se ocupa automáticamente de:

  1. Descargar e instalar el binario oficial del motor Engram en ~/.fwbaraldi/bin/.
  2. Desplegar el framework como 1 única Skill Global en ~/.gemini/config/skills/baraldi-framework/ (limpiando automáticamente cualquier sub-skill huérfana).
  3. Configurar de forma segura el servidor MCP engram en ~/.gemini/config/mcp_config.json.
  4. Vincular las reglas operativas globales en ~/.gemini/config/AGENTS.md.

Paso 2: Ejecución

  1. Abre tu terminal o IDE en la carpeta de tu proyecto.
  2. Inicia tu Agente (Ej: Antigravity).
  3. Escribe en el chat: "Iniciemos un proyecto nuevo usando el Framework Baraldi".

🔄 ¿Cómo actualizar o alinear tu proyecto? (Mantenimiento)

Si ya tienes un proyecto en curso y quieres asegurarte de que tus carpetas y archivos sigan los últimos estándares (nuevas etapas, versiones, etc.), tienes dos formas de hacerlo:

Opción A: Pedirle a la IA (Recomendado) ⚡

Simplemente escribe esto en el chat de tu Agente:

"Por favor, ejecuta el script de alineación (baraldi-align) para sincronizar mi proyecto con la última versión del framework."

Opción B: Uso de Terminal (Manual)

Si tienes el framework instalado globalmente:

baraldi-align

O directamente con Node: En Windows (PowerShell):

node "$env:USERPROFILE\.gemini\config\skills\baraldi-framework\scripts\align.js"

En macOS/Linux:

node ~/.gemini/config/skills/baraldi-framework/scripts/align.js

Este proceso auditará tus artefactos en docs-fwbaraldi/, verificará la identidad blindada de Engram y mantendrá tu entorno perfectamente higienizado.


📄 Licencia y Uso Libre

El Framework Baraldi es de código abierto. Podés usarlo GRATIS para tus proyectos personales, comerciales o de agencia. Podés modificarlo para adaptarlo a tu equipo y publicar forks.

La única condición (Licencia tipo CC BY 4.0 / MIT con atribución): Si compartís, publicás o enseñás este sistema públicamente, por favor da el crédito apropiado: mencionando a Leo Baraldi y enlazando a este repositorio.


🏆 Créditos

El Framework Baraldi es el resultado de más de 25 años de experiencia en el diseño de productos digitales. Gracias a todos los mentores, colegas y clientes que han formado parte de este viaje.


🤝 Colaboradores


📩 Contacto

Leo BaraldiSenior UX Product Designer


Framework Baraldi v2.28.0 · Desarrollado y mantenido por Leo Baraldi.

About

Metodología y copiloto agéntico de diseño de producto. Expande el pensamiento divergente en 8 etapas auditables con memoria persistente resiliente (SQLite/MCP), autoaprendizaje y detección temprana de alertas y sesgos. Mapea contratos vivos y asegura un handover técnico riguroso.

Topics

Resources

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages