AGENTS.md and agent guardrails

AGENTS.md as the one project guide for every coding agent, with hooks for Claude Code, Codex, Cursor and OpenCode that block destructive commands and secret writes. Claude Code and OpenCode also lint on write and format the agent's edits; Claude Code gets CLAUDE.md and Cursor a rule pointing at AGENTS.md.

Category: agent-ops

In your existing repository

Ask your agent to check compatibility, follow this fragment’s brief, and verify the resulting project. What happens next

Applies to:: all stacks

Add to your project

Paste the prompt into the coding agent working on your project.

View prompt

Add the agent-ops fragment to this existing repository. 1. Run npx @steamfield/stacks show agent-ops --json and check that it fits the project. If it does not, explain why before changing files. 2. Run npx @steamfield/stacks add agent-ops and follow the brief it prints. 3. In this repository, run npx @steamfield/stacks verify. Fix failures without weakening or skipping verification steps. 4. Summarize what changed and the verification result. Quote published stats only when they are available, including their interval and sample size. The stacks docs, written for agents, are at https://stacks.steamfield.io/llms.txt.

Or use the terminal

npx @steamfield/stacks add agent-ops

Verify steps
Step	Phase	Layer	Command
agents-md-filled	check	check	`test -s AGENTS.md && ! grep -n 'stacks:fill' AGENTS.md`
claude-readme-filled	check	check	`test ! -f .claude/README.md \|\| ! grep -n 'stacks:fill' .claude/README.md`

Use with a new stack

Starting fresh instead? These stacks support this fragment.

astro-blogdefault
npx @steamfield/stacks new astro-blog
astro-fullstackoptional
npx @steamfield/stacks new astro-fullstack --with agent-ops
mobile-expodefault
npx @steamfield/stacks new mobile-expo
python-apidefault
npx @steamfield/stacks new python-api
go-clidefault
npx @steamfield/stacks new go-cli
go-apidefault
npx @steamfield/stacks new go-api
nextjsoptional
npx @steamfield/stacks new nextjs --with agent-ops
python-reactdefault
npx @steamfield/stacks new python-react
cloudflare-react-routerdefault
npx @steamfield/stacks new cloudflare-react-router
react-routeroptional
npx @steamfield/stacks new react-router --with agent-ops
sveltekitoptional
npx @steamfield/stacks new sveltekit --with agent-ops
tauri-reactoptional
npx @steamfield/stacks new tauri-react --with agent-ops
typescript-clioptional
npx @steamfield/stacks new typescript-cli --with agent-ops
typescript-apioptional
npx @steamfield/stacks new typescript-api --with agent-ops

Alternatives in agent-ops

Claude Code TypeScript hooks
Bun TypeScript hook helpers and tested Claude Code guards on top of agent-ops (destructive commands, package manager, generated files, typecheck on write), plus /check, /test and /feature commands, architect and reviewer agents, and a docs/harness.md guide.
Also applies to: astro-blog, astro-fullstack, mobile-expo, nextjs, python-react, cloudflare-react-router, react-router, sveltekit, tauri-react, typescript-cli, typescript-api
Claude Essentials plugin
Enables the claude-essentials (ce) Claude Code plugin for the project and adds path-scoped rules that point Claude at its skills for testing, error handling, debugging, and writing.
Also applies to: astro-blog, astro-fullstack, mobile-expo, python-api, go-cli, go-api, nextjs, python-react, cloudflare-react-router, react-router, sveltekit, tauri-react, typescript-cli, typescript-api

Files

.claude/hooks/_destructive-patterns.sh
.claude/hooks/_lib.sh
.claude/hooks/block-destructive.sh
.claude/hooks/detect-secrets.sh
.claude/hooks/format-changed.sh
.claude/hooks/lint-on-write.sh
AGENTS.md.tmpl

Usage

Among stacks projects in the 28 days through 30 Oct 2026: 24,965 projects; 76% reached a green verify (76–77%, n=17,410).

Weekly projects by stack

Projects whose final fragment set included this fragment, grouped by stack.

12 weeksAvailable history

astro-blog
cloudflare-react-router
go-api
go-cli
mobile-expo
python-api
python-react

astro-blog
cloudflare-react-router
go-api
go-cli
mobile-expo
python-api
python-react

Stacks projects per UTC week through 30 Oct 2026. Published stack counts only.

Data table

