Skip to main content

Learning Paths

Knowledge → Learn → Learning Paths.

This screen is a file browser: a folder tree on the left, an open document on the right. It is the same layout Diagrams and AGENTS.md use, just pointed at a different set of generated files. There is no separate "modules and units" interface; whatever structure the generation produces (folders and .md files) is what you see in the tree, and you are free to reorganize it yourself. There is also no quiz or exercise UI in the app: the description on the empty-state screen ("modules, concepts, and exercises derived from your actual code") describes what the generated content covers, not a special interactive feature.

Because Diagrams and AGENTS.md share this exact mechanism, this page documents it in full; their own guides only call out what is different.

What if nothing is generated yet?​

You will see a No learning paths yet message with the description above and a Generate learning paths button. Click it and the button becomes Dispatching…, then the screen switches to a Generating in the background… state ("This may take a few minutes. The page will update automatically."). You do not need to keep the tab open and refresh; it checks periodically and reveals the tree the moment files exist. If generation cannot start (for example, because Discovery has not run yet), an error message appears along with a Run code map discovery → link back to Discovery. Without knowledge:manage, the button is replaced with: "Read only — generation requires knowledge management access on an active project."

Browsing and opening documents​

  • The left panel header reads Learning Paths, with a Regenerate control (circular-arrow icon) next to it if you can manage content; it spins while re-dispatching generation for the whole set.
  • Folders and files show with folder and document icons and expand/collapse chevrons; click a file to open it on the right.
  • Hovering a row reveals a ⋯ button with New File, New Folder (folders only), Rename, and Delete.
    • New File opens a New Document picker with four starting templates (Blank ("Empty document"), Architecture Decision Record ("Document an architectural decision"), Runbook ("Operational procedure or guide"), and Meeting Notes ("Record meeting outcomes and action items")), each pre-filled with its own starter Markdown. Pick one and click Create. The file is added with a placeholder name and opens immediately so you can rename and fill it in.
    • New Folder creates a folder immediately (with a placeholder name); rename it afterward via its own ⋯ → Rename.
    • Rename turns the name into a text box; press Enter to save or Escape to cancel (files automatically keep a .md ending).
    • Delete asks you to confirm ("Delete file?" / "Delete folder and all its contents?") before removing it.
  • The same New file / New folder buttons also sit at the top of the tree, for creating at the root level.

Reading and editing a document​

Once you open a file, the top bar shows its filename plus:

  • Edit / View: toggles between the formatted reading view and a rich-text editor (headings, bold and italic, lists, tables, code blocks). While editing, your changes autosave a couple of seconds after you stop typing, and a Saving… / Saved / Error saving indicator confirms it.
  • Fix with AI: opens a drawer at the bottom where you type an instruction (for example, "make this section shorter") in a text box and click Send. While it works: "The AI is working on it. This may take a few seconds…". ACE then shows a line-by-line diff of what it wants to change (removed lines struck through in red, added lines highlighted in green) with Reject and Accept buttons. Accept saves the new version; Reject discards the suggestion but keeps your instruction so you can adjust and resend. If the request fails, you get an error message and a Try again button.

Links inside a document that point at another .md file open that sibling document right there in the viewer, instead of leaving the app.

Who can do this?​

knowledge:read to browse and read; knowledge:manage (plus a mutable project) for every editing action: generating, Regenerate, Fix with AI, and the file-tree's New file / New folder / Rename / Delete.

On this page