MicrosoftKnown publishermicrosoft/fluentui-react-native/packages/agentic/design/AGENTS.md

fluentui-react-native / design

AGENTS.md1.4k starsChanged 5 months agoMITView on GitHub

This is the instruction root for @fluentui-react-native/design and every descendant. The package owns Fluent UI React Native's theming contract: theme sources and providers, ready-made Fluent and Flex themes, structured appearance, Flex and legacy tokens, the token mappings, themed style factories, the runtime color library, and test-only design fixtures. Read the user guide, then select the narrowest topic in the reference index: Component authors applying tokens and styles also follow their component workflow; for agentic components that is the repository reference…

Oct 31, 2021[rush] Why does many Microsoft open-source projects not use rush. — microsoft/rushstack3 reactions · 6 comments
Feb 25, 2026chore: migrate to changesets — microsoft/react-native-macos1 reaction · 1 comment
Aug 11, 2023docs: add explainer for gotchas with NSView based native components — microsoft/react-native-macos1 reaction · 1 comment
Mar 5, 2026ci: Add 2 bots to CLA policies — microsoft/.github0 reactions · 1 comment
Sep 16, 2025Update Fabric branch to main — chrisglein/artificial-chat0 reactions

31 more on GitHub

Dec 18, 2024Update to 0.76 — chrisglein/artificial-chat0 reactions
Apr 24, 2024Add FURN (fluent-ui-react-native) to Gallery — microsoft/react-native-gallery0 reactions · 2 comments
Aug 11, 2023bug: Cannot install drivers when using workspace:* with yarn 3 — appium/appium0 reactions · 5 comments
Aug 8, 2023Files are generated under the wrong folder if no `node_modules` folder exists — microsoft/react-native-test-app0 reactions
May 9, 2023Retarget Community Module's TargetPlatformMinVersion — microsoft/react-native-gallery0 reactions · 1 comment
May 3, 2023Change the UI library to TUI or another — ZOPH3/WhatsThat_TS0 reactions
May 2, 2023Move react-native-svg from dependencies to peerDependencies — microsoft/fluentui-system-icons0 reactions · 3 comments
Apr 3, 2023Add fluent-ui-react-native controls and update various visual styles — chrisglein/artificial-chat0 reactions · 2 comments
Mar 31, 2023Use fluent-ui-react-native controls — chrisglein/artificial-chat0 reactions · 2 comments
Jan 1, 2023[🐛 Bug]: Appium Service v8 not compatible with WinAppDriver/Appium-Windows-Driver — webdriverio/webdriverio0 reactions · 1 comment
Dec 31, 2022keyUpEvents/keyDownEvents check `code`, not `key` — microsoft/react-native-windows0 reactions · 8 comments
Dec 14, 2022Setting the testID on the view does not prevent it from being removed from the view hierarchy — microsoft/react-native-windows0 reactions
Dec 14, 2022Setting the testID on the view does not prevent it from being removed from the view hierarchy — microsoft/react-native-macos0 reactions · 1 comment
Nov 15, 2022Remove faulty logic in ScrollView — microsoft/react-native-macos0 reactions · 2 comments
Oct 31, 2022Aligning Avatar color hash color algorithm with web — microsoft/fluentui-apple0 reactions · 6 comments
Oct 25, 2022fix(jest-preset): `@office-iss/react-native-win32` needs to be transformed — microsoft/rnx-kit0 reactions
Oct 14, 2022Pressable unnecessarily re-renders if `disabled` prop is true — react/react-native0 reactions · 4 comments
Jul 12, 2022Restore Git Tags for Canaries — microsoft/react-native-windows0 reactions · 3 comments
Jul 8, 2022Running rnx-bundle fails after updating to latest rnx-kit/dep-check and rnx-kit/metro-config — microsoft/rnx-kit0 reactions · 3 comments
Mar 7, 2022fix: Add clang static analysis flags — microsoft/react-native-test-app0 reactions · 4 comments
Feb 4, 2022Module resolving failed when bumping to new version of metro-config — microsoft/rnx-kit0 reactions · 2 comments
Feb 2, 2022[0.64] Trying to fetch NuGet package for v0.64.29 fails — microsoft/react-native-windows0 reactions · 1 comment
Dec 16, 2021fix(windows): disable appx package signing — microsoft/react-native-test-app0 reactions · 1 comment
Nov 17, 2021fix(android): set `project.ext.minSdkVersion` for community modules — microsoft/react-native-test-app0 reactions · 1 comment
Nov 14, 2021Port windows fork of Pressable to win32 — microsoft/react-native-windows0 reactions · 16 comments
Aug 6, 2021add `@fluentui/react-native` to the directory — react-native-community/directory0 reactions · 2 comments
Aug 5, 2021Bumping Lage from 0.31.0 to 0.32.0 broke our monorepo's pipeline — microsoft/lage0 reactions · 3 comments
May 25, 2021[react-native] Change ColorValue type so that it can be assignable from objects — DefinitelyTyped/DefinitelyTyped0 reactions · 5 comments
Oct 24, 2020Apple: Name the scheme something other than "ReactTestApp" — microsoft/react-native-test-app0 reactions · 1 comment
Jun 23, 2020Split out Xcode build configuration to separate files — microsoft/react-native-test-app0 reactions · 13 comments
May 14, 2020Setup E2ETest for React Native Win32/NetUI — microsoft/react-native-windows0 reactions · 4 comments