Week ending	Stack	Projects
5 Jul 2026	astro-blog	95
12 Jul 2026	astro-blog	185
19 Jul 2026	astro-blog	270
26 Jul 2026	astro-blog	365
2 Aug 2026	astro-blog	335
9 Aug 2026	astro-blog	355
16 Aug 2026	astro-blog	405
23 Aug 2026	astro-blog	420
30 Aug 2026	astro-blog	445
6 Sept 2026	astro-blog	450
13 Sept 2026	astro-blog	450
20 Sept 2026	astro-blog	590
27 Sept 2026	astro-blog	575
4 Oct 2026	astro-blog	550
11 Oct 2026	astro-blog	610
18 Oct 2026	astro-blog	640
25 Oct 2026	astro-blog	645
5 Jul 2026	cloudflare-react-router	–
12 Jul 2026	cloudflare-react-router	–
19 Jul 2026	cloudflare-react-router	5
26 Jul 2026	cloudflare-react-router	–
2 Aug 2026	cloudflare-react-router	5
9 Aug 2026	cloudflare-react-router	5
16 Aug 2026	cloudflare-react-router	5
23 Aug 2026	cloudflare-react-router	5
30 Aug 2026	cloudflare-react-router	10
6 Sept 2026	cloudflare-react-router	5
13 Sept 2026	cloudflare-react-router	10
20 Sept 2026	cloudflare-react-router	10
27 Sept 2026	cloudflare-react-router	10
4 Oct 2026	cloudflare-react-router	10
11 Oct 2026	cloudflare-react-router	10
18 Oct 2026	cloudflare-react-router	10
25 Oct 2026	cloudflare-react-router	10
5 Jul 2026	go-api	160
12 Jul 2026	go-api	295
19 Jul 2026	go-api	420
26 Jul 2026	go-api	490
2 Aug 2026	go-api	565
9 Aug 2026	go-api	555
16 Aug 2026	go-api	645
23 Aug 2026	go-api	630
30 Aug 2026	go-api	690
6 Sept 2026	go-api	750
13 Sept 2026	go-api	790
20 Sept 2026	go-api	820
27 Sept 2026	go-api	845
4 Oct 2026	go-api	915
11 Oct 2026	go-api	965
18 Oct 2026	go-api	1,010
25 Oct 2026	go-api	955
5 Jul 2026	go-cli	85
12 Jul 2026	go-cli	145
19 Jul 2026	go-cli	195
26 Jul 2026	go-cli	245
2 Aug 2026	go-cli	265
9 Aug 2026	go-cli	300
16 Aug 2026	go-cli	315
23 Aug 2026	go-cli	350
30 Aug 2026	go-cli	400
6 Sept 2026	go-cli	480
13 Sept 2026	go-cli	555
20 Sept 2026	go-cli	705
27 Sept 2026	go-cli	780
4 Oct 2026	go-cli	1,000
11 Oct 2026	go-cli	1,130
18 Oct 2026	go-cli	1,280
25 Oct 2026	go-cli	1,320
5 Jul 2026	mobile-expo	515
12 Jul 2026	mobile-expo	820
19 Jul 2026	mobile-expo	1,110
26 Jul 2026	mobile-expo	1,410
2 Aug 2026	mobile-expo	1,490
9 Aug 2026	mobile-expo	1,650
16 Aug 2026	mobile-expo	1,830
23 Aug 2026	mobile-expo	1,920
30 Aug 2026	mobile-expo	1,970
6 Sept 2026	mobile-expo	2,055
13 Sept 2026	mobile-expo	2,250
20 Sept 2026	mobile-expo	2,295
27 Sept 2026	mobile-expo	2,450
4 Oct 2026	mobile-expo	2,450
11 Oct 2026	mobile-expo	2,670
18 Oct 2026	mobile-expo	2,745
25 Oct 2026	mobile-expo	2,915
5 Jul 2026	python-api	–
12 Jul 2026	python-api	–
19 Jul 2026	python-api	–
26 Jul 2026	python-api	–
2 Aug 2026	python-api	5
9 Aug 2026	python-api	5
16 Aug 2026	python-api	5
23 Aug 2026	python-api	5
30 Aug 2026	python-api	5
6 Sept 2026	python-api	5
13 Sept 2026	python-api	–
20 Sept 2026	python-api	5
27 Sept 2026	python-api	–
4 Oct 2026	python-api	5
11 Oct 2026	python-api	5
18 Oct 2026	python-api	10
25 Oct 2026	python-api	5
5 Jul 2026	python-react	360
12 Jul 2026	python-react	610
19 Jul 2026	python-react	835
26 Jul 2026	python-react	1,045
2 Aug 2026	python-react	1,090
9 Aug 2026	python-react	1,215
16 Aug 2026	python-react	1,260
23 Aug 2026	python-react	1,320
30 Aug 2026	python-react	1,410
6 Sept 2026	python-react	1,465
13 Sept 2026	python-react	1,530
20 Sept 2026	python-react	1,585
27 Sept 2026	python-react	1,775
4 Oct 2026	python-react	1,860
11 Oct 2026	python-react	1,415
18 Oct 2026	python-react	1,185
25 Oct 2026	python-react	865

By stack

How often this fragment stays in a default composition, or gets attached as an option.

astro-blog

Default · kept92%

2,360 projects including the fragment

cloudflare-react-router

Default · kept88%

35 projects including the fragment

go-api

Default · kept91%

3,605 projects including the fragment

go-cli

Default · kept92%

4,625 projects including the fragment

mobile-expo

Default · kept92%

10,310 projects including the fragment

python-api

Default · kept100%

25 projects including the fragment

python-react

Default · kept91%

4,010 projects including the fragment

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Data table

Stack	Projects	Role	Share
astro-blog	2,360	Default · kept	92%
cloudflare-react-router	35	Default · kept	88%
go-api	3,605	Default · kept	91%
go-cli	4,625	Default · kept	92%
mobile-expo	10,310	Default · kept	92%
python-api	25	Default · kept	100%
python-react	4,010	Default · kept	91%

Green rate with and without it

This compares projects; it isn't an effect of the fragment.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Often used with

Co-occurrence above the baseline, within a stack. Required fragment pairs are excluded.

Not enough runs in this breakdown yet.

Stacks projects · 28 days through 30 Oct 2026. Counts rounded to 5.

Computed 31 Oct 2026, through 30 Oct 2026. Numbers describe stacks projects, not the ecosystem.