{
 "schema": "aiblocks-page/1",
 "id": "codebase-learning-map",
 "type": "skill",
 "name": "Codebase learning planner",
 "summary": "Turn a code folder into a study map. Get ordered phases, what to know first and 2 or 3 paths that fit your goal and level.",
 "headline": "Codebase learning planner",
 "subhead": "Give it a code folder, its main guide and your learning goal. It maps the lessons and features, checks what you need to know first and suggests routes. You get an ordered study map and a choice of starting paths.",
 "job": {
  "id": "study-and-practice",
  "name": "Study and check your understanding"
 },
 "level": "beginner",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "codebase",
   "required": true,
   "label": "Codebase",
   "what": "a project's code, in a folder or repo the AI can open"
  },
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  },
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  }
 ],
 "you_give": [
  "A repository and its main guide or course outline.",
  "Your goal and current level."
 ],
 "you_get": [
  "An ordered map of learning phases.",
  "A list of prerequisites and likely sticking points.",
  "Two or three study paths with tradeoffs."
 ],
 "use_when": [],
 "skip_when": [
  "You want one task done in a codebase, like fixing a bug. Ask your AI for that task directly.",
  "You want to learn a topic with no code folder. Ask your AI for a study plan on that topic instead.",
  "You already know the order and want a lesson on one idea. Ask your AI to teach that idea."
 ],
 "output_sample": {
  "input": [
   "Your code folder or its file list",
   "The main guide, such as the README or course outline",
   "Your goal for learning it",
   "Your current level (optional)"
  ],
  "prerequisites": [
   "An AI that can read your folder or the files you paste in"
  ],
  "output": [
   {
    "name": "Repo type",
    "contains": "Whether the folder is built around lessons, a project, reference material or a mix."
   },
   {
    "name": "Your goal and level",
    "contains": "What you want from the folder and where you start, as your AI understood it."
   },
   {
    "name": "Phase table",
    "contains": "The phases in order, with what you can do after each one."
   },
   {
    "name": "Prerequisite list",
    "contains": "What you need to know first for each phase, and where learners often get stuck."
   },
   {
    "name": "Study paths",
    "contains": "Two or three routes that fit your goal, with the tradeoffs and effort of each."
   },
   {
    "name": "Checkpoint question",
    "contains": "One question that helps you pick a path before any teaching starts."
   }
  ]
 },
 "how_to_use": [
  "Open Claude, ChatGPT or Gemini. Pick one that can read files or a pasted folder.",
  "Paste this skill into the chat.",
  "Add your code folder or its file list, plus the README or course outline.",
  "Say what you want to learn and your level.",
  "Read the phase table and the paths. Answer the checkpoint question to pick a path.",
  "Ask your AI to start teaching only after you have chosen."
 ],
 "checks": [],
 "next": [
  {
   "name": "Study gap tracker",
   "url": "https://useaiblocks.com/skills/study-gap-tracker",
   "why": "Study gap tracker"
  },
  {
   "name": "Study notebook reviewer",
   "url": "https://useaiblocks.com/skills/study-notebook-review",
   "why": "Study notebook reviewer"
  },
  {
   "name": "Learning session handover writer",
   "url": "https://useaiblocks.com/skills/learning-session-handoff",
   "why": "Learning session handover writer"
  },
  {
   "name": "Skill progression map builder",
   "url": "https://useaiblocks.com/skills/skill-progression-map-builder",
   "why": "Skill progression map builder"
  },
  {
   "name": "Overloaded lesson checker",
   "url": "https://useaiblocks.com/skills/overloaded-lesson-checker",
   "why": "Overloaded lesson checker"
  }
 ],
 "source": {
  "by": "edu-agent-skills contributors",
  "repo": "yugash007/edu-agent-skills",
  "url": "https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/onboarding/repo-understand",
  "licence": "MIT",
  "original_name": "repo-understand",
  "commit": "e75f44303570bb2eae37a8f7536c0358be2502ee"
 },
 "credits": [
  {
   "title": "repo-understand skill",
   "by": "edu-agent-skills contributors",
   "url": "https://github.com/yugash007/edu-agent-skills/tree/e75f44303570bb2eae37a8f7536c0358be2502ee/skills/onboarding/repo-understand",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps."
  }
 ],
 "files": [
  "examples.md",
  "LICENSE"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/codebase-learning-map",
  "markdown": "https://useaiblocks.com/skills/codebase-learning-map.md",
  "json": "https://useaiblocks.com/skills/codebase-learning-map.json",
  "instructions": "https://useaiblocks.com/skills/codebase-learning-map/SKILL.md",
  "download": "https://useaiblocks.com/skills/codebase-learning-map.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/codebase-learning-map",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/codebase-learning-map",
  "mcp": "https://useaiblocks.com/mcp"
 }
}