# AGENTS.md Canonical guidance for AI coding agents (Claude Code, OpenAI Codex CLI, Cursor, and others) working in this Stacks application. This is the one file every agent reads, and the only one committed - `buddy setup:ai` generates the rest (`CLAUDE.md`, `.claude/skills/`, `.cursor/rules/`, ...) from `storage/framework/defaults/ai/`, and they are gitignored because the agent you use is your choice. Stacks is a full-stack TypeScript framework that runs on Bun. Almost every subsystem has a dedicated skill under `storage/framework/defaults/ai/skills/` that documents it authoritatively. **This file is a map: it states the non-negotiable rules and points you to the right skill for the task.** Read the relevant `SKILL.md` before doing non-trivial work in that area rather than guessing an API. --- ## Project conventions (mandatory) ### Linting - Use **pickier** for linting, never eslint directly. - Lint: `./buddy lint` . Auto-fix: `./buddy lint:fix` . These drive pickier through its SDK, so they work the same in a vendored checkout and a package-based app; reach for `bunx --bun pickier .` only when you need a flag the command does not expose. - For unused-variable warnings, prefer `// eslint-disable-next-line` over prefixing with `_`. ### Frontend - Use **stx** for templating, never vanilla JS (`var`, `document._`, `window._`) in stx templates. - Use **ts-css** as the CSS framework (Tailwind-like utility classes). - stx `