Concorde guide — AI agents (skills & AGENTS.md). Concorde ships skills, rules, and a root AGENTS.md so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migratio Doc ID: docs/_getting-started/ai-agents. Keywords: Concorde, supersoniks, docs/_getting-started/ai-agents, ai-agents, AI agents (skills & AGENTS.md), guide, AGENTS.md, yarn ai:sync, ai-init, yarn add @supersoniks/concorde, | | Concorde repo (contributors) | , --merge-agents, --overlay , --cursor-only. URL: https://concorde.supersoniks.org/crawl/docs/_getting-started/ai-agents.html.

AI agents (skills & AGENTS.md)

Concorde ships skills, rules, and a root AGENTS.md so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migrations).

On a starter project, run yarn ai:sync after install. On a manual / brownfield project, install Concorde first, then use ai-init below.

Dedicated commands

Context	Command
create-concorde-ts-starter project	`yarn ai:sync`
Any consumer app (after `yarn add @supersoniks/concorde`)	`node node_modules/@supersoniks/concorde/scripts/ai-init.mjs`
Concorde repo (contributors)	`yarn ai-init`

# Starter (from project root)
yarn ai:sync

# Manual / existing project
node node_modules/@supersoniks/concorde/scripts/ai-init.mjs

Useful flags

Flag	Effect
`--merge-agents`	Append to an existing `AGENTS.md` instead of replacing it
`--overlay <dir>`	Copy extra rules/skills from another layer (e.g. starter kit)
`--cursor-only`	Install only `.cursor/skills` and `.cursor/rules`
`--jetbrains-only`	Install only `.aiassistant/rules/`

What gets installed

Path	Role
`AGENTS.md`	Project-level guide for agents (Concorde conventions)
`.cursor/skills/concorde/`	Core Lit + DataProvider patterns
`.cursor/skills/concorde-imports/`	Short `@supersoniks/concorde/…` import paths
`.cursor/skills/concorde-scope/`	`serviceURL`, `formDataProvider`, API configuration
`.cursor/skills/concorde-theme/`	`sonic-theme` and `--sc-*` tokens
`.cursor/skills/concorde-menu/`	`sonic-menu` navigation
`.cursor/skills/concorde-get-set-dp/`	`get` / `set` / `dp` and `DataProviderKey` migration
`.cursor/rules/concorde.mdc`	Cursor rules (always-on patterns)
`.aiassistant/rules/concorde.md`	JetBrains AI Assistant rules

Workflow

Starter project: Installation — yarn ai:sync is wired in the kit.
Existing / manual Vite project: Manual installation, then ai-init after yarn add @supersoniks/concorde.
Commit AGENTS.md, .cursor/, and .aiassistant/ if your team shares agent settings.
Re-run the same command when you bump @supersoniks/concorde to refresh skills from node_modules/@supersoniks/concorde/ai/.
In Cursor, skills under .cursor/skills/ are picked up automatically; mention a skill in chat for focused tasks (e.g. migration → concorde-get-set-dp).

Source files in the npm package: node_modules/@supersoniks/concorde/ai/ (see also ai/README.md in the Concorde repository).