🎭 PCL - Persona Control Language

$3

![npm version](https://www.npmjs.com/package/pcl-installer)
![npm downloads](https://www.npmjs.com/package/pcl-installer)
![License: MIT](https://opensource.org/licenses/MIT)
![GitHub Stars](https://github.com/IbIFACE-R-D/pcl-lite/stargazers)

![Node.js](https://nodejs.org/)
![TypeScript](https://www.typescriptlang.org/)
![VS Code](https://code.visualstudio.com/)
![Claude Desktop](https://claude.ai/)

Features • Installation • Quick Start • Documentation • Examples • Contributing

---

🎯 What is PCL?

PCL (Persona Control Language) is a revolutionary framework that transforms how developers interact with AI assistants. Instead of generic responses, PCL orchestrates specialized AI personas that work together like an expert team, providing:

- 🎭 20+ Specialized AI Personas - From architecture to security, each persona is an expert in their domain
- 🤝 13 Pre-configured Teams - Ready-to-use combinations for common development scenarios
- 🔄 Multi-Platform Support - Works with Claude Desktop, VS Code, Cursor, ChatGPT, and terminal
- 📊 Persistent Context - Maintain state across conversations and tools
- 🚀 Zero Configuration - Smart installer detects your environment automatically

$3

``diff - Generic AI: "Here's a simple user authentication endpoint" + PCL Team: 🏗️ ARCHITECT: "Let me design a scalable OAuth2 architecture..." 🔒 SECURITY: "I'll add rate limiting, JWT validation, and audit logging..." 💻 DEVELOPER: "Here's the production-ready implementation with tests..." 📝 TECH_WRITER: "And here's the complete API documentation..."`

`🚀 Quick Installation`

`$3`

One command for Windows, macOS, and Linux:

`bash npm install -g pcl-installer`

Or without installing globally:

`bash npx pcl-installer`

That's it! Works on any OS with just Node.js installed. The installer automatically: - ✅ Detects your OS (Windows/macOS/Linux) - ✅ Clones PCL to~/.pcl- ✅ Configures Claude Desktop - ✅ Sets up terminal commands - ✅ Tests the installation

`┌─────────────────────────────────────────────┐ │ 🎭 PCL Cross-Platform Installer │ ├─────────────────────────────────────────────┤ │ Platform: [auto-detected] │ │ Node.js: [your version] │ │ │ │ ✅ Repository cloned │ │ ✅ Scripts configured │ │ ✅ Claude Desktop configured │ │ ✅ Installation complete! │ └─────────────────────────────────────────────┘`


Alternative Installation Methods

#### macOS / Linux (Shell Script)`bash curl -fsSL https://raw.githubusercontent.com/IbIFACE-R-D/pcl-lite/main/install.sh | bash`

#### Windows (PowerShell)`powershell iwr -useb https://raw.githubusercontent.com/IbIFACE-R-D/pcl-lite/main/install.ps1 | iex`

#### Manual Installation`bash git clone https://github.com/IbIFACE-R-D/pcl-lite.git ~/.pcl cd ~/.pcl && npm install`

📖 Installation & Setup Guides: - QUICKSTART.md - 1-page quick start guide - INSTALL_UNIVERSAL.md - Universal npm-based installation - INSTALL_EXAMPLES.md - 9 real-world scenarios - TEST_WINDOWS.md - Complete Windows testing guide - TEST_WINDOWS_QUICK.md - 5-minute Windows quick test - WINDOWS_FIX.md - Windows troubleshooting - INSTALLATION.md - Traditional installation methods

`📚 Documentation`

$3

- Installation Guide - Complete setup for all platforms
- Quick Start - Get up and running in 5 minutes
- Usage Guide - Comprehensive usage instructions

$3

- Practical Examples - 8 step-by-step tutorials
- Real-World Use Cases - 12 production scenarios
- Video Tutorials - Video scripts and guides

$3

- API Documentation - Complete API reference
- Quick Reference - Command cheat sheet
- Configuration - Teams and settings

$3

- Phase 3 Report - Smart installer architecture
- Integration Guide - Custom integrations
- Migration Guide - Version upgrades

`⚡ Quick Start`

`$3`

`bash npx pcl-installer

`Choisir option 1: MCP Server`


Redémarrer Claude Desktop

Dans Claude:`Read pcl://bootstrap Use pcl_team_load with teamId "aral-standard"`

`$3`

`bash

`Générer le contexte`


pcl-bridge team aral-standard
Copier la sortie et coller dans votre conversation

$3

`bash npx pcl-installer

`Choisir option 2 ou 3`


Appuyer sur F5 dans l'extension

$3

`bash pcl-bridge team aral-standard pcl-bridge status ./pcl-helper docs "Topic"

`Scripts spécialisés`


./code-review.sh fichier.js
./security-audit.sh src/
./gen-docs.sh "Topic"


#### 🤖 Avec un assistant IA

1. Ouvrez .persona/BOOTSTRAP_EN.md 2. Copiez tout son contenu 3. Collez-le dans ChatGPT, Claude, ou votre assistant IA 4. Utilisez les commandes/pcl

Voir .persona/BASH_USAGE.md pour le guide complet bash

`$3`

- ARAL_SPEC - Expert en spécification de protocole - ARAL_IMPL - Spécialiste d'implémentation - ARAL_SEC_AUDIT - Auditeur de sécurité - ARAL_CONFORMANCE - Testeur de conformité - ARAL_EDUCATOR - Créateur de tutoriels - ARAL_PRIVACY - Expert en protection des données - ARAL_PERF - Ingénieur performance - ARAL_INTEGRATOR - Expert en intégration

`$3`

- aral-standard- Développement du standard complet -aral-security-audit- Audit de sécurité complet -aral-docs- Documentation -aral-implementation- Implémentation en code -aral-integration - Intégration système

`$3`

- CURSOR_SETUP.md - 🎯 Guide complet pour Cursor IDE - PCL_INTEGRATION.md - Guide d'intégration PCL - .persona/README.md - Documentation complète PCL - .persona/QUICK_REFERENCE.md - Référence rapide - .persona/AI_INTEGRATION.md - Guide pour assistants IA - .persona/INTEGRATION_REPORT.txt - Rapport de statut

`💡 Exemples Pratiques`

`$3`

`bash pcl-bridge team code-review

`Copier la sortie dans ChatGPT/Claude`

`[Contexte PCL]

Peux-tu réviser cette fonction?

function add(a, b) { return a + b; }`

Résultat: Analyse détaillée avec validation, gestion d'erreurs, et JSDoc.

`$3`

`bash pcl-bridge team aral-security-audit`

`[Contexte PCL]

Voici mon middleware d'authentification: [code...]

Fais un audit de sécurité complet.`

Résultat: - Vulnérabilités identifiées (CRITIQUE/HAUTE/MOYENNE) - Code sécurisé avec corrections - Score de sécurité avant/après - Plan d'action

`$3`

`✨ Features`

$3

Each persona is an expert in their domain with specific knowledge, skills, and communication style.

- 🏗️ ARCHITECT - System design & scalability
- 🔒 SECURITY_EXPERT - Vulnerability analysis
- 💻 CODE_REVIEWER - Quality & best practices
- 📱 MOBILE_DEV - iOS, Android, React Native
- 🌐 API_DESIGNER - REST, GraphQL, gRPC
- ⚙️ DEVOPS - CI/CD, Docker, Kubernetes
- 📝 TECH_WRITER - Documentation & guides
- 🧪 TEST_ENGINEER - Testing strategies
- 📊 DATA_ANALYST - Data pipelines & analysis
- 🎨 UI_UX_DESIGNER - User experience

View all 20 personas →

$3

Ready-to-use persona combinations for common scenarios.

- aral-standard - Full-stack development
- aral-security-audit - Security review
- code-review - Code quality analysis
- mobile-dev - Mobile app development
- api-design - API architecture
- devops-pipeline - CI/CD setup
- frontend - Frontend development
- backend - Backend development
- database - Database design
- performance - Performance optimization
- docs - Documentation generation

View all teams →

`$3`

Claude Desktop

_{MCP Protocol Integration}

VS Code

_{Native Extension}

Cursor

_{Extension Support}

Terminal

_{CLI & Scripts}

`$3`

- ⚡ Smart Installer - Auto-detects environment and recommends best setup - 📦 Zero Dependencies - Pure Node.js, no external packages required - 🔄 Persistent State - Context maintained across sessions - 🎚️ Configurable Depth - Control analysis detail level (1-5) - 📊 Multiple Output Formats - Text, Markdown, JSON, YAML - 🌍 Cross-Platform - macOS, Linux, Windows support - 🔐 Secure by Design - No data collection, runs locally

`📊 Project Stats`

| Metric | Value | |--------|-------| | 🎭 Personas | 20 (12 base + 8 ARAL custom) | | 🤝 Teams | 13 pre-configured | | 📦 Installation Methods | 4 (npx, curl, PowerShell, manual) | | 🧪 Test Coverage | 16/16 passing (100%) | | 💾 Package Size | 16.5 KB unpacked | | 📦 Dependencies | 0 (zero dependencies) | | 🌍 Platforms | macOS, Linux, Windows | | 🏗️ Architecture

`pcl-lite/ ├── .persona/ # Core PCL System │ ├── pcl-runtime.js # JavaScript runtime engine │ ├── pcl # CLI executable │ ├── pcl.config.json # Teams configuration │ ├── personas.yaml # Base personas (12) │ ├── personas-custom.yaml # Custom personas (8) │ ├── mcp-server/ # Claude Desktop MCP Server │ │ ├── server.js # MCP protocol implementation │ │ └── install.sh/.ps1 # Platform installers │ ├── scripts/ # Utility scripts │ ├── test/ # Test suite (16 tests) │ └── workflows/ # Example workflows ├── vscode-extension/ # VS Code/Cursor Extension │ ├── extension.js # Extension logic │ └── package.json # Extension manifest ├── install.sh # macOS/Linux installer ├── install.ps1 # Windows installer ├── installer.js # Node.js installer (npx) └── pcl-bridge # Terminal bridge script`

`🛠️ Development`

`$3`

`bash cd .persona node test/pcl-runtime.test.js`

`✅ 16/16 tests passing ✓ Persona activation ✓ Team loading ✓ State management ✓ Command parsing ✓ Multi-platform support`

`$3`

`bash cd .persona node scripts/demo.js`

`$3`

`bash cd .persona node scripts/interactive.js`

`$3`

`bash

`Clone repository`


git clone https://github.com/IbIFACE-R-D/pcl-lite.git
cd pcl-lite
Install dev dependencies (optional)

npm install
Run tests

npm test
Build extension

cd vscode-extension
npm install
npm run build


🤝 Contributing
We welcome contributions! Here's how you can help:


Adding New Personas

1. Edit .persona/personas-custom.yaml:`yaml MY_PERSONA: name: "My Custom Persona" expertise: ["domain1", "domain2"] approach: "Your approach description" focus_areas: ["area1", "area2"]`

2. Test your persona:`bash pcl-bridge activate MY_PERSONA`


Creating Teams

1. Edit .persona/pcl.config.json:`json { "teams": { "my-team": { "name": "My Team", "personas": ["PERSONA1", "PERSONA2"], "depth": 3 } } }`

2. Test your team:`bash pcl-bridge team my-team``

Reporting Issues

Found a bug? Please open an issue with:
- Clear description
- Steps to reproduce
- Expected vs actual behavior
- Your environment (OS, Node version, etc.)

📄 License

- PCL Specification: CC-BY-4.0
- PCL Tools & Implementation: MIT
- ARAL Custom Personas: Project-specific license

🙏 Acknowledgments

- MCP Protocol by Anthropic
- VS Code Extension API
- All contributors and users

🔗 Links

![NPM Package](https://www.npmjs.com/package/pcl-installer)
![GitHub Repository](https://github.com/IbIFACE-R-D/pcl-lite)
![Documentation](https://github.com/IbIFACE-R-D/pcl-lite#documentation)
![Issues](https://github.com/IbIFACE-R-D/pcl-lite/issues)

---

Made with ❤️ by the ARAL Team

Transforming AI interactions, one persona at a time.

Version 1.4.1 | Last Updated: January 15, 2026 | Status: Production Ready ✅

://github.com/pcl-control/pcl) - Spécification officielle
- Documentation locale dans .persona/
- Exemples de workflows dans .persona/workflows/

🤝 Contribution

Pour contribuer au système PCL du projet :

1. Ajoutez des personas dans .persona/pcls-custom.yaml
2. Créez des équipes adaptées à vos besoins
3. Documentez les workflows dans .persona/workflows/
4. Partagez vos configurations avec l'équipe

📄 Licence

- PCL Specification : CC-BY-4.0
- PCL Tools : Apache-2.0
- Configuration ARAL : Suivre la licence du projet ARAL

---

Version PCL : 1.2.0
Date d'intégration : 15 janvier 2026
Statut : ✅ Opérationnel