Context as Code
Gestión de Contexto Git-Native para Proyectos con IA
HCP es un protocolo abierto para gestionar contexto IA en proyectos de software usando Git. Trata el contexto como código versionable y estructurado. Validado por frameworks SPDD de la industria.
¿Qué es HCP?
Resuelve el problema de "deriva de contexto" tratando el contexto IA como código versionable
❌ Sin HCP
- • Contexto perdido entre sesiones
- • Explicaciones repetidas a la IA
- • Sin control de versiones para decisiones
- • Deriva especificación-código
- • Pérdida de conocimiento tribal
✅ Con HCP
- • Contexto persistente, git-native
- • IA lee .procontext/ estructurado
- • Decisiones rastreadas y versionables
- • Contexto = Código (siempre sincronizados)
- • Conocimiento preservado en el repo
Validación Industrial y Académica
HCP está respaldado empíricamente por frameworks SPDD (Structured Prompt-Driven Development)
"Los prompts deben transicionar de texto conversacional informal a artefactos de ingeniería estructurados, versionables y testeables, profundamente integrados con el ciclo de vida del software."— Papers formales SPDD (Structured Prompt-Driven Development)
HCP extiende la base académica SPDD añadiendo gestión de contexto robusta, estados de ciclo de vida predecibles (RPI+C), y el flujo VERIFY estricto requerido para cumplimiento empresarial.
Nuestra arquitectura proporciona la infraestructura verificable necesaria para cumplir los estándares de la EU AI Act.
La Jerarquía HCP
SKILLS (Base)
56 operaciones atómicas: clarify-first, debug-memory-leak, etc.
PATTERNS
23 estrategias componibles: Multi-Agent, Context Engineering
ROLES
Agentes con perfiles acotados para revisión y síntesis
MODOS OPERATIVOS
Niveles de abstracción: Exploración, Diseño, Refactor, Auditoría
Estado RPI+V+C
Conceptos Core
Cuatro patrones fundamentales que hacen funcionar HCP
.procontext/ Structure
Jerarquía de directorio estructurada para features, planning, decisiones, aprendizajes, y sesiones
.procontext/ ├── 01-features/ ├── 02-planning/ ├── 03-decisions/ ├── 04-learnings/ └── 06-sessions/Ver Especificación →
Lifecycle States (RPI+C)
Estados Research → Planning → Implementation → Completed para features
Rastrea progreso de features explícitamente en archivos STATUS.md
Ver Patrones →VERIFY Workflow
Patrón Validation → Evidence → Review → Iterate → Finalize → Yank
Asegura calidad a través de gates de validación estructurados
Ver Patrones →Context Inheritance
Propagación de contexto jerárquico desde nivel proyecto a feature
Principio DRY aplicado a gestión de contexto IA
Ver Patrones →¿Quién Usa HCP?
Desde empresas a desarrolladores individuales
🏢 Empresas
Banca, Salud, Legal — Cumplimiento de contexto, trazabilidad de decisiones, pistas de auditoría
🚀 Startups
Iteración rápida con agentes IA, contexto persistente, sin pérdida de conocimiento en pivots
👨💻 Desarrolladores
Flujos multi-proyecto, pair programming IA, gestión de contexto entre sesiones
🏗️ Arquitectos
ADRs, docs de diseño, decisiones arquitectónicas rastreadas y versionadas
En Números
Production-ready y testeado en batalla
Validado en Producción
8+ meses. 43 proyectos reales. Resultados medidos.
HCP acaba de lanzarse públicamente. Sé de los primeros en adoptarlo y compartir tus resultados.
Empieza en 5 Minutos
Configura HCP en tu proyecto ahora mismo
Clonar e Inicializar
git clone https://github.com/haletheia/human-code-ai-protocol
cd your-project
hcp init Editar Contexto del Proyecto
Añade el contexto de tu proyecto a .procontext/README.md
# Project Context
Stack: Node.js, PostgreSQL, Docker
Architecture: Microservices
Conventions: ESLint, Prettier Configurar tu IDE
Configura integración HCP en Cursor, Windsurf, Cline, Aider, o Codex
Ver guía de integraciones para setup específico de IDE
Empezar a Codear con IA
Tu IA ahora tiene contexto persistente automáticamente. Crea features, documenta decisiones, rastrea aprendizajes.
HCP + MCP Integration
HCP proporciona contexto, MCP proporciona herramientas. Juntos crean agentes más capaces.
| HCP Context | MCP Bridge | Agent |
|---|---|---|
| .procontext/ | stdio / HTTP | Tool Calls |
| session.md | Available Tools | Parallel exec |
| memory/ | Git, Web, DB | State tracking |
Funciona Con HALETHEIA Security Stack
HCP se integra perfectamente con el ecosistema completo de seguridad
- 🛡️ Sentinel: Valida dependencias antes de que IA escriba código
- ⚡ aronly: Optimiza costos de tokens (60-90% ahorros)
- 🎮 babuino: Ejecuta código generado por IA de forma segura en sandbox
Recursos
Documentación, código, y comunidad
📦 Repositorio GitHub
Código fuente completo, templates, ejemplos, y 43+ proyectos en producción
📚 Documentación
Docs técnicas completas: conceptos, guías, referencia, integraciones, ejemplos
🧠 Catálogo de Skills
56 skills profesionales para agentes IA: desarrollo, arquitectura, DevOps, seguridad
🛠️ HCP-Toolkit
Herramientas CLI, servidor MCP, observabilidad, y utilidades de búsqueda
¿Listo para eliminar la deriva de contexto?
Únete a 43+ proyectos usando HCP en producción. Setup en 5 minutos.