🎭 PCL - Persona Control Language

Intelligent AI Assistant Orchestration for Software Development

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

Why PCL?

- 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

⭐ Universal Install (Recommended - Works on ALL platforms!)

One command for Windows, macOS, and Linux:

npm install -g pcl-installer

Or without installing globally:

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!                  │
└─────────────────────────────────────────────┘

macOS / Linux (Shell Script)

curl -fsSL https://raw.githubusercontent.com/IbIFACE-R-D/pcl-lite/main/install.sh | bash

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/IbIFACE-R-D/pcl-lite/main/install.ps1 | iex

Manual Installation

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

📖 Getting Started

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

💡 Learning Resources

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

🔧 Technical Reference

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

🚀 Advanced Topics

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

⚡ Quick Start

1. Pour Claude Desktop (Recommandé)

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"

2. Pour ChatGPT / Claude Web

# Générer le contexte
pcl-bridge team aral-standard

# Copier la sortie et coller dans votre conversation

3. Pour VS Code / Cursor

npx pcl-installer
# Choisir option 2 ou 3
# Appuyer sur F5 dans l'extension

4. Terminal / Scripts

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

Personas ARAL

• 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

Équipes prédéfinies

• 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

Documentation

• 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

Exemple 1: Code Review Simple

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.

Exemple 2: Audit de Sécurité

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

Exemple 3: Architecture API

✨ Features

🎭 20+ Specialized Personas

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 →

🤝 13 Pre-configured Teams

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 →

🚀 Multi-Platform Support

🔧 Key Capabilities

• ⚡ 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

Running Tests

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

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

Demo Mode

cd .persona
node scripts/demo.js

Interactive Mode

cd .persona
node scripts/interactive.js

Development Setup

# 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:

1. Edit .persona/personas-custom.yaml:

MY_PERSONA:
  name: "My Custom Persona"
  expertise: ["domain1", "domain2"]
  approach: "Your approach description"
  focus_areas: ["area1", "area2"]

2. Test your persona:

pcl-bridge activate MY_PERSONA

1. Edit .persona/pcl.config.json:

{
  "teams": {
    "my-team": {
      "name": "My Team",
      "personas": ["PERSONA1", "PERSONA2"],
      "depth": 3
    }
  }
}

2. Test your team:

pcl-bridge team my-team

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

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 ✅

🤝 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