workflow / web-shared
AGENTS.md2.5k starsChanged 13 months agoApache-2.0View on GitHub
These rules apply to packages/web-shared and packages/web (which consumes it). Text colour always comes from a Geist token or the surface's inherited foreground. Don't make text lighter by fading it: A faded text colour depends on whatever is underneath it, so it becomes unreadable on another surface: the inverted tooltip pill, dark mode, or a coloured row. Geist tokens are defined for both themes. Opacity is fine for anything else, such as disabled controls, overlays, fades and animations, or dimming…
Trending
Quiet since September.thin dataabout the whole repository
Who's talking about vercel/workflow
- libredb/libredb-studio“fix(agent): retry transient Windows ledger probes”GitHub · Sep 16, 2026 · 1 reactions
- vinnymac/worlds“Cloudflare Workers e2e is blocked by Workflow's node:vm runtime dependency”GitHub · May 19, 2026 · 1 reactions
- haydenbleasel/ultracite“Resolve workflow issues”GitHub · Dec 29, 2025 · 1 reactions
- @u11g.com“Functions that pause for months and survive crashes? Durability without the infrastructure complexity! …”Bluesky · Nov 2, 2025 · 1 likes
- nitrojs/nitro“Plugin registered handlers are not bundled”GitHub · Oct 30, 2025 · 1 reactions
The biggest 5 of 9 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 9
Talked about on GitHub and Bluesky (9 times).
On GitHub · 7
- Sep 16, 2026fix(agent): retry transient Windows ledger probes — libredb/libredb-studio1 reaction · 1 comment
- May 19, 2026Cloudflare Workers e2e is blocked by Workflow's node:vm runtime dependency — vinnymac/worlds1 reaction
- Dec 29, 2025Resolve workflow issues — haydenbleasel/ultracite1 reaction · 1 comment
- Oct 30, 2025Plugin registered handlers are not bundled — nitrojs/nitro1 reaction · 2 comments
- Jun 27, 2026[Backlog] Workflow / Outlines / Codex Ops Research — roezi/ob-engine-community0 reactions · 1 comment
2 more on GitHub
- May 19, 2026Cloudflare Workers e2e is blocked by Workflow's node:vm runtime dependency — ataylorme/workflow-world-cloudflare0 reactions
- Dec 16, 2025Presence of a workaround due to upstream issues in the workflow library — remiconnesson/v0-video2md0 reactions
On Bluesky · 2
- Nov 2, 2025Functions that pause for months and survive crashes? Durability without the infrastructure complexity! https://github.com/vercel/workflow — @u11g.com1 likes and repost
- Oct 25, 2025vercel/workflow: Workflow DevKit: Build durable, resilient, and observable workflows — @fluid.sublimer.me1 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,439 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 repository12 other files it gives its agents.
- AGENTS.mdAGENTS.md
- packages/web/AGENTS.mdAGENTS.md
- workbench/nextjs-turbopack/AGENTS.mdAGENTS.md
- workbench/nextjs-turbopack/CLAUDE.mdCLAUDE.md
- .cursor/rules/swc-plugin.mdcCursor rule
- .cursor/rules/workflow-deployment.mdcCursor rule
- internal-dev-workbenchSkill
- migrating-to-workflow-sdkSkill
- migrating-workflow-v4-to-v5Skill
- migrating-world-v4-to-v5Skill
- workflow-initSkill
- workflowSkill
The file
We split this AGENTS.md into the rules it gives an agent
3 rules. About 0 are common, 0 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 10
no text-colour alpha modifiers (text-muted-foreground/70, text-foreground/50)
- Very specific: line 11
no inline or CSS color with alpha (rgba(…, 0.8))
- Very specific: line 19
Use the same tokens as the dashboard in vercel/front (apps/vercel-site):
≈ “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.
Files
Observability UI styling rules
These rules apply to packages/web-shared and packages/web (which consumes it).
Never use opacity to set a text colour
Text colour always comes from a Geist token or the surface's inherited foreground. Don't make text lighter by fading it:
- no
opacity-*on an element to mute its text (<span className="opacity-60">) - no text-colour alpha modifiers (
text-muted-foreground/70,text-foreground/50) - no inline or CSS
colorwith alpha (rgba(…, 0.8))
A faded text colour depends on whatever is underneath it, so it becomes unreadable on another surface: the inverted tooltip pill, dark mode, or a coloured row. Geist tokens are defined for both themes.
Opacity is fine for anything else, such as disabled controls, overlays, fades and animations, or dimming a whole row.
Follow the dashboard's patterns
Use the same tokens as the dashboard in vercel/front (apps/vercel-site):
| Need | Use |
| Primary text | text-gray-1000 (or inherit) |
| Secondary text, labels | text-gray-900, e.g. text-gray-900 text-label-13 for a field label |
| Tertiary text, hints, metadata, muted icons | text-gray-700 |
| Muted text that brightens on hover | text-gray-900 hover:text-gray-1000 |
| Status text | the -800 step of the scale: text-red-800, text-amber-800, text-green-800 |
| Text on an inverted surface (tooltip, selection bar) | inherit the surface's foreground. Don't add text-foreground / text-muted-foreground, which are meant for the light surface |
Content inside the shared Tooltip renders on a gray-1000 pill with background-100 text. Use the standard single tooltip: plain content in one colour, with no colour or text-size overrides.
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
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.

