AGENTS.md · git:20260824.0904589 · 2026-08-24 · sha256 7c800e2703ff1d91
AGENTS.md git:20260824.0904589A
Immutable. This exact content never changes and is served at /api/v1/blob/7c800e2703ff1d91.
# AgentCtl Single source of truth for AI coding-agent configuration ## Important Rules - You must not downgrade a package just because it solves a problem. - Always Use top-level `gh` and `pnpm` commands such as `gh view <id>` wherever possible. - If a top-level command is available, then avoid using sub-commands such as `gh run <sub_command>` or `pnpm run <sub_command>`. ## Testing instructions - Run `pnpm test` to run every check defined for this app. - Fix any test or type errors until the whole suite is green. - To focus on one step, add the Vitest pattern: `pnpm test -t "<test name>"`. - After moving files or changing imports, run `pnpm lint` and `pnpm format:check` to be sure OXC and TypeScript rules still pass. - Add or update tests for the code you change, even if nobody asked. ## Commit instructions - Title format: `type(scope?): subject` - Always run `pnpm lint`, `pnpm format:check` and `pnpm test` before committing. - Never use yourself as co-author ## Context Navigation (Graphify) ### Code Query Rule - Always first query `graphify-out/graph.json` or `graphify-out/wiki/index.md` to understand code structure and connections - only read raw code files when editing or when the first layer don't have the answer ### When to rebuild the graph - After structural changes (new modules, major refactors) - Headless: `graphify update .` (only processes modified files) - Skill: `/graphify . --update` (same behavior, runs through the skill — also accepts `--obsidian` to refresh the vault) - The graph is persistent — NO need to rebuild every session ### Do NOT - Don't manually modify files inside `graphify-out/` - Don't re-read the entire codebase if the graph already has the information