Generated Files

Understanding the files Aspect Code creates.

AGENTS.md

AGENTS.md is generated at your project root. It's a single markdown file containing architecture rules, conventions, and guardrails for AI coding assistants.

Every major AI tool reads it automatically when present.

Scoped rules

Aspect Code generates directory-specific rule files that AI assistants load automatically:

Platform	Path	Format
Claude Code	`.claude/rules/ac-*.md`	Markdown with YAML frontmatter
Cursor	`.cursor/rules/ac-*.mdc`	MDC with YAML frontmatter

Scoped rules are generated from three sources:

Hub rules — directories with high-connectivity files

Convention rules — directories with naming patterns different from the repo-wide norm

Dream cycle rules — learned from your corrections during watch mode

A manifest at .aspectcode/scoped-rules.json tracks which files Aspect Code owns, so stale rules are automatically cleaned up.

Local state files

The .aspectcode/ directory may contain:

File	Purpose
`scoped-rules.json`	Manifest tracking which rule files Aspect Code generated
`dream-state.json`	Timestamp of the last dream cycle

Learned preferences are synced to the cloud (not stored locally). See Cloud Sync.