version: 2.0.0
name: university-courses
description: Course content for Paradigm University — 8 courses, 82 lessons. Each lesson is mapped to the Paradigm concepts it teaches so that ripple analysis can identify which lessons need updating when a concept changes.

components:
  # PARA 001: Quick Start (3 lessons)

  para-001-shift-setup:
    description: "Quick Start — Your First paradigm shift: one-command setup, what gets created"
    file: para-001.json
    tags: [course-content, para-001]
    references: ["#shift-command", "#enforcement-hooks"]

  para-001-meet-the-team:
    description: "Quick Start — Meet Your Agent Team: 8 core agents, tiers, Maestro model"
    file: para-001.json
    tags: [course-content, para-001]
    references: ["#orchestration", "#agent-loader"]

  para-001-build-something:
    description: "Quick Start — Build With the Team: full orchestration loop, quick-check, commit conventions"
    file: para-001.json
    tags: [course-content, para-001]
    references: ["#orchestration", "#symbol-system", "#enforcement-hooks"]

  # PARA 101: Foundations (9 lessons — reordered: first-steps at position 2)

  para-101-welcome:
    description: "Welcome to Paradigm — three pillars, why structured context matters"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#symbol-system", "#purpose-files", "#mcp-tools", "#paradigm-logger"]

  para-101-five-symbols:
    description: "The Five Symbols — #component, $flow, ^gate, !signal, ~aspect"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#symbol-system"]

  para-101-purpose-files:
    description: "Purpose Files — YAML format, required fields, directory-level docs"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#purpose-files"]

  para-101-tags-and-classification:
    description: "Tags and Classification — tag bank, core tags, custom tags, AI suggestions"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#tag-system"]

  para-101-paradigm-logger:
    description: "Paradigm Logger — symbol-typed logging, directory-to-symbol mapping"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#paradigm-logger", "#symbol-system"]

  para-101-project-structure:
    description: "Project Structure — .paradigm/ directory, config.yaml, navigator.yaml"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#scan-index", "#navigation"]

  para-101-portal-yaml:
    description: "Portal YAML — gates, routes, authorization topology"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#portal-protocol"]

  para-101-first-steps:
    description: "First Steps — paradigm init, paradigm shift, stack auto-detection, cold start for existing projects"
    file: para-101.json
    tags: [course-content, para-101]
    references: ["#symbol-system", "#purpose-files", "#scan-index", "#stack-presets", "#cold-start"]

  # PARA 201: Architecture (11 lessons)

  para-201-flows-deep-dive:
    description: "Flows Deep Dive — $flow definitions, step types, validation"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#flow-validation", "#symbol-system"]

  para-201-gates-deep-dive:
    description: "Gates Deep Dive — ^gate chaining, portal.yaml routes, enforcement"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#portal-protocol", "#enforcement-hooks"]

  para-201-aspects-and-anchors:
    description: "Aspects and Anchors — ~aspect definitions, anchor format, why anchors are required"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#aspect-anchoring"]

  para-201-aspect-graph:
    description: "Aspect Graph Introduction — condensed overview, 5 categories, 7 MCP tools, pointer to PARA 501 for internals"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#symbol-graph", "#aspect-anchoring"]

  para-201-portal-protocol:
    description: "Portal Protocol — full authorization model, gate patterns, route declarations"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#portal-protocol"]

  para-201-disciplines:
    description: "Disciplines and Stack Presets — 14 disciplines, 16 stack presets, auto-detection, framework-specific config"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#symbol-system", "#stack-presets", "#disciplines"]

  para-201-symbol-naming:
    description: "Symbol Naming — kebab-case, PascalCase, conventions"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#symbol-system"]

  para-201-component-patterns:
    description: "Component Patterns — service, handler, model, utility patterns"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#symbol-system", "#purpose-files"]

  para-201-signal-patterns:
    description: "Signal Patterns — event naming, emitters, side effects"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#symbol-system"]

  para-201-cross-cutting-concerns:
    description: "Cross-Cutting Concerns — aspects across components, enforcement strategies"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#aspect-anchoring"]

  para-201-architecture-review:
    description: "Architecture Review — comprehensive review of PARA 201 concepts"
    file: para-201.json
    tags: [course-content, para-201]
    references: ["#flow-validation", "#portal-protocol", "#aspect-anchoring", "#symbol-system"]

  # PARA 301: Operations (13 lessons — added enforcement-levels and paradigm-shift)

  para-301-history-system:
    description: "History System — implementation history, event tracking"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#lore-system"]

  para-301-fragility-tracking:
    description: "Fragility Tracking — stability scores, fragility warnings"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#ripple-analysis"]

  para-301-wisdom-system:
    description: "Wisdom System — antipatterns, decisions, expert guidance"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#wisdom-system"]

  para-301-ripple-analysis:
    description: "Ripple Analysis — impact checking, workspace-aware ripple"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#ripple-analysis"]

  para-301-doctor-and-validation:
    description: "Doctor and Validation — health checks, paradigm doctor, paradigm lint"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#navigation"]

  para-301-enforcement-levels:
    description: "Enforcement Levels — minimal/balanced/strict, 13 checks, per-check overrides, progression strategy"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#enforcement-hooks", "#enforcement-presets"]

  para-301-paradigm-shift:
    description: "The paradigm shift Command — 6-step onboarding, flags, when to re-run, idempotent setup"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#shift-command", "#scan-index", "#enforcement-hooks"]

  para-301-navigation-system:
    description: "Navigation System — paradigm_navigate, find/explore/context intents"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#navigation", "#scan-index"]

  para-301-sentinel-observability:
    description: "Sentinel Observability — incidents, patterns, logs, traces"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#sentinel"]

  para-301-sync-and-maintenance:
    description: "Sync and Maintenance — paradigm sync, IDE adapters, cross-tool export"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#paradigm-sync"]

  para-301-context-management:
    description: "Context Management — token budgets, MCP vs file reads, session stats"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#session-continuity", "#mcp-tools"]

  para-301-protocols:
    description: "Protocols — repeatable patterns, protocol search/record/validate"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#protocol-system"]

  para-301-operations-review:
    description: "Operations Review — comprehensive review of PARA 301 concepts"
    file: para-301.json
    tags: [course-content, para-301]
    references: ["#lore-system", "#wisdom-system", "#ripple-analysis", "#navigation", "#sentinel", "#protocol-system"]

  # PARA 401: Orchestration (12 lessons — added quick-check, updated agent-roles with Rune + roster bridge)

  para-401-mcp-tools-overview:
    description: "MCP Tools Overview — 95 tools, token budgets, query vs file read"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#mcp-tools"]

  para-401-multi-agent-coordination:
    description: "Multi-Agent Coordination — team spawn, agent types, providers"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration"]

  para-401-agent-roles:
    description: "Agent Roles — 8 core + 54 total, three-tier hierarchy, Rune compliance, facets, handoff, reviewer protocol"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration", "#agent-loader"]

  para-401-provider-cascade:
    description: "Provider Cascade — auto, claude, claude-code, cursor-cli, manual"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration"]

  para-401-orchestration-workflow:
    description: "Orchestration Workflow — orchestrate_inline, plan vs execute modes"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration", "#pm-governance"]

  para-401-quick-check:
    description: "Quick-Check: Ask Before You Build — lightweight risk assessment, Jinx + reviewer, GREENLIGHT vs ESCALATE"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration"]

  para-401-pm-governance:
    description: "PM Governance — preflight, postflight, compliance checks"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#pm-governance"]

  para-401-commit-conventions:
    description: "Commit Conventions — symbol trailers, type(#symbol) format"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#symbol-system"]

  para-401-mastery-review:
    description: "Mastery Review — comprehensive review of PARA 401 concepts"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#mcp-tools", "#orchestration", "#pm-governance"]

  para-401-agent-interop:
    description: "Agent Interoperability — AGENTS.md, Skills v2, cross-tool compat"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#orchestration", "#mcp-tools", "#paradigm-sync"]

  para-401-agent-identity:
    description: "Agent Identity & Expertise — .agent files, personality, expertise auto-population, symbol-to-agent routing, orchestration enrichment"
    file: para-401.json
    tags: [course-content, para-401]
    references: ["#agent-loader", "#agent-tools", "#orchestration"]

  para-401-notebooks-permissions:
    description: "University lesson: Agent Notebooks & Permission Scoping — notebooks, permissions, integrity hashing"
    type: lesson
    tags: [university, notebooks, agent-identity, permissions]

  # PARA 501: Advanced Systems (15 lessons — added conductor-workspace)

  para-501-lore-system:
    description: "Lore System — entries, types, arcs, linked entries, timeline"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#lore-system"]

  para-501-sentinel-deep-dive:
    description: "Sentinel Deep Dive — incidents, patterns, triage, services, schemas"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#sentinel"]

  para-501-aspect-graph-internals:
    description: "Aspect Graph Internals — BFS traversal, aspect neighborhoods"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#aspect-anchoring", "#symbol-graph"]

  para-501-habits-practice:
    description: "Habits and Practice — behavioral discipline, blocking habits, compliance"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#habits-system"]

  para-501-session-intelligence:
    description: "Session Intelligence — checkpoints, recovery, handoff, context monitoring"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#session-continuity"]

  para-501-hook-enforcement:
    description: "Hook Enforcement — 11 stop hook checks, pre-commit, post-write hooks"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#enforcement-hooks"]

  para-501-advanced-workflows:
    description: "Advanced Workflows — flow-first development, multi-agent patterns"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#flow-validation", "#orchestration"]

  para-501-aspect-graph-advanced:
    description: "Aspect Graph Advanced — graph generation, interactive visualization"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#aspect-anchoring", "#symbol-graph"]

  para-501-task-management:
    description: "Task Management — paradigm_task_create, task lifecycle"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#mcp-tools"]

  para-501-assessment-loops:
    description: "Lore as Unified Project Memory — arcs as tags, deprecated assessment tools"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#lore-system"]

  para-501-platform-agent-ui:
    description: "Platform & Agent-Driven UI — paradigm serve, MCP→HTTP→WS→browser pipeline, 5 agent tools, conflict resolution, presence, visual treatment"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#PlatformServer", "#PlatformWebSocket", "#AgentPresenceManager", "#UserStateTracker", "#AgentCommandRoute", "#PlatformTools", "#AgentStore", "#AgentToast", "#AgentCallout"]

  para-501-conductor-workspace:
    description: "Conductor: Visual Mission Control — workspace tiling, Symphony integration, task protocol, agent health, local ML"
    file: para-501.json
    tags: [course-content, para-501]
    references: ["#conductor", "#orchestration"]

  para-501-review-compliance:
    description: "University lesson: Automated Review Pipeline — paradigm review, compliance-checker, dynamic tool loading, response format"
    type: lesson
    tags: [university, review, compliance, tool-loading]

  # PARA 601: Ambient Coordination (9 lessons)

  para-601-event-stream:
    description: "Event Stream — append-only JSONL activity log, event types, automatic emission from MCP tools and hooks"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#event-stream"]

  para-601-attention-scoring:
    description: "Attention Scoring — four-dimension relevance scoring (symbol, path, concept, signal), max-based scoring, configurable thresholds"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#agent-loader", "#event-stream"]

  para-601-nominations:
    description: "Nominations — self-nominated agent contributions, brief/urgency/type/evidence, surfacing and engagement workflow"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#nomination-engine", "#agent-loader"]

  para-601-knowledge-streams:
    description: "Knowledge Streams — Work Log, Learning Journal, Team Decisions; different audiences, lifecycles, and storage"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#event-stream"]

  para-601-trust-rings:
    description: "Trust Rings — four concentric data sovereignty levels, project-locked default, enforcement boundaries"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#data-policy"]

  para-601-data-policy:
    description: "Data Policy — YAML-configured rules, observation control, stream filtering, per-agent overrides, DEFAULT_DATA_POLICY"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#data-policy"]

  para-601-context-composition:
    description: "Context Composition — paradigm_context_compose, profile enrichment, decisions, journal insights, nominations into session context"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#agent-loader", "#nomination-engine"]

  para-601-maestro-team-collab:
    description: "Maestro: Visible Team Orchestration — attributed responses, agent profiles, bench/activate, Symphony threads, Neverland test, Teacher Model, documentor agent"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#orchestration", "#agent-loader", "#nomination-engine"]

  para-601-ambient-review:
    description: "Ambient Review — comprehensive review of PARA 601 ambient coordination concepts"
    file: para-601.json
    tags: [course-content, para-601]
    references: ["#event-stream", "#nomination-engine", "#data-policy", "#agent-loader"]

  # PARA 701: Agent Mastery (10 lessons)

  para-701-agent-roster:
    description: "The Agent Roster — 54 agents, 7 tiers, specialist model, orchestrator selection"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration", "#agent-loader"]

  para-701-agent-profiles:
    description: "Agent Profiles Deep Dive — .agent YAML schema, personality, expertise, attention, collaboration graph"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#agent-loader"]

  para-701-agent-notebooks:
    description: "Agent Notebooks — persistent knowledge, journal-to-notebook promotion, buildProfileEnrichment pipeline"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#agent-loader"]

  para-701-agent-state:
    description: "Agent State & Continuity — session state, expertise accumulation, threshold calibration"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#agent-loader", "#session-continuity"]

  para-701-per-project-rosters:
    description: "Per-Project Rosters — roster.yaml, domain filtering, team composition per project"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration", "#agent-loader"]

  para-701-model-tier-resolution:
    description: "Model Tier Resolution — model tiers, cost-aware routing, provider cascade"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration"]

  para-701-orchestration-enforcement:
    description: "Orchestration Enforcement — habits, hook checks, compliance validation for multi-agent flows"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration", "#enforcement-hooks", "#habits-system"]

  para-701-symphony-visibility:
    description: "Live Visibility via Symphony — real-time agent messaging, Conductor views, Platform dashboard"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration"]

  para-701-learning-feedback-loop:
    description: "The Learning Feedback Loop — postflight learning, threshold calibration, Neverland metrics"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#nomination-engine", "#agent-loader"]

  para-701-agent-pods-nevrland:
    description: "Agent Pods & nevr.land — agent marketplace, trust contracts, pod composition, remote agents"
    file: para-701.json
    tags: [course-content, para-701]
    references: ["#orchestration", "#agent-loader"]
