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) | , --skip-agents, --merge-agents, --force-agents. 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
`--skip-agents`	Never write `AGENTS.md` (skills / rules only)
`--merge-agents`	Opt-in: keep the project preamble and append / refresh the Concorde block
`--force-agents`	Opt-in: replace the whole `AGENTS.md` (destructive)
`--overlay <dir>`	Extra rules/skills + optional `AGENTS.concorde.md` for project-only Concorde agent notes
`--cursor-only`	Install only `.cursor/skills` and `.cursor/rules`
`--jetbrains-only`	Install only `.aiassistant/rules/`

`AGENTS.md` policy (non-invasive)

Situation	Default
No `AGENTS.md`	Create the Concorde guide
File with `<!-- concorde-ai -->`	Refresh the managed zone only
File without marker (project notes)	Left untouched — skills / rules are enough
`--merge-agents` / `--force-agents` / `--skip-agents`	See flags above

[optional project preamble — short, project-only]
<!-- concorde-ai -->
<package ai/AGENTS.md>
[--- + overlay AGENTS.concorde.md]

Everything after  is replaced on each ai-init run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in AGENTS.concorde.md (overlay). If the preamble duplicates package AGENTS.md, ai-init slims or drops it and prints a warning. Legacy filenames AGENTS.overlay.md / AGENTS.starter.md are still accepted with a deprecation warning.

What gets installed

Path	Role
`AGENTS.md`	Created only if missing; existing project-owned files are left alone unless `--merge-agents` / `--force-agents`
`.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 .cursor/ and .aiassistant/ (and AGENTS.md only if you opted in / it was created) 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).