Knowledge Base

Optional detailed analysis with the --kb flag.

What is the Knowledge Base?

The Knowledge Base is an optional set of detailed analysis files generated in the .aspect/ directory. It provides deeper architectural insight than what fits in AGENTS.md alone.

Generate it with:

aspectcode --kb

KB files

The .aspect/ folder contains:

File	Purpose
`architecture.md`	High-risk hub modules, directory layout, entry points, blast radius
`map.md`	Data models with signatures, symbol index, naming conventions
`context.md`	Module clusters (co-edited files), external integrations, data flow paths

When to use the KB

The Knowledge Base is useful when:

Your team wants to review detailed architectural analysis

You want to understand blast radius for specific modules

You need the full symbol index for your project

You're debugging complex dependency chains

For most users, AGENTS.md alone provides everything AI assistants need. The KB adds depth for teams that want it.