diff --git a/.github/skills/documentation/SKILL.md b/.agents/skills/documentation/SKILL.md similarity index 100% rename from .github/skills/documentation/SKILL.md rename to .agents/skills/documentation/SKILL.md diff --git a/.github/skills/fast-bug-report/SKILL.md b/.agents/skills/fast-bug-report/SKILL.md similarity index 95% rename from .github/skills/fast-bug-report/SKILL.md rename to .agents/skills/fast-bug-report/SKILL.md index ba4a90d7198..c3639c804d0 100644 --- a/.github/skills/fast-bug-report/SKILL.md +++ b/.agents/skills/fast-bug-report/SKILL.md @@ -9,7 +9,7 @@ generating the markdown content for a new issue based on the provided template. Based on the conversation context, generate a bug report as a markdown code block using the template located at -[../../ISSUE_TEMPLATE/bug-report.md](../../ISSUE_TEMPLATE/bug-report.md). +[../../../.github/ISSUE_TEMPLATE/bug-report.md](../../../.github/ISSUE_TEMPLATE/bug-report.md). The summary should clearly state what the bug is and which part of the system is affected. diff --git a/.github/skills/fast-feature-request/SKILL.md b/.agents/skills/fast-feature-request/SKILL.md similarity index 94% rename from .github/skills/fast-feature-request/SKILL.md rename to .agents/skills/fast-feature-request/SKILL.md index fc529c6a32c..20062037df3 100644 --- a/.github/skills/fast-feature-request/SKILL.md +++ b/.agents/skills/fast-feature-request/SKILL.md @@ -9,7 +9,7 @@ generating the markdown content for a new issue based on the provided template. Based on the conversation context, generate a feature request as a markdown code block using the template located at -[../../ISSUE_TEMPLATE/feature-request.md](../../ISSUE_TEMPLATE/feature-request.md). +[../../../.github/ISSUE_TEMPLATE/feature-request.md](../../../.github/ISSUE_TEMPLATE/feature-request.md). The summary should clearly state what the feature is and why it matters, focusing on user value rather than implementation details. diff --git a/.github/skills/fast-pull-request/SKILL.md b/.agents/skills/fast-pull-request/SKILL.md similarity index 97% rename from .github/skills/fast-pull-request/SKILL.md rename to .agents/skills/fast-pull-request/SKILL.md index ab09ae21fab..7334f6586e1 100644 --- a/.github/skills/fast-pull-request/SKILL.md +++ b/.agents/skills/fast-pull-request/SKILL.md @@ -9,7 +9,7 @@ generating the markdown content for a pull request description based on the prov Based on the conversation context, generate a pull request description as a markdown code block using the template located at -[../../pull_request_template.md](../../pull_request_template.md). +[../../../.github/pull_request_template.md](../../../.github/pull_request_template.md). Use the Pull Request Template to generate a markdown code block for the most relevant work on this git branch, compared to `main`. diff --git a/.github/skills/rust/SKILL.md b/.agents/skills/rust/SKILL.md similarity index 100% rename from .github/skills/rust/SKILL.md rename to .agents/skills/rust/SKILL.md diff --git a/.github/skills/shipping/SKILL.md b/.agents/skills/shipping/SKILL.md similarity index 96% rename from .github/skills/shipping/SKILL.md rename to .agents/skills/shipping/SKILL.md index 3f65827077f..aa7199f9801 100644 --- a/.github/skills/shipping/SKILL.md +++ b/.agents/skills/shipping/SKILL.md @@ -24,7 +24,7 @@ You may prepare all of these (e.g., draft a PR description, generate change file Read these documents for additional context when needed: -- [`.github/pull_request_template.md`](../../pull_request_template.md) — PR description template (source of truth for PR structure). +- [`.github/pull_request_template.md`](../../../.github/pull_request_template.md) — PR description template (source of truth for PR structure). - [`CONTRIBUTING.md`](../../../CONTRIBUTING.md) — Full contributor guide (machine setup, branching, governance). - [`BRANCH_GUIDE.md`](../../../BRANCH_GUIDE.md) — Branch management conventions. - [`beachball.config.js`](../../../beachball.config.js) — Beachball configuration (ignored patterns, publish settings). @@ -54,7 +54,7 @@ Examples: # Pull requests -Use the repository's PR template at [`.github/pull_request_template.md`](../../pull_request_template.md) as the basis for all pull request descriptions. +Use the repository's PR template at [`.github/pull_request_template.md`](../../../.github/pull_request_template.md) as the basis for all pull request descriptions. Provide the markdown code block only, without any additional commentary or explanation. @@ -159,7 +159,8 @@ When prompted, select the appropriate change type: The Beachball config ([`beachball.config.js`](../../../beachball.config.js)) ignores these paths — changes limited to them do not need change files: -- `.github/` — CI configs, templates, skills +- `.github/` — CI configs, templates +- `.agents/skills/` — agent skills - Test files (`src/e2e/`, `src/tests/`, `src/fixtures/`) - `package-lock.json` - `.vscode/`, `.prettierrc` diff --git a/.github/skills/testing/SKILL.md b/.agents/skills/testing/SKILL.md similarity index 100% rename from .github/skills/testing/SKILL.md rename to .agents/skills/testing/SKILL.md diff --git a/.github/skills/typescript/SKILL.md b/.agents/skills/typescript/SKILL.md similarity index 100% rename from .github/skills/typescript/SKILL.md rename to .agents/skills/typescript/SKILL.md diff --git a/.claude/skills/documentation/SKILL.md b/.claude/skills/documentation/SKILL.md new file mode 100644 index 00000000000..54a8cfd6aaa --- /dev/null +++ b/.claude/skills/documentation/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/documentation/SKILL.md diff --git a/.claude/skills/fast-bug-report/SKILL.md b/.claude/skills/fast-bug-report/SKILL.md new file mode 100644 index 00000000000..1c78346588a --- /dev/null +++ b/.claude/skills/fast-bug-report/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/fast-bug-report/SKILL.md diff --git a/.claude/skills/fast-feature-request/SKILL.md b/.claude/skills/fast-feature-request/SKILL.md new file mode 100644 index 00000000000..466fae12ac4 --- /dev/null +++ b/.claude/skills/fast-feature-request/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/fast-feature-request/SKILL.md diff --git a/.claude/skills/fast-pull-request/SKILL.md b/.claude/skills/fast-pull-request/SKILL.md new file mode 100644 index 00000000000..4ddd5368be6 --- /dev/null +++ b/.claude/skills/fast-pull-request/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/fast-pull-request/SKILL.md diff --git a/.claude/skills/rust/SKILL.md b/.claude/skills/rust/SKILL.md new file mode 100644 index 00000000000..d1867568a07 --- /dev/null +++ b/.claude/skills/rust/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/rust/SKILL.md diff --git a/.claude/skills/shipping/SKILL.md b/.claude/skills/shipping/SKILL.md new file mode 100644 index 00000000000..156bb5c839e --- /dev/null +++ b/.claude/skills/shipping/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/shipping/SKILL.md diff --git a/.claude/skills/testing/SKILL.md b/.claude/skills/testing/SKILL.md new file mode 100644 index 00000000000..221f1dd4d4a --- /dev/null +++ b/.claude/skills/testing/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/testing/SKILL.md diff --git a/.claude/skills/typescript/SKILL.md b/.claude/skills/typescript/SKILL.md new file mode 100644 index 00000000000..94926e7a8f0 --- /dev/null +++ b/.claude/skills/typescript/SKILL.md @@ -0,0 +1 @@ +@../../../.agents/skills/typescript/SKILL.md diff --git a/.github/copilot-instructions.md b/AGENTS.md similarity index 83% rename from .github/copilot-instructions.md rename to AGENTS.md index 55ea5e9bc39..a0490c37d76 100644 --- a/.github/copilot-instructions.md +++ b/AGENTS.md @@ -1,9 +1,3 @@ ---- -name: FAST Instructions -description: This file describes the general instructions for working with the FAST monorepo, including repository structure, code style, tooling, and contribution guidelines. -applyTo: '**/*' ---- - # Instructions for FAST ## General @@ -44,14 +38,14 @@ Each package includes a DESIGN.md file, read that to gain a general understandin These contain domain-specific guidance. Read when performing related tasks: -- [TypeScript](./skills/typescript/SKILL.md) — compiler constraints, import/export conventions, decorator usage, testing patterns. -- [Rust](./skills/rust/SKILL.md) — general guidance on performing updates between the crate and package. -- [Shipping](./skills/shipping/SKILL.md) — pull request format, change file generation, documentation updates. -- [Pull Request](./skills/fast-pull-request/SKILL.md) — generate a pull request description from the branch diff. -- [Bug Report](./skills/fast-bug-report/SKILL.md) — generate a bug report issue from conversation context. -- [Feature Request](./skills/fast-feature-request/SKILL.md) — generate a feature request issue from conversation context. -- [Testing](./skills/testing/SKILL.md) — running tests locally and in CI, writing Playwright fixture tests. -- [Documentation](./skills/documentation/SKILL.md) — adding documentation in code, markdown files in each package/crate, and the website. +- [TypeScript](./.agents/skills/typescript/SKILL.md) — compiler constraints, import/export conventions, decorator usage, testing patterns. +- [Rust](./.agents/skills/rust/SKILL.md) — general guidance on performing updates between the crate and package. +- [Shipping](./.agents/skills/shipping/SKILL.md) — pull request format, change file generation, documentation updates. +- [Pull Request](./.agents/skills/fast-pull-request/SKILL.md) — generate a pull request description from the branch diff. +- [Bug Report](./.agents/skills/fast-bug-report/SKILL.md) — generate a bug report issue from conversation context. +- [Feature Request](./.agents/skills/fast-feature-request/SKILL.md) — generate a feature request issue from conversation context. +- [Testing](./.agents/skills/testing/SKILL.md) — running tests locally and in CI, writing Playwright fixture tests. +- [Documentation](./.agents/skills/documentation/SKILL.md) — adding documentation in code, markdown files in each package/crate, and the website. ## Commands @@ -111,7 +105,7 @@ packages// - Import ordering enforced via `organizeImports`. - No `I` prefix on interfaces. - `any` is permitted (`noExplicitAny: off`). -- Config: [`biome.jsonc`](../biome.jsonc). +- Config: [`biome.jsonc`](./biome.jsonc). ### Naming Conventions @@ -127,7 +121,7 @@ packages// ### TypeScript -Key constraints (details in [TypeScript skill](./skills/typescript/SKILL.md)): +Key constraints (details in [TypeScript skill](./.agents/skills/typescript/SKILL.md)): - ESM only (`"type": "module"`) — imports use `.js` extensions. - `import type { ... }` required for type-only imports (`verbatimModuleSyntax`). @@ -160,4 +154,4 @@ Before finishing any change, run these commands from the monorepo root and confi - [ ] `npm run biome:check` — Biome linting and formatting pass - [ ] `npm run checkchange` — beachball change files exist for any `packages/*` changes -Read the [shipping skill](./skills/shipping/SKILL.md) and ensure you have updated everything outlined in that file. +Read the [shipping skill](./.agents/skills/shipping/SKILL.md) and ensure you have updated everything outlined in that file. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 120000 index 00000000000..47dc3e3d863 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file