copilot / rules

---
description: Current repository context, commands, and documentation authority
alwaysApply: true
---

# Copilot project context

Copilot is a GitHub Action and CLI for issue/PR automation, branch management,
Bugbot, and configurable release/hotfix orchestration. Agent roles can use
Codex, OpenCode, or Cursor according to the validated repository configuration;
no provider is an implicit compatibility path for another.

Use Node 24 or newer and pnpm from the repository root:

```bash
nvm use 24
pnpm install
pnpm build
pnpm test
pnpm test:coverage
pnpm lint
pnpm typecheck
```

Important boundaries:

- Runtime inputs: `action.yml` and `src/application/contracts/input_keys.ts`.
- Single actions: `src/data/model/action_types.ts`.
- Architecture: `_agent/docs/architecture.md`,
  `docs/development/architecture.mdx`, and `docs/dependency-rules.md`.
- Flows: `_agent/docs/usecase-flows.md`.
- Coding rules: `_agent/docs/code-conventions.md`.
- Generated bundles: `build/`; regenerate them with `pnpm build`, never edit
  them directly.

When a contract changes, update source, tests, setup workflows, `action.yml`,
public documentation, internal agent documentation, and generated bundles in
the same change.