This file is mirrored in
.github/copilot-instructions.md. Changes here should be duplicated there, and vice versa.
When writing asserts (from @fluidframework/core-utils), use a string literal for the error message, not a hex assert code. This applies only to newly added asserts, not existing ones.
API report files are generated artifacts — never hand-edit them. If they need updating, rebuild and regenerate via build:api-reports. If you are working in @fluidframework/tree or its aggregator (fluid-framework) and encounter unexpected API report diffs, read .claude/skills/ci-readiness-check/tree-api-checks.md before attempting to fix them.
The ADO project for work items and pipelines is internal (not FluidFramework).
Use internal when calling ADO tools that require a project name.
When writing ADO work-item fields (Description, comments, etc.), never reference a GitHub issue or PR with a bare #<number> (or AB#<number>) — ADO auto-links those to a work item in the internal org, not to GitHub. Always use the full URL https://github.com/microsoft/FluidFramework/pull/<n> (or /issues/<n>), ideally as a markdown link like [PR #<n>](url). Reserve bare #<n> / AB#<n> for actual ADO work items.
- Name: FF Internal Wiki
- Wiki ID:
4b8ab5e8-1add-4e4b-bb65-d9b870a98ad4 - Project:
internal - Mapped path:
/docs(page paths are relative to this — e.g. the api-council page is at/dev/resources/api council)
Use mcp__ado__wiki_get_page_content with wikiIdentifier: "4b8ab5e8-1add-4e4b-bb65-d9b870a98ad4" and project: "internal" to fetch pages directly by path without searching first.