# PARA Workspace
**El Framework de Espacio de Trabajo para Humanos y Agentes IA**
[](https://opensource.org/licenses/MIT)
[](../../CHANGELOG.md)
[](https://antigravity.google/)
🇺🇸 English •
🇻🇳 Tiếng Việt •
🇨🇳 ä¸ć–‡ •
🇪🇸 Español •
🇫🇷 Français
---
| SecciĂłn | DescripciĂłn |
| :-- | :-- |
| [🌌 Descripción General](#-descripción-general) | Qué es PARA Workspace, sus tres principios fundamentales |
| [đź“‚ Arquitectura](#-arquitectura) | Estructura del repositorio + estructura del espacio de trabajo generado |
| [đź“Ą InstalaciĂłn](#-instalaciĂłn) | Requisitos previos, configuraciĂłn, perfiles, soluciĂłn de problemas |
| [🧠El Kernel](#-el-kernel) | Invariantes, reglas heurĂsticas, contratos |
| [🛠️ Referencia de CLI](#-referencia-cli) | Todos los comandos de CLI |
| [📑 Catálogo de Workflows](#-catálogo-de-workflows) | 32 flujos de trabajo (workflows) gobernados |
| [🛡️ Catálogo de Reglas](#-catálogo-de-reglas) | 14 reglas de gobernanza |
| [🧩 Catálogo de Skills](#-catálogo-de-skills) | 21 habilidades (skills) reutilizables |
| [🔌 Sistema de Herramientas](#-sistema-de-herramientas-v180) | Instalar complementos agentic externos |
| [🧩 GestiĂłn de Tareas](#-gestiĂłn-de-tareas-modelo-hĂbrido-de-3-archivos) | Modelo hĂbrido de 3 archivos |
| [🔄 Actualización](#-actualizando-versiones) | Actualización automática + instalación limpia |
| [🗺️ Hoja de Ruta](#-hoja-de-ruta) | Historial de versiones + prĂłximas caracterĂsticas |
## 🌌 Descripción General
**PARA Workspace** es un framework de espacio de trabajo de cĂłdigo abierto que define cĂłmo los humanos y los Agentes de Inteligencia Artificial organizan el conocimiento y colaboran en proyectos. Se distribuye como un **repositorio (repo)** que contiene un kernel (constituciĂłn), herramientas CLI y plantillas — a partir de los cuales se genera el **espacio de trabajo (workspace)** en el que usted realmente trabajará. El kernel impone invariantes y reglas heurĂsticas para que cada espacio de trabajo sea predecible, auditable y compatible con los Agentes IA.
### Tres Principios Fundamentales
1. **Repo ≠Workspace (Repositorio ≠Espacio de trabajo)** — El repositorio contiene gobernanza (kernel, CLI, plantillas) y nunca contiene datos del usuario.
2. **Workspace = Runtime (Espacio de trabajo = Tiempo de ejecución)** — Generado por `para init`, cada espacio de trabajo es una instancia independiente donde usted y su Agente trabajan.
3. **Kernel = Constitution (Kernel = Constitución)** — Reglas inmutables que todos los espacios de trabajo deben seguir. Cualquier modificación requiere un RFC y aumento de la versión.
```mermaid
flowchart TD
R["🏛️ Repo\n(Constitución + Compilador)"]
W["đź’» Workspace\n(Sistema Operativo Runtime)"]
A["🤖 Agent\n(Entorno de Ejecución)"]
R -->|para init| W
W -->|agent attach| A
style R fill:#4a90d9,stroke:#2c5f8a,color:#fff
style W fill:#50c878,stroke:#2e8b57,color:#fff
style A fill:#ff8c42,stroke:#cc6633,color:#fff
```
---
## đź“‚ Arquitectura
### Estructura del Repositorio (Este Repositorio)
```
para-workspace/
├── .github/ # 🤖 CI/CD — validate-pr.yml, CODEOWNERS
├── rfcs/ # 📝 Proceso RFC — TEMPLATE.md
├── kernel/ # 🧠Constitución
│ ├── KERNEL.md
│ ├── invariants.md # 11 reglas estrictas (modificación requiere bumping MAJOR)
│ ├── heuristics.md # 10 convenciones flexibles
│ ├── schema/ # Esquemas JSON para workspace, project, backlog, etc.
│ └── examples/ # Ejemplos válidos/inválidos de cumplimiento
├── cli/ # 🔧 Compilador
│ ├── para # Punto de entrada (compatible con Bash 3.2+)
│ ├── lib/ # Bibliotecas principales (logger, validator, rollback)
│ └── commands/ # Comandos (init, scaffold, status, migrate, install, etc.)
├── templates/ # 📦 Scaffolding & Bibliotecas Gobernadas
│ ├── common/agents/ # Flujos de trabajo, reglas, skills y catalog.yml
│ │ └── projects/ # Plantilla .project.yml
│ └── profiles/ # Preajustes (dev, general)
├── tests/ # 🧪 Pruebas de integración
├── docs/ # 📖 Documentación
├── CONTRIBUTING.md
├── VERSIONING.md
├── CHANGELOG.md
└── VERSION
```
### Estructura del Workspace (Generado por `para init`)
```