XAIO.md — Project Knowledge File
The persistent project memory the agent reads at the start of every chat.
What is XAIO.md?
`XAIO.md` is a markdown file the agent maintains automatically inside every project. It captures your design system, conventions, key decisions and constraints and is loaded at the start of each chat — so a fresh conversation immediately knows what design tokens you use, what your code style is, what's already been decided.
Why it matters
Without XAIO.md, every new chat starts from zero and the agent would have to infer your conventions from the codebase each time. With it, decisions persist:
- Design tokens (palette, typography, radii, spacing) are remembered
- Component patterns and naming conventions stay consistent
- Architectural decisions don't get re-litigated every conversation
- Migration pre-analysis stores its findings here
How to use it
Set it up early — at project start, define your design system in one prompt:
Before we build anything, lock in the design system: dark theme, Inter font, accent #3b82f6, 8px corner radius, subtle shadows, generous spacing. Save that to XAIO.md.Update it when things change:
Update XAIO.md: we switched from Tailwind defaults to a custom palette. Primary: #1e40af, secondary: #059669, background: #0f172a.Read it back:
Read XAIO.md and tell me which design system and conventions are defined for this project.Where to find it
`XAIO.md` shows up in the Files tab under its own sub-tab, and also in the project settings. To edit it, ask the agent in chat — direct edits work too but letting the agent rewrite it keeps the formatting consistent.
What goes in (and what doesn't)
In:
- Design tokens and visual system
- Naming and code style conventions
- Architecture decisions (why we chose React Router over Next, etc.)
- Domain-specific glossary (what's a 'session' in this app, what's a 'tenant')
- External integrations the project relies on
Out:
- Secrets / API keys (use Environment variables — they're masked in chat anyway)
- Per-feature implementation notes (those belong in the code itself)
- Anything that changes weekly (XAIO.md is for stable decisions, not in-flight work)