learn-anything CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Learn Anything is a CLI tool (learn-anything) that generates skill and command files for AI coding assistants, turning them into interactive learning tutors. It supports 30+ AI tools (Claude Code, Cursor, Gemini CLI, Codex, Copilot, Windsurf, etc.) and outputs localized files in en and zh-CN.

The generated skills implement 6 learning workflows: topic (initialize a subject), explain (recursive Socratic deep-dive), practice (TDD-style exercises), review (spaced repetition), status (knowledge map visualization), and quiz (two-stage generation and grading).

Commands

pnpm build          # Compile TypeScript via tsc (runs node build.js in each package)
pnpm dev            # tsc --watch (all packages)
pnpm test           # Run all tests once (vitest run) across all packages
pnpm test:watch     # Run tests in watch mode (vitest) across all packages
pnpm lint           # ESLint on packages/
# Per-package commands:
pnpm -F learn-anything-cli build     # Build only the CLI package
pnpm -F learn-anything-cli test      # Test only the CLI package

Architecture (monorepo)

packages/
  cli/                  # Published as `learn-anything-cli`
    src/
      cli/index.ts          # Commander.js CLI: `learn-anything init [path]` and `learn-anything update [path]`
      core/
        init.ts             # InitCommand — orchestrates tool detection, interactive selection,
                            #   skill generation, and command generation
        config.ts           # AI_TOOLS array (30+ tools with skillsDir mappings), LEARN_DIR
        command-generation/ # Adapter pattern: each tool has an adapter that knows its file format
                            #   and directory conventions (Claude → .claude/commands/, YAML frontmatter;
                            #   Gemini → .gemini/commands/, TOML; Codex → ~/.codex/prompts/)
          types.ts          # CommandContent, ToolCommandAdapter, GeneratedCommand interfaces
          registry.ts       # CommandAdapterRegistry — maps tool IDs → adapters
          generator.ts      # generateCommand / generateCommands — applies adapter to content
          adapters/         # claude.ts, cursor.ts, codex.ts, gemini.ts
        templates/
          types.ts          # SkillTemplate, CommandTemplate interfaces
          skill-templates.ts # Re-exports all 6 workflow template getters
          workflows/        # learn-topic.ts, learn-explain.ts, learn-practice.ts,
                            #   learn-review.ts, learn-status.ts, learn-quiz.ts
                            #   Each exports getXxxSkillTemplate(locale) and getXxxCommandTemplate(locale)
        shared/
          skill-generation.ts  # Aggregates templates; generateSkillContent() writes YAML frontmatter
      i18n/
        index.ts            # getMessages(locale), detectSystemLocale(), resolveLocale()
        types.ts            # LocaleMessages, SkillsMessages, CLIMessages, InitMessages types
        locales/
          en.ts, zh-CN.ts   # Top-level locale messages (CLI strings, init messages)
          skills/{en,zh-CN}/ # Per-workflow skill/command content (topic.ts, explain.ts, etc.)
      utils/
        file-system.ts      # ensureDir, writeFile, fileExists, dirExists, removeDir
        interactive.ts      # isInteractive() — checks process.stdin/stdout.isTTY
  gui/                  # Placeholder for future GUI (private, not published)