1.6 KiB
1.6 KiB
Vojo — AI Context Bank
Single source of truth for every AI agent working on this repo.
Directive
Any agent (Claude Code, Cursor, Codex, Windsurf, Cline, Copilot, Aider, …) working here MUST:
- Read every file in docs/ai/ before making non-trivial changes.
- Treat this folder as the ONLY authoritative source for project context.
- Write new project knowledge HERE, not in
CLAUDE.md,.cursorrules,.windsurfrules,AGENTS.md, home-dir memory, or wherever else your tool defaults to. - If a top-level agent file (like
CLAUDE.md) appears to disagree with anything indocs/ai/,docs/ai/wins. Treat the top-level file as a stale pointer and fix it.
Contents
| File | What's in it |
|---|---|
| overview.md | What Vojo is, infrastructure, deployment target, developer profile, default homeserver rule |
| architecture.md | Stack, source layout, routing, features, state management, Matrix SDK patterns, git workflow |
| i18n.md | i18next setup, translation patterns, Russian-language quality standards, localization progress |
| android.md | Capacitor wrapper, Android build chain, edge-to-edge, Service Worker invariants, ADB workflow |
| bugs.md | Known bugs & regressions |
Rules for updating
- Prefer editing an existing entry over adding a new one.
- Don't duplicate content across files — pick the best home and cross-link if needed.
- Do not create a new
CLAUDE.md,.cursorrules,AGENTS.md, etc. with project knowledge. Those files should only contain a pointer back here. - If you add a new topic file, also add it to the table above.