skills/personamanagmentlayer__pcl
1
0
Fork 0
mirror of https://github.com/personamanagmentlayer/pcl.git synced 2026-09-14 15:40:22 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
personamanagmentlayer__pcl/docs/INDEX.md
T
ANGX 5c7a89f0d7 chore: reorganize docs, examples, and skills assets 
- Restructure docs and examples directories
- Add stdlib skill packs and language experts
- Add CLI build/init/install commands
- Add build and organization docs and quick references
- Update docs index and project structure
- Move session summaries under docs/sessions
- Consolidate skills test fixtures under tests/skills
- Remove obsolete examples and legacy docs
2026-01-19 07:39:31 +01:00

16 KiB
Raw Permalink Blame History

PCL Documentation Index

Complete guide to all PCL documentation, organized by topic and phase.

🚀 Getting Started

New Users

Core Concepts

📚 Phase 1: Core Language (100% Complete)

Parser & Compiler

Runtime & Execution

Registry System

CLI Commands

Phase 1 Completion

💻 Phase 2.1: IDE Support (100% Complete)

Language Server Protocol

LSP Features

  • Diagnostics - Real-time error detection
  • Completion - IntelliSense with 26 keywords, 13 snippets
  • Hover - Documentation on hover (30+ properties)
  • Definition - Go to definition (Ctrl+Click)
  • References - Find all references
  • Symbols - Document outline
  • Formatting - Auto-format code

VSCode Extension

Phase Completion Documents

🎯 Phase 2.2: Skills Ecosystem (100% Complete)

Skills Overview

🛠️ Phase 2.3: Skills CLI (100% Complete)

Skills CLI Documentation

Skills Commands

  • import - Import skills from SKILL.md format
  • export - Export skills to SKILL.md format
  • validate - Validate skills against specifications
  • list - List all discovered skills
  • info - Show detailed skill information

Skills CLI Compatibility

  • Agent Skills: 100% validation support
  • Claude Code: 95% validation support
  • Bidirectional: Import/export both formats

📦 Phase 2.4: Build System & Package Manager (100% Complete)

Build System Documentation

Package Management Commands

  • pcl init - Initialize new PCL projects
  • pcl build - Build projects to multiple formats
  • pcl install - Install and manage dependencies
  • Lock Files - Reproducible builds with pcl-lock.json
  • Dependency Resolution - Automatic transitive dependencies

Build Output Targets

  • prompt - Text prompts (.prompt.txt) per persona
  • json - JSON representation (.json)
  • yaml - YAML representation (.yaml)
  • typescript - TypeScript types (.ts)
  • markdown - Documentation (.md)

Build System Features

  • NPM-compatible package format
  • Semantic versioning support
  • Version ranges (^, ~, >=, etc.)
  • Circular dependency detection
  • Version conflict detection

Ecosystem Specifications

Skills Usage

Example Skills

  • Python Expert - Python programming skill (270 lines)
  • More skills coming in standard library

Compatibility

  • Agent Skills: 100% compatible (all required + optional fields)
  • Claude Code: 95% compatible (100% core features)
  • Bidirectional: Import/export both formats
  • Progressive Disclosure: 3-tier loading pattern supported

🏛️ Governance & Compliance

Security & Standards

Standards Compliance

  • ISO/IEC 27001 - Information Security Management
  • ISO/IEC 42001 - AI Management System
  • OWASP LLM Top 10 - LLM security best practices
  • EU AI Act - High-risk AI regulation
  • NIST SP 800-207 - Zero Trust Architecture

Compliance Documents

📖 Tutorials & Guides

Beginner

Intermediate

Advanced

🔧 API Reference

Core APIs

LSP APIs

Skills APIs

Code Generation

📋 Examples

Basic Examples

Advanced Examples

Skill Examples

Test Examples

🛣️ Roadmap & Planning

Project Roadmap

Phase Completion Documents

Current Phases (In Progress)

Session Summaries

Future Plans

🧪 Testing & Quality

Test Suites

Quality Assurance

🤝 Contributing

Getting Involved

Community

📜 Legal & Licensing

Licenses

Policies

🔍 Quick Reference

Quick Start Guides

Common Tasks

Task Documentation
Install PCL README.md
Quick Start Quickstart Guide
Create first persona Getting Started
Initialize PCL project Build System Guide
Build PCL project Build Quick Ref
Install dependencies Build System Guide
Use VSCode extension Extension README
Import Agent Skills Agent Skills Guide
Import Claude Code skills Claude Code Guide
Manage skills Skills CLI Quick Ref
Set up registry Registry Guide
Run tests Testing Guide
Deploy to production Deployment Guide

API Quick Links

API Link
parse() Parser API
analyze() Semantic API
createRuntime() Runtime API
RegistryManager Registry API
parseSkillMd() Skill Loader

Specification Quick Links

Spec Link
Language Grammar PCL_GRAMMAR.md
Type System PCL_TYPE_SYSTEM.md
Security Model PCL_SECURITY_MODEL.md
Agent Skills agentskills.io/specification
Claude Code Skills code.claude.com/docs

📊 Documentation Statistics

Category Documents Lines
Core Specs 5 ~10,000
API Reference 15 ~5,000
Tutorials 10 ~3,000
Examples 25+ ~2,000
Phase Completions 8 ~5,000
Skills Documentation 3 ~5,500
Governance 6 ~4,000
Total 70+ ~35,000

🆕 Latest Updates (2026-01-18)

Phase 2.1: LSP Implementation ✅

  • Complete Language Server Protocol with 8 features
  • VSCode extension with syntax highlighting
  • Real-time diagnostics, completion, hover, navigation
  • Full documentation

Phase 2.2: Skills Ecosystem ✅

📞 Support

Getting Help

Reporting Issues

Last Updated: 2026-01-18 Documentation Version: 1.0.0 PCL Version: 1.0.0-alpha

Reference in New Issue View Git Blame Copy Permalink