elixir-expert

PCL (Persona Control Language) is a governance-first programming language for AI persona management and multi-agent orchestration. Unlike traditional application languages, PCL is designed for accountability, security, and compliance in AI systems.

PCL = Terraform + OpenPolicyAgent + AI Personas

PCL enables enterprises and developers to:

• Define personas with explicit capabilities, constraints, and risk classifications (ISO 42001)
• Govern AI behavior through auditable policies and access controls (ISO 27001)
• Orchestrate complex multi-agent workflows with human oversight
• Deploy consistently across Claude, GPT, Gemini, Azure, and open-source LLMs
• Audit every action with immutable logs aligned to compliance frameworks
• Comply with EU AI Act, GDPR, OWASP LLM Top 10, and Zero Trust principles

---

```pcl

// Define a security analyst persona

pub persona SEC {

intent: "Identify and mitigate security vulnerabilities"

tone: vigilant

skills {

"OWASP Top 10"

"STRIDE threat modeling"

"Security code review"

}

constraints {

"Always assume breach"

maxResponseTime <= 5s

}

}

// Compose a security review team

pub team SecurityReview {

members: [SEC, AUDIT, ARCHI, CRITIC]

primary: SEC

merge: Debate

quorum: 3/4

}

// Define a code review workflow

pub workflow CodeReview {

steps: DEV -> (ARCHI || SEC) -> CRITIC -> merge(Consensus)

timeout: 60s

fallback: SIMPLIFY

}

```

---

```bash

# Clone the repository

git clone https://github.com/personamanagmentlayer/pcl.git

cd pcl

# Install dependencies

npm install

# Build PCL

npm run build

# Verify installation

node dist/cli/index.js --version

```

[📖 Complete Installation Guide →](docs/INSTALLATION.md)

---

Getting Started

• [Quick Start Guide](docs/QUICK_START.md) - Get started in 5 minutes
• [Core Concepts](docs/CORE_CONCEPTS.md) - Personas, Teams, Workflows, and more
• [Installation Guide](docs/INSTALLATION.md) - Complete setup instructions
• [Features Overview](docs/FEATURES.md) - All features and capabilities

For Developers

• [Getting Started Tutorial](docs/guides/GETTING-STARTED-CURRENT.md) - Practical working introduction
• [VS Code Setup](docs/guides/VSCODE-SETUP.md) - IDE configuration
• [Testing Guide](docs/testing/TESTING_STATUS.md) - Test coverage and benchmarks
• [API Reference](docs/api/) - Parser, Semantic Analysis, Code Generation

Specifications & Standards

• [PCL Specification v1.0](SPEC/PCL_SPEC_v1.md) - RFC-style formal specification
• [Governance Framework](GOVERNANCE/PCL_GOVERNANCE.md) - ISO 38500-aligned governance
• [Security Model](GOVERNANCE/PCL_SECURITY_MODEL.md) - ISO 27001/42001 security architecture
• [Standards Overview](GOVERNANCE/STANDARDS_OVERVIEW.md) - Complete standards alignment

Complete Documentation Index

[📚 Full Documentation →](docs/README.md)

---

Production-Ready Testing ✅

• 5,720 total tests (96.3% pass rate)
• 50.66%+ code coverage (targeting 90%)
• 153 test files covering all major modules
• Comprehensive testing: LSP, Observability, MCP, Registry, Providers, CLI, Codegen, Parser, E2E

[📊 Testing Status →](docs/testing/TESTING_STATUS.md) | [🗺️ Coverage Roadmap →](docs/testing/COVERAGE_ROADMAP.md)

Supported AI Providers (8)

Anthropic Claude • OpenAI GPT • Google Gemini • DeepSeek • Ollama • Azure OpenAI • AWS Bedrock • Mock

[🤖 Provider Guide →](docs/providers/README.md)

Core Capabilities

• ✅ Language Server Protocol (LSP) - Full IDE support with IntelliSense, diagnostics, navigation
• ✅ Skills Ecosystem - 100% compatible with agentskills.io and Claude Code
• ✅ Model Context Protocol (MCP) - Expose personas as standardized AI services
• ✅ Registry System - 4 backends (Memory, JSON, SQLite, PostgreSQL)
• ✅ Observability - Metrics, SLO tracking, tracing, telemetry, health checks
• ✅ Code Generation - Multi-target compilation (TypeScript, Python, JSON, YAML, Markdown)

[🎯 Complete Features List →](docs/FEATURES.md)

---

Status: 🟡 APPROACHING PRODUCTION READY

Production Readiness Score: 78/100 (+33 from January 2026)

• ✅ Safe for: Development, prototyping, proof-of-concept, internal tools, beta testing
• 🟡 Approaching: Production, customer-facing applications (after final security audit)
• ❌ Not yet ready for: High-stakes regulated systems (needs 90% coverage)

[📈 Production Readiness Report →](docs/PRODUCTION-READINESS.md)

---

Phase 1: Foundation ✅ COMPLETE

• ✅ Core compiler implementation
• ✅ 8 AI provider integrations
• ✅ Registry system with 4 backends
• ✅ 50%+ test coverage baseline

Phase 2: Ecosystem ✅ COMPLETE

• ✅ Language Server Protocol (LSP)
• ✅ VS Code extension
• ✅ Skills ecosystem integration
• ✅ Model Context Protocol (MCP)

Phase 3: Scale (Q2 2026)

• 🔄 Advanced merge strategies
• 🔄 Event streaming & observability
• 🔄 90% test coverage
• 🔄 Production security audit

Phase 4: Maturity (Q4 2026)

• 📅 Visual debugging tools
• 📅 Performance profiling
• 📅 Cloud deployment
• 📅 Marketplace

[🗺️ Complete Roadmap →](.roadmap/ROADMAP.md)

---

• 📖 [Documentation](docs/README.md) - Complete guides and API reference
• 🐛 [GitHub Issues](https://github.com/personamanagmentlayer/pcl/issues) - Bug reports and feature requests
• 💬 [Discord](https://discord.gg/pcl-lang) - Community discussion
• 🐦 [Twitter](https://twitter.com/pcl_lang) - Updates and announcements

---

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

```bash

# Fork and clone the repository

git clone https://github.com/YOUR_USERNAME/pcl.git

cd pcl

# Install dependencies

npm install

# Run tests

npm test

# Build the project

npm run build

```

[📋 Contributing Guide →](CONTRIBUTING.md) | **[📜 Code of