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.
npx agentmods add instructions/lucasduys/forge/agents-mdgit clone --depth 1 https://github.com/LucasDuys/forgeWhat 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.01215 | $0.01215 |
| Opus 5 | $0.00607 | $0.00607 |
| Sonnet 5 | $0.00243 | $0.00243 |
| Haiku 4.5 | $0.00121 | $0.00121 |
Grade A, and why
forge 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.
How it starts
The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Forge — Agent Routing
This file tells Claude Code how to route work to the correct specialized agent when working on the Forge project.
Agent Definitions
forge-speccer
When to use: During /forge brainstorm — writing specs from user input, existing code, or docs.
Files it owns: skills/brainstorming/SKILL.md, templates/spec.md
Key behavior: Asks clarifying questions one at a time, proposes approaches, writes R-numbered specs with testable acceptance criteria.
forge-planner
When to use: During /forge plan — decomposing specs into task frontiers.
Files it owns: skills/planning/SKILL.md, templates/plan.md
Key behavior: Reads specs, builds dependency DAGs, groups tasks into parallelizable tiers, estimates tokens per task, tags tasks with repo ownership.
forge-executor
When to use: During /forge execute — implementing individual tasks.
Files it owns: skills/executing/SKILL.md
Key behavior: Reads task from frontier, implements with TDD if available, runs tests, commits atomically. Follows inner loop: implement → test → fix → review → fix → commit.
forge-reviewer
When to use: After task implementation (standard/thorough depth) — code review against spec.
Files it owns: skills/reviewing/SKILL.md, references/review-protocol.md
Key behavior: Reviews actual code (not the report), checks against spec requirements, flags missing pieces and over-engineering. Returns PASS or ISSUES with file:line references.
forge-verifier
When to use: After all tasks in a phase/spec complete — goal-backward verification.
Files it owns: references/backprop-patterns.md
Key behavior: Checks observable truths (not task checkboxes), detects stubs/placeholders, verifies cross-component wiring. Returns PASSED or GAPS_FOUND.
forge-researcher
When to use: Before complex/unfamiliar tasks during /forge execute — research before implementation.
Files it owns: None (produces ephemeral research reports)
Key behavior: Multi-source research: official docs (Context7), codebase conventions, security best practices, knowledge graph queries. Returns structured research reports with source citations.
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 · 93 lines · 1,215 tokens per session scan A a589345b5744
forge AGENTS.md is an instructions file published in the GitHub repository LucasDuys/forge (55 stars, last pushed 1mo ago), licensed MIT. It adds 1,215 tokens to every session, about $0.0061 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-30.
Other instructions, from other repositories
SztuCode CLAUDE.md
Instructions for rojim666/SztuCode, covering claude.md, commands and architecture.
best-of-Agent-Harnesses CLAUDE.md
Claude Code instructions for RyanAlberts/best-of-Agent-Harnesses, covering repo notes for ai coding agents, commit identity (required), branching and pushing (required), verifying contribution credit (required) and how the list is generated.
github-agentic-workflows copilot-instructions.md
Instructions for zircote-plugins/github-agentic-workflows, covering copilot instructions — aw-author plugin, project identity, repository structure, branching strategy and daily pipeline (.github/workflows/daily-intelligence.md).
Warden-AI CLAUDE.md
Claude Code instructions for rynald0cst0ltziam/Warden-AI, covering warden — context governance and verification layer, session start (important — do this first), layer 1: before starting work — context selection, layer 2: during work — tool output pruning and enforcement hooks (automatic).
Warden-AI GEMINI.md
Gemini CLI instructions for rynald0cst0ltziam/Warden-AI, covering warden — context governance and verification layer, session start (important — do this first), layer 1: before starting work — context selection, layer 2: during work — tool output pruning and enforcement hooks (automatic).
building-a-coding-agent-from-scratch-course AGENTS.md
Instructions for decodingai-magazine/building-a-coding-agent-from-scratch-course, covering decode, project structure, tech stack, docs & external services and running commands.