# PARA Workspace
**Le Framework d'Espace de Travail pour Humains et Agents IA**
[](https://opensource.org/licenses/MIT)
[](../../CHANGELOG.md)
[](https://antigravity.google/)
🇺🇸 English •
🇻🇳 Tiếng Việt •
🇨🇳 ä¸ć–‡ •
🇪🇸 Español •
🇫🇷 Français
---
| Section | Description |
| :-- | :-- |
| [🌌 Vue d'ensemble](#-vue-densemble) | Ce que c'est, les trois principes fondateurs |
| [📂 Architecture](#-architecture) | Structure du dépôt + structure de l'espace de travail généré |
| [📥 Installation](#-installation) | Prérequis, configuration, profils, dépannage |
| [🧠Le Noyau](#-le-noyau) | Invariants, heuristiques, contrats |
| [🛠️ Référence CLI](#-référence-cli) | Toutes les commandes CLI |
| [📑 Catalogue des Workflows](#-catalogue-des-workflows) | 32 flux de travail (workflows) régis |
| [🛡️ Catalogue des Règles](#-catalogue-des-règles) | 14 règles de gouvernance |
| [🧩 Catalogue des Compétences](#-catalogue-des-compétences) | 21 compétences (skills) réutilisables |
| [🔌 Système d'Outils](#-système-doutils-v180) | Installer des plugins d'agents externes |
| [🧩 Gestion des Tâches](#-gestion-des-tâches-modèle-hybride-à -3-fichiers) | Modèle hybride à 3 fichiers |
| [🔄 Mise à jour](#-mise-à -jour-des-versions) | Mise à jour automatique + nouvelle installation |
| [🗺️ Feuille de Route](#-feuille-de-route) | Historique des versions + fonctionnalités prévues |
## 🌌 Vue d'ensemble
**PARA Workspace** est un framework d'espace de travail open source qui définit comment les humains et les agents d'intelligence artificielle organisent les connaissances et collaborent sur des projets. Il est distribué sous forme de **dépôt (repo)** contenant un noyau (constitution), des outils CLI et des modèles — à partir desquels est généré **l'espace de travail (workspace)** où vous travaillez réellement. Le noyau applique des invariants et des règles heuristiques afin que chaque espace de travail soit prévisible, auditable et adapté aux agents IA.
### Trois Principes Fondateurs
1. **Repo ≠Workspace (Dépôt ≠Espace de travail)** — Le dépôt contient la gouvernance (noyau, CLI, modèles) et ne contient jamais de données utilisateur.
2. **Workspace = Runtime (Espace de travail = Environnement d'exécution)** — Généré par `para init`, chaque espace de travail est une instance indépendante où vous et votre Agent travaillez.
3. **Kernel = Constitution (Noyau = Constitution)** — Règles immuables que tous les espaces de travail doivent suivre. Toute modification nécessite une RFC et une augmentation de version.
```mermaid
flowchart TD
R["🏛️ Repo\n(Constitution + Compilateur)"]
W["💻 Workspace\n(Système d'exploitation Runtime)"]
A["🤖 Agent\n(Environnement d'exécution)"]
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
```
---
## đź“‚ Architecture
### Structure du DĂ©pĂ´t (Ce DĂ©pĂ´t)
```
para-workspace/
├── .github/ # 🤖 CI/CD — validate-pr.yml, CODEOWNERS
├── rfcs/ # 📝 Processus RFC — TEMPLATE.md
├── kernel/ # 🧠Constitution
│ ├── KERNEL.md
│ ├── invariants.md # 11 règles strictes (modification nécessite une maj MAJOR)
│ ├── heuristics.md # 10 conventions souples
│ ├── schema/ # Schémas JSON pour workspace, project, backlog, etc.
│ └── examples/ # Exemples de conformité valides/invalides
├── cli/ # 🔧 Compilateur
│ ├── para # Point d'entrée (compatible Bash 3.2+)
│ ├── lib/ # Bibliothèques (logger, validator, rollback)
│ └── commands/ # Commandes (init, scaffold, status, migrate, install, etc.)
├── templates/ # 📦 Échafaudage & Bibliothèques Régies
│ ├── common/agents/ # Workflows, règles, compétences et catalog.yml
│ │ └── projects/ # Modèle .project.yml
│ └── profiles/ # Préréglages (dev, general)
├── tests/ # 🧪 Tests d'intégration
├── docs/ # 📖 Documentation
├── CONTRIBUTING.md
├── VERSIONING.md
├── CHANGELOG.md
└── VERSION
```
### Structure de l'Espace de Travail (Généré par `para init`)
```