Commit Graph

2 Commits

Author SHA1 Message Date
ANGX b49437b64d docs: add comprehensive tutorials and reference documentation
Tutorials (Phase 1.1D):
- Tutorial 1: Your First Persona (525 lines)
- Tutorial 2: Teams (518 lines)
- Tutorial 3: Workflows (603 lines)

Examples:
- provider-integration-example.mjs
- workflow-enhancements-example.mjs

Reference:
- docs/reference/SYNTAX.md (695 lines)
- src/grammar/pcl.ebnf (1,058 lines)

Completes Phase 1.1D with 20+ working examples
2026-01-17 06:31:04 +01:00
ANGX 3c0743ab29 docs: add comprehensive quick reference guides and tutorials
Add quick reference cards for Claude and GitHub Copilot:
- CLAUDE-QUICK-REFERENCE.md: Persona commands, templates, efficiency patterns
- COPILOT-QUICK-REFERENCE.md: Request templates, context loading, code patterns
- VSCODE-SETUP.md: Complete VS Code setup guide with extensions, settings, and workflows

Add provider integration example:
- provider-integration-example.mjs: MockProvider, AnthropicProvider demos
- Shows streaming, system prompt building, token tracking

Add Tutorial 1 - Your First Persona:
- README.md: Comprehensive beginner tutorial (10-15 min)
- simple-reviewer.pcl: Basic code reviewer persona
- custom-persona.pcl: CasualMentor with different tone/temperature
- test-simple.mjs: MockProvider testing (no API keys)
- test-with-claude.mjs: Real Anthropic integration
- test-streaming.mjs: Streaming response example
- debug.mjs: Parse debugging utility

Add Tutorial 2 - Teams:
- README.md: Team collaboration guide (15-20 min)
- review-team.pcl: SecurityExpert, PerformanceExpert, QualityExpert team
- test-consensus.mjs: Consensus merge mode demonstration
- Covers 7 merge modes: primary, consensus, majority, append, debate, weighted, random

Add workflow enhancements example:
- workflow-enhancements-example.mjs: Phase 1.1C feature showcase
- Demonstrates condition evaluation, retry logic, timeout handling
- Expression evaluator with boolean/comparison/arithmetic operators
- Built-in functions: length, isEmpty, isNull, isDefined

Add AI provider implementations:
- src/runtime/providers/anthropic.ts: Claude AI integration
- src/runtime/providers/openai.ts: GPT/ChatGPT integration
- Full streaming support, tool calling, vision capabilities
- Token counting, retry logic, error handling

All new documentation follows project standards:
- Consistent formatting with examples and code snippets
- Cross-references between tutorials
- Troubleshooting sections
- Exercises with solutions
- Production-ready code samples

These additions complete Phase 1.1D documentation deliverables.
2026-01-17 01:34:11 +01:00