{
  "markdown": "# LearnCC: Learn Claude Code\n\nA structured, hands-on Claude Code educational course delivered as a plugin. Install it, type `/learncc`, and it becomes your tutor — adapting to how you work, tracking your progress, and teaching through practice, not lectures.\n\n## Who This Is For\n\nEveryone. The course adapts to your role:\n- **Developers** — hooks, worktrees, headless mode, CI integration\n- **Product Managers** — PRDs, research synthesis, competitive analysis, Plan Mode\n- **Non-Technical Users** — voice input, report automation, skills, document workflows\n- **Students** — learning-focused usage with academic integrity guidance\n- **Power Users** — hidden gems, advanced hooks, compound workflows\n\nNo coding experience required. If you've never opened a terminal, the course starts with a 17-minute terminal orientation.\n\n## What You'll Learn\n\n| Module | What You'll Be Able To Do After |\n|--------|-------------------------------|\n| First Contact | Have productive conversations, use voice input, navigate basic controls |\n| Your Workspace | Configure CLAUDE.md, manage memory, set up your environment |\n| Context Mastery | Manage context proactively, use /btw and /compact, handle sessions |\n| Plan & Verify | Use Plan Mode, verification loops, and the interview pattern |\n| Skills & Plugins | Create custom skills, discover and install plugins |\n| Hooks & Subagents | Automate actions with hooks, delegate work to subagents |\n| Parallel Work | Run multiple sessions, fork conversations, use writer/reviewer pattern |\n| Integrations | Connect tools via MCP, choose models, automate with headless mode |\n| The Meta Game | Continuous improvement, hidden features, compound workflows |\n\nTotal: ~5-8 hours depending on your experience (the course skips what you already know).\n\n## Quick Start\n\n### Install from Plugin Marketplace (Recommended)\nOnce accepted into the official marketplace:\n1. Open Claude Code and type `/plugin`\n2. Search `learncc` in the Discover tab\n3. Press Space to install, Esc to close\n4. Type `/learncc` to start the course\n\n### Install from GitHub (Available Now)\n```bash\n# Add the marketplace source (one time, in your terminal BEFORE starting Claude Code)\nclaude plugin marketplace add ryanxkh/learncc\n```\nThen start Claude Code and:\n1. Type `/plugin`\n2. Search `learncc` in the Discover tab\n3. Press Space to install, Esc to close\n4. Type `/learncc` to start the course\n\n### Manual (without plugin install)\n```bash\ngit clone https://github.com/ryanxkh/learncc.git\ncd learncc\nclaude --append-system-prompt-file ./learncc-runner.md\n```\nThen say \"start.\"\n\n## Token Usage Note\n\nThis course uses additional tokens beyond normal Claude Code usage. Each module loads its content on demand (not all at once), but expect higher-than-normal token consumption during active learning sessions. The course is designed for efficiency — module content loads only when you reach that module, and completed modules are never re-loaded.\n\n## How It Works\n\nThe course is an **Option C \"Course Runner\"** — a single system prompt that turns Claude Code into a structured tutor. It:\n\n1. **Assesses you** — asks about your role, experience, and tools\n2. **Routes you** — skips what you already know, starts where you'll learn most\n3. **Adapts to you** — developer, PM, and non-technical paths with different examples and exercises\n4. **Tracks progress** — saves to `~/.claude/learncc/progress.json` after every exercise\n5. **Resumes cleanly** — come back tomorrow and pick up exactly where you left off\n6. **Stays on track** — built-in guardrails prevent rambling, over-explaining, and tangents\n\n## Course Design\n\nBuilt on research-backed educational principles:\n- **Do-before-explain** — you try things before getting the explanation\n- **1:4 ratio** — 1 minute of explanation for every 4 minutes of practice\n- **Role-adapted** — every exercise uses examples from YOUR work domain\n- **Socratic assessment** — \"why did that work?\" not quizzes\n- **Spaced retrieval** — each module starts with recall of prior concepts\n- **Session guards** — break points, time caps, and anti-drift mechanisms\n\n## Files\n\n```\nlearncc/\n├── .claude-plugin/\n│   └── marketplace.json            # Marketplace manifest\n├── plugins/learncc/                # The plugin\n│   ├── .claude-plugin/\n│   │   └── plugin.json             # Plugin manifest\n│   ├── skills/learncc/\n│   │   ├── SKILL.md                # Course orchestrator (~200 lines)\n│   │   └── references/             # Module content (loaded on demand)\n│   │       ├── module-0.md         # Orientation + Surfaces\n│   │       ├── module-0.5.md       # Terminal Basics (non-technical)\n│   │       ├── module-1.md         # First Contact + Voice\n│   │       ├── module-2a.md        # CLAUDE.md & Memory\n│   │       ├── module-2b.md        # Settings & Permissions\n│   │       ├── module-3.md         # Context Mastery\n│   │       ├── module-4.md         # Plan & Verify\n│   │       ├── module-5a.md        # Skills & Plugins\n│   │       ├── module-5b.md        # Hooks & Subagents\n│   │       ├── module-6a.md        # Parallel Work\n│   │       ├── module-6b.md        # Integrations & Automation\n│   │       └── module-7.md         # The Meta Game\n│   ├── hooks/\n│   │   ├── hooks.json              # Session start/end hooks\n│   │   └── scripts/\n│   │       └── session-context.sh  # Progress context injection\n│   ├── agents/\n│   │   └── learncc-validator.md    # Exercise validation agent\n│   └── examples/                   # Starter templates\n│       ├── claude-md-developer.md\n│       ├── claude-md-pm.md\n│       ├── claude-md-general.md\n│       ├── example-skill.md\n│       ├── example-hook.json\n│       └── example-subagent.md\n├── learncc-runner.md               # Standalone version (all-in-one)\n├── README.md\n├── LICENSE                         # MIT\n├── CHANGELOG.md\n└── docs/                           # Design docs (for contributors)\n```\n\n## Progress Tracking\n\nYour progress is saved to `~/.claude/learncc/progress.json`. This file tracks:\n- Your role and domain\n- Which modules you've completed\n- Where you left off mid-module\n- Questions you asked that belong in later modules (the \"parking lot\")\n\nTo reset your progress and start over:\n```bash\nrm ~/.claude/learncc/progress.json\n```\n\n## Privacy\n\nThe course saves your progress to `~/.claude/learncc/progress.json` on your local machine. This file stores your role, domain, module progress, and deferred questions. It is never transmitted anywhere — it stays on your computer. To delete it: `rm ~/.claude/learncc/progress.json`\n\n## Feature Availability\n\nClaude Code ships new features frequently. Specific commands, keyboard shortcuts, and features referenced in this course are accurate as of v2.1.85+ (March 2026). If something doesn't work as described, check `/release-notes` for changes. The course teaches patterns and workflows that remain stable across versions, even if specific command names change.\n\n## Contributing\n\nThis course is open source. To improve it:\n1. Check `COURSE-BLUEPRINT-v2.md` for the design specs\n2. Check `research/` for the underlying research\n3. For the plugin version: module content lives in `skills/learncc/references/`. For the standalone version: `learncc-runner.md`\n4. Test changes against diverse personas (the research includes 10 test personas)\n\n## Credits\n\nBuilt with research from:\n- Anthropic's official Claude Code documentation\n- Community practitioners: Boris Cherny, Boris Tane, Daniel Miessler, Simon Willison, and many others\n- Educational design research: Bloom's Taxonomy, Kolb's Cycle, Knowles' Andragogy, AI Tutoring RCTs\n- Validated against 10 diverse learner personas from marketing coordinators to Linux sysadmins\n",
  "bytes": 7672,
  "sha": "d783025151defa2f1331965a96568b435dd0fccfb742b41e54d4c6e80b90d86e",
  "repo_slug": "ryanxkh/learncc",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_ryanxkh_learncc_learncc_75fe4f99/readme"
}