Skip to main content

IDE adapters (Cursor and Copilot)

A2C keeps canonical policy in AGENTS.md, rules/, prompts/, and docs. IDE hosts need thin adapters that point at those assets.

HostMaterialized pathsMethod sources
Cursor.cursor/rules/*.mdccursor/rules/*.mdc
GitHub Copilot.github/copilot-instructions.md, .github/instructions/*.instructions.mdcopilot/

See ADR-0028.

Selection​

Default: Cursor only.

a2c bootstrap --path ./my-lib                          # cursor
a2c bootstrap --path ./my-lib --ide-adapters copilot   # Copilot only
a2c bootstrap --path ./my-lib --ide-adapters both      # Cursor + Copilot
a2c setup-dev --ide-adapters cursor,copilot            # refresh / switch

Persisted in tool-state config.yaml as workflows.ide_adapters and in adoption.yaml as ide_adapters. Resolution: CLI → config → adoption → [cursor].

Bootstrap behavior​

  1. Run a2c bootstrap (copy or --with-ai-rules submodule|clone).
  2. Selected adapters are materialized with delivery-aware paths (tools/ai-rules/ when mounted).
  3. Project overlays beside managed filenames are preserved.
  4. a2c doctor warns when selected adapter files are missing or stale.

Managed Cursor files: 00-a2c-core.mdc, 01-adr-commits.mdc, 02-prompt-usage.mdc.

Managed Copilot files: .github/copilot-instructions.md plus 00-a2c-core.instructions.md, 01-adr-commits.instructions.md, 02-prompt-usage.instructions.md under .github/instructions/.

Cursor-specific notes​

Cursor loads .cursor/rules/, not method cursor/rules/. Prompt @ references still use prompts/... or tools/ai-rules/prompts/... for mounts.

Historical detail: cursor-integration.md.

Copilot-specific notes​

Copilot applies .github/copilot-instructions.md to workspace chat and loads .github/instructions/*.instructions.md when applyTo matches (A2C managed files use applyTo: "**").

Prompt entry points remain the same Markdown files under prompts/ (or the mounted method tree).