Generated Files

Understanding the files Aspect Code creates.

Knowledge Base (.aspect/)

The .aspect/ folder contains the generated knowledge base and other relevant files:


FilePurpose
architecture.mdHigh-risk hubs, directory layout, entry points—the critical architecture overview
map.mdData models with signatures, symbol index, naming conventions
context.mdModule clusters, external integrations, data flow paths
instructions.mdYour custom project-specific instructions (user-editable, appears only on user input)
.settings.jsonLocal Aspect Code settings for this project
.fingerprint.jsonLocal workspace state tracking

AI Assistant instruction files

Depending on your configuration, Aspect Code generates:


FileAssistant
.github/copilot-instructions.mdGitHub Copilot
.cursor/rules/aspectcode.mdcCursor
CLAUDE.mdClaude / Claude Code
AGENTS.mdOther AI tools

These files include:

  • Reference to the KB files in .aspect/
  • Golden Rules for AI behavior (in Safe mode)
  • Project-specific instructions from .aspect/instructions.md (only when populated)