On Bluesky · 1

Dec 21, 2024Microsoft is developing a UI library, but it’s still in Alpha. — @migueldv90.bsky.social1 likes and repost

Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 31,774 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- apps/storybook/AGENTS.mdAGENTS.md
- packages/agentic/components/AGENTS.mdAGENTS.md
- packages/agentic/desktop-driver/AGENTS.mdAGENTS.md
- packages/agentic/desktop-driver-mcp/AGENTS.mdAGENTS.md
- packages/agentic/desktop-test/AGENTS.mdAGENTS.md
- packages/agentic/native-core/AGENTS.mdAGENTS.md
- packages/agentic/storybook-desktop/AGENTS.mdAGENTS.md
- packages/agentic/storybook-desktop-runtime/AGENTS.mdAGENTS.md
- packages/deprecated/foundation-compose/AGENTS.mdAGENTS.md
- packages/framework-base/AGENTS.mdAGENTS.md
- packages/framework/framework/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- agentic-component-authoringSkill
- agentic-component-contract-authoringSkill
- agentic-component-optimizationSkill
- agentic-storybook-developmentSkill
- desktop-testingSkill
- fix-security-issuesSkill
- implement-native-componentSkill
- maintain-desktop-testingSkill
- maintain-v0-v1-componentSkill
- review-componentSkill

The file

We split this AGENTS.md into the rules it gives an agent

8 rules. About 0 are common, 3 are distinctive, and 5 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Read the user guide, then select the narrowest topic in the reference index:
line 9
Very specific:
Keep one ThemeProvider for both authoring models.
line 28
Distinctive:
Keep the root entry point free of the legacy projection, deprecated token data, and color compositing.
line 32
Distinctive:
Keep color resolution lazy: resolving, merging, and reading rest never run the interaction algorithm, and a derived state computes once per …
line 35
Very specific:
Treat src/tokens/mappings/flex-token-map.yaml as the canonical token mapping (R-DESIGN-001), and regenerate rather than edit generated …
line 37
Very specific:
Keep the Fluent 2 token JSON loaders and pipeline mappers in src/deprecated/.
line 40
Very specific:
Update the owning reference with every behavior or API change, and record unfinished work only in references/remaining-work.md …
line 43
Very specific:
Run yarn format, yarn lint, yarn build, yarn test, and yarn check:mappings in this package, add a changeset, and finish with yarn …
line 48

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

AGENTS.md

Design agent instructions

This is the instruction root for @fluentui-react-native/design and every descendant. The package owns Fluent UI React Native's theming contract: theme sources and providers, ready-made Fluent and Flex themes, structured appearance, Flex and legacy tokens, the token mappings, themed style factories, the runtime color library, and test-only design fixtures.

Start here

Read the user guide, then select the narrowest topic in the reference index:

Task	Read
Theme authoring, providers, appearance, theme hooks, or legacy projection	Theming
Authoring, resolving, or reading Flex colors, or migrating flat colors	Flex colors
Token sources, Flex token mapping, or the pinned x3 source	Tokens
Themed style caches or state and color style factories	Styling
Runtime color parsing, contrast, or interaction colors	Color library
Test fixtures or contrast validation	Testing helpers
Exports, subpaths, bundle boundaries, or compatibility packages	Entry points
Source layout, generated files, tests, or validation	Contributing
Planning theming or appearance work	Remaining work

Component authors applying tokens and styles also follow their component workflow; for agentic components that is the repository reference components.agentic.styles-and-tokens.

Invariants

Keep one ThemeProvider for both authoring models. Providers publish metadata; only hooks construct converted models, and neither hook constructs the model it does not return.
Key caches by source, revision, and resolved appearance, keep them outside author-owned objects, and give every new ThemeState a new style registry.
Keep the root entry point free of the legacy projection, deprecated token data, and color compositing; it reaches the color library's interaction algorithm only through the Flex interaction policy. Legacy and optional APIs stay behind their subpaths.
Keep color resolution lazy: resolving, merging, and reading rest never run the interaction algorithm, and a derived state computes once per resolved color.
Treat src/tokens/mappings/flex-token-map.yaml as the canonical token mapping (R-DESIGN-001), and regenerate rather than edit generated token and projection files.
Production code must not depend on the testing entry point (R-DESIGN-002).
Keep the Fluent 2 token JSON loaders and pipeline mappers in src/deprecated/. Only tests, other deprecated code, build scripts, and the existing deprecated consumers may use them, and no other entry point may reach them (R-DESIGN-003).
Update the owning reference with every behavior or API change, and record unfinished work only in references/remaining-work.md (R-PKGDOC-009).

Validation

Run yarn format, yarn lint, yarn build, yarn test, and yarn check:mappings in this package, add a changeset, and finish with yarn clean-lage-cache followed by yarn lage buildci. See contributing.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free