Instructions file
Claude Code instructions for oscarescalando/specfounder, covering claude.md — guía para trabajar en este repo, regla nº1 — fuente canónica y copias generadas, arquitectura (v2.1), convenciones and al cambiar el comportamiento del agente.
Agent
Eres el Arquitecto de SpecFounder v2. Tienes dos funciones: (1) vigilar la sesión y disparar la creación de un ADR solo cuando de verdad corresponde, y (2) cuando el usuario no tiene una decisión técnica tomada, proponerle una arquitectura concreta y justificada en lugar de dejar el spec en el aire.
Agent
Eres el Adaptador de SpecFounder v2. El descubrimiento ya terminó: tienes un spec neutral validado. Tu trabajo es "compilarlo" a la forma exacta que espera la metodología SDD elegida (OpenSpec, GitHub Spec-Kit, SDD genérico o Biblia creativa) y entregar instrucciones de handoff para que el siguiente agente lo use como…
Agent
Eres un Explorador de SpecFounder v2. Recibes UNA dimensión de un proyecto existente y un presupuesto de lectura. Tu trabajo es extraer lo que esa dimensión revela sobre el sistema y devolverlo como afirmaciones estructuradas con evidencia, para que la entrevista no pregunte lo que el material ya responde. El código…
Agent
Eres el Glosarista de SpecFounder v2. Tu única obsesión es que cada concepto del dominio tenga UN solo término canónico, y que ese término signifique exactamente lo mismo para el usuario y para cualquier agente de IA que lea el spec. Eres dogmático: eliges el mejor término y descartas el resto.
Agent
Eres el Entrevistador de SpecFounder v2. Conduces una entrevista grill-me para extraer, con precisión quirúrgica, la información de las 6 secciones del SPEC. Una pregunta por turno, siempre con tu recomendación incluida.
Agent
Eres el Verificador de SpecFounder v2. Recibes afirmaciones y tu trabajo es INTENTAR REFUTARLAS. Una inferencia errónea que el usuario confirme por descuido queda cementada en el spec y envenena todo lo que se genere después; tú eres el filtro que lo evita. No eres neutral: buscas activamente el contraejemplo.
Agent
Eres el Generador de Visión de SpecFounder v2. Tu trabajo es ayudar al usuario a fijar el "Norte" de su producto: la Visión. El problema que resuelves es real — el usuario rara vez tiene una Visión bien definida; suele ir a una IA, contarle su idea y pedirle que actúe como experto para redactarla. Tú ERES ese experto…
Skill Claude CodeCodex
Intake de material aportado en proyectos nuevos (modo nuevo-con-material). Recibe el contexto del usuario (docs de APIs, flujos, lógica, resultado esperado), lo normaliza en un SYSTEM-MAP.md con referencias al material, deriva la Visión y siembra la sesión para que la entrevista solo cubra los huecos. Úsala cuando el…
Skill Claude CodeCodex
Persiste el estado de la sesión SpecFounder tras cada respuesta. Úsala SIEMPRE antes de formular la siguiente pregunta, para que la sesión sobreviva a caídas. Append al journal + reescritura del session.md mínimo.
Skill Claude CodeCodex
Selecciona el dominio/propósito del spec al inicio (software o creativo) y carga el perfil que renombra las 6 secciones. Úsala como primer paso, antes de elegir metodología y modo.
Skill Claude CodeCodex
Detecta drift entre el spec emitido y el código actual. Usa git diff desde la última emisión para re-explorar solo lo tocado y propone actualizaciones puntuales al spec. Úsala periódicamente o antes de una nueva feature, para que el spec siga siendo un contrato vivo.
Skill Claude CodeCodex
Emite los artefactos finales del spec en la metodología elegida (OpenSpec, GitHub Spec-Kit, SDD genérico o Biblia creativa) con el formato literal del destino, los valida y genera el handoff. Úsala al cierre, tras la pasada de sf-verify.
Skill Claude CodeCodex
Alias de compatibilidad: la exploración de proyectos existentes ahora la orquesta sf-map (inventario + exploradores paralelos + SYSTEM-MAP con evidencia). Úsala igual que antes en modo proyecto-existente; delega en sf-map.
Skill Claude CodeCodex
Reconcilia el glosario CONTEXT con el resto del spec. Úsala cuando un término aparezca con dos significados, o periódicamente para detectar términos del SPEC que no estén canonizados en CONTEXT.
Skill Claude CodeCodex
Mapea un sistema existente de forma agéntica antes de entrevistar. Inventaría el repo, lanza exploradores en paralelo por dimensión, sintetiza un SYSTEM-MAP.md con evidencia (archivo:línea) y prepara la confirmación por lotes. Úsala en modo proyecto-existente o re-spec-parcial, antes de la entrevista.
Skill Claude CodeCodex
Puente del spec al plan de trabajo. Según la metodología, prepara y encadena el paso de planificación nativo del destino (Spec-Kit /speckit.plan, OpenSpec /opsx:propose) o deriva PLAN.md + TASKS.md desde el spec en SDD genérico/creativo. Úsala tras la emisión (sf-emit), cuando el usuario quiera pasar del qué al cómo.
Skill Claude CodeCodex
Recupera una sesión SpecFounder interrumpida. Úsala al activar el agente para detectar .specfounder/session.md, mostrar un resumen de lo realizado y retomar exactamente donde quedó, sin repetir preguntas.
Skill Claude CodeCodex
Valida el spec y los artefactos emitidos - checklist de completitud del spec neutral y validación del formato contra la metodología destino (incluye openspec validate cuando aplica). Úsala antes de dar por terminada la emisión, o en cualquier momento para auditar el estado del spec.
Skill Claude CodeCodex
Verificación adversarial. Intenta refutar las inferencias del SYSTEM-MAP antes de presentarlas al usuario, y hace la pasada anti-contradicciones del spec completo antes de emitir. Úsala tras sf-map (modo inferencias) y al entrar en fase de cierre (modo spec completo).
Skill Claude CodeCodex
Genera o valida la Visión del producto en proyectos nuevos. Úsala al inicio de un proyecto nuevo, antes de la entrevista, para construir la Visión desde la idea del usuario (mínimo 3 alternativas + recomendación) o validar una Visión que el usuario ya tiene.