Skip to main content

Learn

Everything in Learn is generated from your project's code map, the architecture analysis ACE builds when you run Discovery. Once that map exists, ACE can turn it into four kinds of documentation:

  • Learning Paths: onboarding-style material generated from your code, browsed as files and folders.
  • Book mode: the same idea, but presented as a page-turning book with a table of contents.
  • Diagrams: architecture and data-flow diagrams, rendered as actual pictures.
  • AGENTS.md: guidance files meant to brief AI agents on each part of your codebase.

You will find all four grouped under Learn in the sidebar, inside Knowledge. If nothing has been generated yet for a screen, you will see a prompt to generate it; none of this appears automatically until you (or a teammate) ask for it.

In this section​

  • Learning Paths: the file-tree layout, the New Document template picker, and the read, edit, and Fix-with-AI mechanics every other screen in this section reuses.
  • Book mode: the chaptered table of contents and page-turning reading experience.
  • Diagrams: the same file-tree layout, but for documents that embed rendered diagrams.
  • AGENTS.md: the same file-tree layout again, tailored to briefing AI coding agents.

A note on permissions​

If you only have viewing rights on the project, or the project is archived or read-only, every editing control described below (Edit, Regenerate, Fix with AI, new file or folder, rename, delete) disappears, and the screen shows a small Read only label instead. Generating content for the first time on an empty screen needs the same access: "Read only — generation requires knowledge management access on an active project."

Where to find it​

Left sidebar → Knowledge → Learn, containing Learning Paths, Book mode, Diagrams, and AGENTS.md. Every page is scoped to whichever project you currently have selected in the sidebar.

Who can do this?​

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

On this page