soul.md
Valores inviolables del proyecto. Qué NO se va a hacer aunque lo pida el cliente. Se comparte en la primera semana — si hay desacuerdo, se ajusta por escrito antes del kick-off o se declina el proyecto.
Cómo trabajamos
Metodología Genai Sapiens — PRISM-DevMet aplicada a IA boutique
Framework propio de consultoría IA con 6 fases PRISM, ciclos COMBO, AEO/GEO integrado, HITL (Human-in-the-Loop) obligatorio en dominios sensibles y governance transparente con el cliente. Publicamos decisiones, deuda técnica y retrospectivas. Experimenta el proceso en tu próximo proyecto.
Respuesta rápida sobre la metodología
¿Qué es PRISM-DevMet?
PRISM-DevMet es la meta-metodología propia de Genai Sapiens Consulting para proyectos de consultoría e implementación IA. No es un framework genérico adaptado — se diseñó desde cero para proyectos con alta incertidumbre técnica (modelos LLM en evolución constante), alta carga regulatoria (AI Act, RGPD, MDR en medical) y alta exigencia de calidad boutique en el output. Tiene dos componentes acoplados.
PRISM — 6 fases
- Define: Framing TOSCA (Trouble, Owner, Success, Constraints, Actors). Qué problema real se está resolviendo y para quién.
- Decompose: Breakdown MECE — piezas mutuamente excluyentes y colectivamente exhaustivas.
- Map: Systems mapping (Donella Meadows). Palancas de cambio, bucles de retroalimentación, constraints del sistema.
- Synthesize: Propuesta de solución con arquitectura, trade-offs documentados y riesgos identificados antes del kick-off.
- Verify: Validación multi-nivel V0 estructura → V1 fontanería → V2 integración → V3 visual → V4 experiencia → V5 aceptación humana.
- Deliver: Entrega productiva + retrospectiva escrita con aprendizajes, scorecard soul.md y semáforo dimensional.
DevMet — disciplina aplicada
- Taxonomía SKU R/P/I/V/A (Research / Plan / Implementation / Verify / Acceptance). Cada prompt pertenece a un SKU y produce un artefacto verificable.
- Sprints con heartbeats cada 5 prompts de implementación máximo. Sin excepción — "es un fix rápido" no es excusa.
- Ciclos COMBO (OPEN → IMPL → CHECK → CLOSE) para agrupar trabajo coherente con apertura y cierre explícitos.
-
Governance files visibles al cliente (
soul.md,open-decisions.md,known-issues.md) desde la primera semana.
Se aplica a automatización IA empresarial, desarrollo de agentes, compliance AI Act, SEO+AEO+GEO e infraestructura de datos. Si tu proyecto encaja, agenda el assessment 48h gratis.
Los 4 tipos de COMBO
Un COMBO es una unidad de trabajo coherente dentro de un sprint. Agrupa entre 3 y 8 prompts atómicos que comparten un objetivo cerrado. Existen 4 tipos, cada uno con su función específica. Disciplina inviolable: ningún COMBO-IMPL arranca sin COMBO-OPEN previo, ningún COMBO se cierra sin COMBO-CLOSE con retrospectiva escrita.
| COMBO | Función | SKUs dentro | Cuándo se usa |
|---|---|---|---|
| COMBO-OPEN | Contextualización + plan | R-context + P-plan | Al iniciar una fase o sub-fase nueva. Produce documentos de contexto y el plan ejecutable. |
| COMBO-IMPL | Implementación | I-implementation (x N) | Núcleo del sprint. Ejecuta el plan, cada prompt entrega un artefacto concreto. |
| COMBO-CHECK | Heartbeat mid-cycle | A-heartbeat | Tras 5 prompts I máximo. Valida cadencia, deuda acumulada y riesgo de scope creep. |
| COMBO-CLOSE | Cierre + retrospectiva | A-retrospective + V-verify | Cierre de fase. Scorecard contra soul.md, semáforo dimensional, GO/NO-GO merge. |
AEO y GEO como metodología transversal
AEO significa Answer Engine Optimization — optimización para ser citado por ChatGPT, Perplexity, Bing Chat y Google AI Overviews. GEO significa Generative Engine Optimization — estructurar contenido para que los crawlers de modelos de lenguaje lo consuman eficientemente.
Muchas consultoras publican landings genéricas /aeo o /geo con 300 palabras de jerga. Nosotros no. AEO y GEO son parte de la
metodología que aplicamos en cada entregable, no una oferta separada:
- Pirámide invertida en cada página: respuesta directa 30-50 palabras al inicio (KeyTakeaway), contexto después, detalle al final. Los crawlers LLM extraen mejor así.
- FAQPage schema en cada artículo del blog con preguntas reales del usuario y respuestas directas citables por ChatGPT y Perplexity.
- Knowledge Graph propio con Schema.org JSON-LD: Organization, Person, Service, OfferCatalog, HowTo, FAQPage, BlogPosting, BreadcrumbList, LocalBusiness.
- Citation Recon mensual como proxy de Share of Model. Comprobamos qué cita ChatGPT y Perplexity para las keywords target y ajustamos contenido.
- robots.txt LLM-friendly con permisos explícitos a GPTBot, ClaudeBot, PerplexityBot, Google-Extended, anthropic-ai, Applebot-Extended y CCBot.
Ejemplo aplicado: la guía del AI Act España 2026 tiene 6 FAQ con respuestas directas citables, pirámide invertida con KeyTakeaway al inicio y Schema BlogPosting + FAQPage + BreadcrumbList activos. Cuando trabajamos para un cliente, aplicamos estos mismos patrones a su web y contenido — no es un add-on facturable aparte, es parte de cómo hacemos SEO en 2026.
HITL (Human-in-the-Loop) no opcional
HITL significa Human-in-the-Loop: un humano aprueba, corrige o descarta la salida de un sistema IA antes de que se ejecute una acción con consecuencias. En GSC no es opcional — es un requisito de arquitectura en 5 casos obligatorios.
- Decisiones médicas: Diagnóstico asistido, triaje clínico, interpretación de pruebas. Categoría alto riesgo del AI Act (Anexo III). Aplicable al vertical Drwide y consultas privadas.
- Decisiones legales: Redacción de dictámenes, análisis de contratos, recomendaciones procesales. Responsabilidad profesional colegial — la IA redacta, el letrado firma.
- Transacciones financieras: Aprobación de pagos, transferencias y operaciones bancarias por encima de un umbral pactado por escrito. Nunca ejecución automática total sin revisión.
- Contenido cliente externo: Posts redes sociales, emails masivos, respuestas a quejas públicas. Brand safety. El agente propone, un humano revisa antes de publicar.
- Deploys a producción: Ningún agente IA empuja código a producción sin revisión humana. El agente abre pull request, un humano aprueba el merge.
Si un cliente pide explícitamente eliminar HITL en cualquiera de estos 5
casos, declinamos el proyecto. No es negociable ni por precio ni por
relación comercial — es un valor inviolable de soul.md.
Governance y transparencia con el cliente
La opacidad de las consultoras tradicionales (staff augmentation sin visibilidad del proceso, entregables solo al final, decisiones indocumentadas) es incompatible con proyectos IA donde las iteraciones rápidas y los trade-offs técnicos son constantes. Aplicamos 4 mecanismos de governance visibles al cliente desde el primer día.
open-decisions.md
Log de todas las decisiones técnicas autónomas tomadas durante el desarrollo. Cada entrada tiene fecha, decisión, razonamiento, referencia a soul.md y estado APPROVED/REJECTED. Auditable en cualquier momento.
known-issues.md
Deuda técnica documentada con prioridad (P1/P2/P3), esfuerzo estimado y plan de fix. No hay bugs "ocultos" — el cliente sabe qué funciona y qué queda pendiente.
Retrospectivas post-fase
Al cierre de cada fase producimos un documento con aprendizajes, métricas objetivas, scorecard contra soul.md y semáforo dimensional. La retrospectiva de Phase 1 de esta misma web es pública.
Estos documentos viven en el repositorio Git del proyecto (GitHub privado o público según el cliente decida). Todo el histórico queda versionado. El equipo que aplica la metodología en tu proyecto lo presentamos en la página de expertos Claude Code.
Evidencia: esta misma web es PRISM-DevMet aplicado
No hablamos de metodología en abstracto — la aplicamos a nuestros propios productos primero. Esta web genaisapiens.com se migró en Phase 1 siguiendo PRISM-DevMet con evidencia verificable.
- 24 commits conventional: En branch
astro-migration. Cada commit atómico con scope definido (feat(phase-1) / chore(phase-1) / docs(phase-1)). - 26 prompts ejecutados: 11 R-context, 12 P-plan, 23 I-implementation, 2 V-verify, 2 A-retrospective. Cada prompt tiene artefacto y validación asociada.
- Scorecard soul.md 4.1/5 (82%): 3 valores 5/5 (SEO/AEO foundation, premium positioning, compliance by design). 4 valores 4/5. 3 valores 3/5 pendientes de inputs CEO documentados.
- Semáforo 🟢 verde en 7 dimensiones: Estructura, código, deuda técnica, velocidad, visual, performance, dist size. Sin ámbar ni rojo tras re-captura de V3 visual.
- Lighthouse Performance 100 desktop: En 4 de 5 páginas indexables. LCP <1.5s mobile cumplido en home. CLS home mobile 0.118 en borderline (backlog Phase 2).
El tooling interno que usamos está documentado en cómo instalar Claude Code; el proceso de creación de agentes IA aplicando la metodología está en crear un agente de IA paso a paso. Puedes ver resultados concretos de proyectos externos en casos de éxito y donde más se aplica PRISM (retainer con dev IA dedicado) en el vertical IaaS.
¿Cómo se aplica PRISM-DevMet a tu proyecto?
Cuatro pasos secuenciales desde "tengo una idea" hasta "proyecto productivo con retrospectiva escrita". Cada paso tiene entregable cerrado — si paras a mitad, te llevas el trabajo hecho. Tiempo total típico: 3-6 semanas para un pilot MVP, 8-16 semanas para producción con compliance alto riesgo.
- 1
Assessment inicial 48h (PRISM Define + Decompose)
Recibimos tu caso, aplicamos framing TOSCA y descomponemos el problema MECE. Entregable: validación de si el caso tiene ROI real, sin coste ni compromiso comercial.
- 2
Plan ejecutivo (PRISM Map + Synthesize)
Mapeo de sistema con palancas y constraints, propuesta de arquitectura, trade-offs y riesgos documentados. Entregable: plan escrito con hitos medibles y criterios de aceptación.
- 3
Implementation en COMBO-IMPL (ciclos 2 semanas)
Sprints con heartbeats cada 5 prompts máximo, commits conventional, governance files actualizados en cada decisión. Entregable: artefactos verificables al final de cada ciclo.
- 4
Entrega + retrospectiva (COMBO-CLOSE)
Validación V0-V5, scorecard contra soul.md del proyecto, semáforo dimensional, GO/NO-GO, retrospectiva escrita con aprendizajes. Entregable: proyecto productivo + documento de cierre auditable.
Preguntas frecuentes sobre la metodología
Preguntas frecuentes sobre la metodología
¿Se aplica PRISM-DevMet a proyectos pequeños (menos de 10.000 €)?
Sí, pero en versión ligera. Los pilotos MVP de 3.500 – 6.000 € aplican PRISM Define + Decompose + Synthesize + Deliver en ciclos de 2 semanas, sin el overhead de governance completo. A partir de 10.000 € se activa el stack completo con los 4 governance files (soul.md, open-decisions.md, known-issues.md, retrospectivas) visibles al cliente desde la primera semana.
¿Cambia la metodología según el cliente o el sector?
Los valores inviolables de soul.md son los mismos en todos los proyectos (HITL obligatorio en los 5 casos, commits atómicos, retrospectiva escrita). Cambia la cadencia de heartbeats, el peso relativo de cada fase PRISM (un proyecto medical pesa más en Verify, un proyecto SEO pesa más en Map) y la profundidad de compliance (Drwide activa AI Act alto riesgo completo, un chatbot WhatsApp no).
¿La documentación de governance se comparte siempre con el cliente?
Sí, desde la primera semana. soul.md, open-decisions.md, known-issues.md y las retrospectivas viven en el repositorio Git al que el cliente tiene acceso de lectura desde el inicio. Si un cliente prefiere repo privado, se respeta — pero la visibilidad al cliente del proceso es inviolable.
¿Se puede copiar PRISM-DevMet para aplicarlo internamente?
La metodología no está bajo licencia propietaria. Cualquiera puede estudiar cómo trabajamos y adaptar los patrones a su equipo. Lo que no se puede es usar la marca "PRISM-DevMet" como producto propio sin autorización. Nuestro valor no está en el nombre — está en ejecutarlo bien y de forma consistente.
¿Existe certificación oficial en PRISM-DevMet?
No. No es un framework certificable ni buscamos serlo. Es metodología interna documentada con ejemplos reales aplicados. La evidencia es la salida: proyectos entregados con scorecard contra soul.md y retrospectiva pública auditable.
¿Cómo se diferencia de metodologías ágiles tradicionales (Scrum, Kanban)?
Scrum y Kanban son frameworks de gestión de equipos — no dicen qué decisiones técnicas tomar ni cómo validar calidad IA. PRISM-DevMet es más cercano a metodologías de ingeniería (Toyota Production System, Design Thinking) adaptadas a proyectos IA con alta incertidumbre regulatoria. Se puede usar encima de Scrum (un sprint 2 semanas = un COMBO típico) sin conflicto.