What is guild AGENTS.md?

Repository instructions for Guild, a plugin that provides planning, coding, review, knowledge-management, and self-improvement workflows for coding agents. They describe its agents, skills, project files, and documentation layout.

Use them when developing Guild skills, agents, plugin manifests, project state, review workflows, or its documentation.

They give agents the structure and workflow rules needed to navigate Guild and keep its shared instructions consistent across different hosts.

guild AGENTS.md — Instructions file by lookatitude

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/lookatitude/guild/agents-md

Clone the repo

git clone --depth 1 https://github.com/lookatitude/guild

Made for: Codex, OpenCode.

Per session 4,819 This file is loaded in full into every session.

When invoked 4,819 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.04819	$0.04819
Opus 5	$0.02410	$0.02410
Sonnet 5	$0.00964	$0.00964
Haiku 4.5	$0.00482	$0.00482

Measured 2d ago against content hash 6bbd92b6b02b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

guild AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 314 lines

How it starts

The opening of the file, as written. The whole thing — 314 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Guild — repo orientation

Guild is a cross-host plugin that ships 3 machinery agents (advisor, context-manager, developer), 15 domain specialist type templates (minted into a project's .guild/agents/ on demand by team composition), and 111 skills across a brainstorm-plan-execute-review-verify-reflect spine, a categorized wiki with decision capture, and a self-evolution loop with shadow-mode gating.

This AGENTS.md file is the canonical host-neutral instruction file. Claude Code loads CLAUDE.md, but CLAUDE.md must only import this file; all durable directions belong here so Codex, Pi, Antigravity, and AGENTS.md-consuming hosts read the same guidance.

For full architecture and design documentation see https://guildstack.dev/docs.

Where things live

.claude-plugin/plugin.json, .claude-plugin/marketplace.json — plugin + marketplace manifests.
skills/{core,meta,knowledge,specialists,guild-operations,guild-quality}/ — skill taxonomy. The former fallback/ tier no longer exists — its skills were promoted into meta/ (tdd, systematic-debug, worktrees, finish-branch) or folded into guild:review.
agents/*.md — the 3 machinery agents (advisor, context-manager, developer), the only host-registered agents the plugin ships. Populated and authored.
templates/specialists/*.md — the 15 domain specialist type templates (guild.specialist_template.v1; architect … sales, incl. doc-writer), read-only feedstock minted into a project's .guild/agents/ by roster-resolve.ts mint during team composition.
commands/*.md — the v2 flat-token command surface (/guild:<verb>; the : plugin namespace stays — Claude Code requires it — v2 only drops the redundant guild- prefix; sub-verbs are positional arguments, never separate files or namespaces).
hooks/hooks.json — native Claude Code hooks; the .ts sources compile to the committed esbuild bundles under hooks/dist/ (+ hooks/agent-team/dist/) the host actually runs (cd hooks && npm run build after any hook edit — source edits are a no-op until rebuilt). Other hosts consume equivalent behavior through host adapters and graceful fallback.
src/modules/<module>/ — the module source-of-truth layer. Each module owns its workflows/ code plus a resources/ mirror that generated host packages copy from; scripts/lib/* are thin re-export shims over these workflows. The module-resource sync (syncModuleResources) + drift gates keep the live surface, the resources/ mirror, and the per-host dist/ copies byte-identical. Edit the live source (scripts/lib, src/modules/*/workflows, hooks/*.ts); never hand-edit a resources/ or dist/ mirror — run the sync + host-package build to propagate.
scripts/, mcp-servers/ — evolve loop, telemetry, optional MCP servers.
dist/ — committed per-host packages (claude-code, codex, pi, …) rendered by scripts/build-host-packages.ts; regenerated, never hand-edited.
tests/ — skill evals and wiki-lint fixtures.
templates/{skills,agents,products}/ — authoring + product scaffolds (templates/specialists/ is the 15 specialist type templates, described above).
docs/ — RETIRED as a docs set: holds only a static redirect page to https://guildstack.dev/docs plus the logo asset. The public docs are generated from the umbrella's docs/v2/ + the website; reference knowledge lives in .guild/wiki/. Apart from README.md, CONTRIBUTING.md, and CHANGELOG.md, no documentation lives in this repo.

Read the full file on GitHub · 314 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 314 lines · 4,819 tokens per session scan A 6bbd92b6b02b

Subscribe to this mod's changes

guild AGENTS.md is an instructions file published in the GitHub repository lookatitude/guild (7 stars, last pushed 2d ago), licensed MIT. It adds 4,819 tokens to every session, about $0.0241 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Building agents Planning

guild AGENTS.md

Getting it into your agent

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

Guild — repo orientation

Where things live

What this file has done since we first saw it

Other instructions, from other repositories

spellbook AGENTS.md

open-supermarkets AGENTS.md

helm copilot-instructions.md

flyto-core CLAUDE.md

fusion-skills AGENTS.md

aeon CLAUDE.md