PCP (Protocolo de Contexto de Proyecto)

Estandariza el Contexto, No la Inteligencia.

Un Contexto de Proyecto. Cada Contribuyente.

PCP (Protocolo de Contexto de Proyecto) es un estándar abierto para preservar, organizar y transferir el contexto del proyecto, de modo que cualquier contribuyente—humano, IA o automatización—pueda continuar un proyecto de software de manera consistente, sin importar quién o qué lo retome después.

¿Por Qué PCP?

Los proyectos de software pierden continuidad todos los días.

El conocimiento se queda dentro de las cabezas de las personas.

Las decisiones importantes desaparecen en los historiales de chat.

La documentación se vuelve obsoleta.

Los asistentes de IA empiezan desde cero porque el contexto del proyecto está fragmentado.

Los nuevos contribuyentes pierden tiempo valioso redescubriendo información que ya existe.

A medida que los proyectos crecen, el contexto se dispersa entre documentación, código fuente, rastreadores de incidencias, chats y experiencia individual.

PCP existe para preservar la continuidad del proyecto.

🚀 Comienza Aquí

📖 ¿Nuevo en PCP? Lee nuestras guías prácticas para principiantes:

• 🇹🇷 Guía en Turco (PCP en 5 Minutos)

• 🇬🇧 PCP Explicado para Desarrolladores de IA

Related MCP server: @context-anchor/mcp-server

⚡ Inicio Rápido (CLI y MCP)

1. Inicializa el Contexto en Cualquier Repositorio

npx @craftsolutions/pcp init --name "My Project"

2. Verifica la Integridad del Contexto (Linter)

npx @craftsolutions/pcp check

3. Conéctate a Asistentes de IA mediante MCP (Cursor / Claude / Antigravedad)

Agrega esto a la configuración MCP de tu IDE:

{
  "mcpServers": {
    "pcp": {
      "command": "npx",
      "args": ["-y", "@craftsolutions/pcp", "mcp"]
    }
  }
}

🔍 ¿Por Qué PCP Frente a Otras Soluciones?

Guía del Repositorio

¿Qué es PCP?

PCP define un estándar de Contexto de Proyecto compartido.

En lugar de enseñarle a cada sistema de IA cómo funciona tu proyecto, PCP estandariza la información que rodea al proyecto en sí.

Esto permite que:

• Humanos

• Asistentes de IA

• Agentes autónomos

• Herramientas de desarrollo

• Futuros contribuyentes

trabajen a partir del mismo entendimiento de un proyecto.

La Idea Central

Los proyectos de software no deberían depender de la memoria.

Deberían depender de un contexto compartido.

PCP crea un Contexto de Proyecto único y estructurado que sobrevive a:

• cambios de contribuyentes

• cambios de modelo de IA

• crecimiento del equipo

• pausas prolongadas en el desarrollo

• evolución de las herramientas

Un proyecto.

Un contexto.

Cada contribuyente.

Principios Fundamentales

• Contexto sobre conversaciones

• Continuidad sobre memoria

• Conceptos sobre archivos

• Abierto por diseño

• Colaboración humana y de IA

• Preserva el conocimiento, no lo redescubras

• Estandariza el contexto, no las herramientas

Cómo Funciona PCP

Contributor
      │
      ▼
Project Context
      │
      ▼
Next Contributor
      │
      ▼
Project Continuity

Cada contribuyente lee el mismo Contexto de Proyecto.

Cada contribuyente abandona el proyecto con mejor contexto del que encontró.

Qué Es PCP

PCP es:

• Un estándar abierto

• Un Protocolo de Contexto de Proyecto

• Un enfoque de continuidad para el desarrollo de software

• Amigable para humanos e IA

• Independiente de la tecnología

• Independiente de la implementación

Qué No Es PCP

PCP no es:

• un marco de IA

• un marco de agentes

• una biblioteca de indicaciones

• una herramienta de gestión de proyectos

• una plataforma de documentación

• un sistema de control de versiones

• una aplicación de base de conocimiento

PCP estandariza el contexto, no la inteligencia, las herramientas ni los flujos de trabajo.

Implementación de Referencia

Este repositorio contiene la implementación de referencia oficial de PCP.

La implementación de referencia utiliza documentos Markdown para demostrar los conceptos definidos por la especificación.

Las implementaciones alternativas pueden usar diferentes formatos de archivo, bases de datos o sistemas de almacenamiento, siempre que preserven los conceptos requeridos definidos por la especificación.

La especificación define conceptos.

Las implementaciones de referencia demuestran implementaciones prácticas.

Estructura del Repositorio

docs/           Specifications and documentation
rfcs/           Design decisions and proposals
reference/      Official reference implementation
examples/       Example projects
assets/         Images and diagrams
scripts/        Development utilities

Estado del Proyecto

⚠️ Diseño Activo

PCP se encuentra actualmente en la fase de especificación.

La prioridad es construir una base conceptual sólida antes de desarrollar herramientas e integraciones.

Hoja de Ruta

• Completar Especificación PCP v0.1

• Publicar Plantilla de Contexto de Referencia

• Ampliar proyectos de ejemplo

• Construir el Validador de Cumplimiento

• Desarrollar la CLI de PCP

• Publicar integración con VS Code

• Publicar integración con MCP

• Lanzar PCP v1.0

Visión

Creemos que los proyectos de software deberían poder continuar sin importar quién—o qué—los retome.

La continuidad del proyecto no debería depender de la memoria.

Debería depender de un Contexto de Proyecto compartido, estructurado y portátil.

Filosofía

No preserves conversaciones.

Preserva el contexto.

Licencia

Licencia MIT.