mcpedrogm-art

Fia Harness

Name: Fia Harness
Author: mcpedrogm-art

Testing community

SOURCE https://github.com/mcpedrogm-art/fia-harness

Description

Local, dependency-free spec-driven development harness for AI agents: spec-first, machine-validated state and CI enforcement of golden rules. No cloud, no telemetry. Español + English.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

🧬 FIA HARNESS COMPLETO

**El sistema operativo para construir software con agentes de IA.** Especificación antes que código · Seguridad por diseño · Contexto mínimo en cada fase · Cero asunciones en silencio

`Python 3.8+` · `Sin dependencias externas` · `Mono o multi-agente` · `2 modos de trabajo` · `Reglas verificadas en CI` · `LLM-agnóstico` *(funciona con DeepSeek, OpenCode, Claude, GPT o el agente que uses)*

🗺️ El sistema en un vistazo

graph TD
    PRD["📄 PRD.md
documento de negocio"] --> BOOT["⚙️ bootstrap.py
(Fase M0)"]
    BOOT --> CTX["CONTEXT.md
resumen vivo del negocio"]
    BOOT --> PROG["PROGRESS.md
fases M0-M3"]
    CTX --> INT["🧠 Agente de IA
Entrevista técnica (M1)"]
    INT --> SEC["SECURITY.md
AEO_GEO_SEO.md
decisiones en CONTEXT.md"]
    SEC --> SPEC["SPEC.md
especificación aprobada
por el humano (M2)"]
    SPEC --> PLAN["Tabla F0-Fn
en PROGRESS.md (M3)"]
    PLAN --> GEN["🤖 task_generator.py"]
    GEN --> TASK["TASK-F1.md
checklists de seguridad,
visibilidad y UX inyectados"]
    TASK --> RUN["🛠️ Agente ejecuta
auditoría → diseño → código"]
    RUN --> VAL["✅ Fase K
tests · typecheck · lint · build"]
    VAL -- falla --> RUN
    VAL -- pasa --> NEXT["PROGRESS.md actualizado
siguiente fase pendiente"]
    NEXT --> GEN

**La idea central:** el PRD se lee una vez. A partir de ahí, cada fase del agente solo carga 4 archivos comprimidos (`CONTEXT.md` + sección de `SPEC.md` + `PROGRESS.md` + `TASK-Fx.md`). Nunca se reenvía el histórico completo. Contexto pequeño = respuestas más baratas, más rápidas y con menos deriva.

⚙️ Cómo funciona: tres motores

1️⃣ Fases de proceso (M0–M3) — pensar antes de construir

Fase	Qué pasa	Entregable
M0	`bootstrap.py` lee el PRD y activa el harness	`CONTEXT.md` + `PROGRESS.md` + plantillas
M1	El agente te entrevista: stack, BBDD, seguridad, visibilidad, UI/UX,