Knowledge
Knowledge is where ACE builds and shows what it understands about your project. Everything else that "knows" something about your code is grounded here: the Chat assistant, the agents working cards on the Development board, the generated onboarding docs. They all read from the model this section produces.
How does Knowledge work?
It runs in two stages, in order:
- Discovery builds the model. It maps your codebase, optionally scans and confirms your cloud infrastructure, and synthesizes both into an architecture narrative and a relationship graph.
- Learn turns that same model into documentation you (and your team) can actually read: Learning Paths, a page-turning Book mode, rendered Diagrams, and AGENTS.md briefing files for AI coding agents.
Nothing in Learn exists until Discovery has produced something to generate it from. Mapping your code is the one mandatory step. Everything downstream, in both Discovery and Learn, is optional or builds on top of it.
In this section
- Discovery: mapping your code, synthesizing architecture, discovering and confirming cloud infrastructure, and watching and reviewing runs.
- Learn: Learning Paths, Book mode, Diagrams, and AGENTS.md, and how to browse, edit, regenerate, and fix generated docs with AI.
What order do I do things in?
- Connect a repository to the project. Discovery needs at least one before it can do anything. See Connect a repository.
- Map code on Discovery, the only mandatory step. This is what everything else in Knowledge is grounded on.
- Synthesize your architecture (recommended): turns the mapped code, plus any confirmed infrastructure, into a narrative and a relationship graph.
- If you are cloud-hosted, discover your infrastructure, confirm the resources that are actually yours, and run Investigate to cross-reference it against your code.
- Browse what got generated on Learn: Learning Paths and Book mode for onboarding-style reading, Diagrams for pictures, AGENTS.md for briefing AI agents. Generate, read, and edit any of it, or ask ACE to Fix with AI directly on a document.
Where to find it
Left sidebar → Workspace → Knowledge, containing Discovery and a Learn group (Learning Paths, Book mode, Diagrams, AGENTS.md). Every page in this section is scoped to whichever project you currently have selected in the sidebar.
Who can do this?
| Grant | Controls |
|---|---|
discovery:read | Seeing the Discovery page and its tabs |
discovery:manage | Running Map code / Synthesize / Discover infra / Investigate, confirming or discarding resources, editing health checks |
knowledge:read | Seeing Learning Paths, Book mode, Diagrams, and AGENTS.md |
knowledge:manage | Editing, regenerating, or creating, renaming, and deleting files on those same screens |
On top of the grant itself, every action on both pages also checks that the project is still mutable; an archived, provisioning, or degraded project falls back to read-only regardless of what you are permitted to do.