Yet-another-agent-harness agent-rules

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

install

source · Clone the upstream repo

git clone https://github.com/dirien/yet-another-agent-harness

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/dirien/yet-another-agent-harness "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/agent-rules" ~/.claude/skills/dirien-yet-another-agent-harness-agent-rules && rm -rf "$T"

manifest: .claude/skills/agent-rules/SKILL.md

source content

AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the agents.md convention. AGENTS.md is FOR AGENTS, not humans.

When to Use

Creating or updating AGENTS.md for new/existing projects
Standardizing agent documentation across repositories
Checking if AGENTS.md files are current with recent code changes
Onboarding AI agents to an unfamiliar codebase

Scripts

Script	Purpose
`scripts/generate-agents.sh PATH`	Generate AGENTS.md files
`scripts/validate-structure.sh PATH`	Validate structure compliance
`scripts/check-freshness.sh PATH`	Check if files are outdated
`scripts/verify-content.sh PATH`	Verify documented files/commands match codebase
`scripts/verify-commands.sh PATH`	Verify documented commands execute
`scripts/detect-project.sh PATH`	Detect language, version, build tools
`scripts/detect-scopes.sh PATH`	Identify directories needing scoped files
`scripts/extract-commands.sh PATH`	Extract commands from build configs
`scripts/extract-ci-rules.sh PATH`	Extract CI quality gates and version matrix
`scripts/extract-architecture-rules.sh PATH`	Extract module boundaries
`scripts/extract-adrs.sh PATH`	Extract architectural decision records
`scripts/extract-github-rulesets.sh PATH`	Extract GitHub rulesets and merge rules

See

references/scripts-guide.md

for full options.

Workflow

Detect:
```
detect-project.sh
```
+
```
detect-scopes.sh
```
to identify stacks and subsystems
Extract:
```
extract-commands.sh
```
,
```
extract-ci-rules.sh
```
, etc. to gather facts
Generate:
```
generate-agents.sh
```
with
```
--style=thin
```
(default) or
```
--verbose
```
Verify:
```
verify-content.sh
```
+
```
verify-commands.sh
```
-- MANDATORY before done

Use

--update

to preserve human-curated content outside

<!-- GENERATED -->

markers.

Core Principles

Structured over Prose -- tables parse faster than paragraphs
Never Fabricate -- only document what exists; verify every command and path
Pointer Principle -- point to files, don't duplicate content
Auto Symlinks -- CLAUDE.md/GEMINI.md symlinks by default (see
```
ai-tool-compatibility.md
```
)

References

File	Contents
`verification-guide.md`	Verification steps, design principles
`scripts-guide.md`	Script options, validation checklist
`ai-tool-compatibility.md`	16-agent compatibility matrix
`output-structure.md`	Root/scoped sections
`git-hooks-setup.md`	Hook framework detection and setup
`examples/`	Complete examples

Templates

Root:

assets/root-thin.md

(default),

root-verbose.md

. Scoped:

assets/scoped/

backend-go.md

backend-php.md

python-modern.md

typo3.md

symfony.md

skill-repo.md

cli.md

frontend-typescript.md

oro.md

Supported Projects

Go, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), Skill repos, Hybrid (multi-stack with auto-scoping).