AGENTS.md examples from real projects

Yeachan-HeoAGENTS.md

oh-my-claude-sisyphus

Yeachan-Heo/oh-my-claude-sisyphus/AGENTS.md

dependencies without an explicit request. - Keep diffs small and reversible. - Run lint, typecheck, tests, and static analysis after changes. - Final reports must include changed files, simplifications made, and remaining risks

Yeachan-HeoAGENTS.md

oh-my-claude-sisyphus

Yeachan-Heo/oh-my-claude-sisyphus/docs/AGENTS.md

version support changes | `COMPATIBILITY.md` | | End-user instructions change | `CLAUDE.md` | | Major user-facing features | `../README.md` | ### Testing Requirements - Verify markdown renders correctly - Check all internal links resolve - Validate code examples in documentation

Yeachan-HeoAGENTS.md

oh-my-claude-sisyphus / skills

Yeachan-Heo/oh-my-claude-sisyphus/skills/AGENTS.md

action | | `sdd/SKILL.md` | sdd | Spec-driven development: interview, spec with acceptance criteria, plan, test-first execution; `full` runs `phases/` | | `tdd/SKILL.md` | tdd | Test-first discipline at pre-agreed seams: tracer-bullet red/green

No other project uses it yet

Yeachan-HeoAGENTS.md

oh-my-claude-sisyphus / src

Yeachan-Heo/oh-my-claude-sisyphus/src/AGENTS.md

entry points and command surfaces | | `hud/` | Heads-up display components | | `installer/` | Installation system | | `__tests__/` | Test files | ## For AI Agents ### Working In This Directory 1. **Module Organization**: Each major feature

Yeachan-HeoAGENTS.md

oh-my-claudecode / skills

Yeachan-Heo/oh-my-claudecode/skills/AGENTS.md

agent's own prose: protected core, no filler, close on the action | | `tdd/SKILL.md` | tdd | Test-first discipline at pre-agreed seams: tracer-bullet red/green, independent expected values, boundary-class-only

No other project uses it yet

hyprwmAGENTS.md

Hyprland

hyprwm/Hyprland/AGENTS.md

readability. - For performance-sensitive paths, flag obvious algorithmic regressions or slow paths. - For tests, flag missing coverage for changed or new behavior, as long as the testing framework is capable

photoprismAGENTS.md

photoprism / frontend

photoprism/photoprism/frontend/AGENTS.md

stale, not the code. - After dep changes run `make audit`, `make build-js`, `make test-js`, and `make notice`. - Before adding a new dep — and especially before declaring an existing

No other project uses it yet

photoprismAGENTS.md

photoprism / internal

photoprism/photoprism/internal/AGENTS.md

sanitized error string, use `status.Error(err)` instead of hand-building it. ## Internal Tests & Fixtures - Keep Go scratch work inside `internal/...`; Go rejects imports from `internal/` when helpers live under paths

No other project uses it yet

photoprismAGENTS.md

photoprism / pkg

photoprism/photoprism/pkg/AGENTS.md

Package Security & Test Guidelines **Last Updated:** August 18, 2026 ## Archive Extraction Security - Always validate ZIP entry names with a safe join. Reject absolute paths, Windows drive or volume paths

No other project uses it yet

PostHogAGENTS.md

posthog

PostHog/posthog/AGENTS.md

commands fail - Never use `flox activate` in interactive sessions (it hangs if you try) - Tests: - Universal: `hogli test ` — auto-detects test type (Python, Jest, Playwright, Rust, Go) - Single test: `hogli

No other project uses it yet

PostHogAGENTS.md

posthog / proto

PostHog/posthog/proto/AGENTS.md

posthog/personhog_client/client.py` — add/remove wrapper methods for any new/removed RPCs - `posthog/personhog_client/fake_client.py` — implement the new method for test use ### 2. Node.js generated stubs ```bash cd nodejs && pnpm run generate:personhog-proto ``` Then update

gofiberAGENTS.md

fiber

gofiber/fiber/AGENTS.md

steps. Otherwise, run the script as listed below. ### General coding practices - When adding Go tests, always invoke `t.Parallel()` at the start of each test and subtest to maximize concurrency

halo-devAGENTS.md

halo

halo-dev/halo/AGENTS.md

constraints) | ## Quick Commands Run from the repo root: - `./gradlew build` — full backend build and tests. - `./gradlew spotlessApply` — format Java, Markdown, JSON, and properties. - `./gradlew :application:test` — backend tests. - `pnpm

No other project uses it yet

halo-devAGENTS.md

halo / api

halo-dev/halo/api/AGENTS.md

downstream compatibility. ## Scope - Source: `api/src/main/java/run/halo/app/` (core, extension, plugin, security, migration, theme, and related packages). - Tests: `api/src/test/`. ## Commands - `./gradlew :api:test` — run API library tests. - `./gradlew spotlessApply` — format Java and Markdown

No other project uses it yet

halo-devAGENTS.md

halo / application

halo-dev/halo/application/AGENTS.md

mariadb,mysql,postgresql}/` — per-dialect migrations. - `application/src/main/resources/extensions/` — extension schemas and role templates. - `application/src/test/` — backend tests. ## Commands - `./gradlew :application:test` — run backend tests. - `./gradlew :application:bootRun` — start the backend dev server

halo-devAGENTS.md

halo / ui

halo-dev/halo/ui/AGENTS.md

/components`, `@halo-dev/console-shared`, `@halo-dev/editor`, `@halo-dev/shared`, `@halo-dev/ui-plugin-bundler-kit`). - Unit tests: `*.spec.ts` files, usually under `__tests__/` next to the code they cover. ## Commands Run from

KongAGENTS.md

insomnia

Kong/insomnia/AGENTS.md

oneline -20` not `git log` - `git diff --stat` not `git diff` - `npm test --silent` not `npm test` - `tsc --noEmit 2>&1 | head -50` for type-check failures - Use the `Read

No other project uses it yet

videojsAGENTS.md

video.js

videojs/video.js/AGENTS.md

this file for durable repository rules. Prefer retrieval-led reasoning: inspect the relevant code, tests, package manifest, and nearest `AGENTS.md` before relying on model memory or these summaries. ## Sources

No other project uses it yet

videojsAGENTS.md

video.js / site

videojs/video.js/site/AGENTS.md

This file contains site-specific gotchas. Read `site/README.md`, `site/package.json`, the relevant implementation, and its tests for the current architecture and commands. ## Sources of truth - Commands and versions: `package.json` - Astro/Vite/Markdown configuration

No other project uses it yet

storytoldAGENTS.md

artcraft

storytold/artcraft/AGENTS.md

code, even when someone names a location. 4. **Keep fixes narrow and tested.** Fix what the issue describes, where the bug is. Add a test that fails without

No other project uses it yet