agents-shipgate: Instructions file for Claude Code

AGENTS.md

agents-shipgate AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from ThreeMoonsLab/agents-shipgate. It costs 19,112 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for Agents Shipgate, a local static checker that examines AI-agent capability changes and reports deterministic findings before they are merged.

In plain words
What is it for?
Use them when working with Shipgate configuration or checking MCP, OpenAPI, agent-framework, Codex, plugin, marketplace, workflow, and related tool definitions.
Why use it?
They explain the supported input formats and project rules so changes can be checked consistently without running agents, making tool calls, using language models, or accessing the network.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: PreToolUse hook event, but also the file is AGENTS.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

This is ThreeMoonsLab/agents-shipgate's own configuration. It tells Claude Code, Codex and OpenCode how to work on agents-shipgate itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agents-shipgate configures →

Reuse

Borrowing it

Nothing to install: this file belongs to ThreeMoonsLab/agents-shipgate. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/ThreeMoonsLab/agents-shipgate/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/ThreeMoonsLab/agents-shipgate

Made for: Claude Code, Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agents-shipgate AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/threemoonslab/agents-shipgate/agents-md/github.svg)](https://agentmods.dev/instructions/threemoonslab/agents-shipgate/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/threemoonslab/agents-shipgate/agents-md"><img src="https://agentmods.dev/badge/instructions/threemoonslab/agents-shipgate/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agents-shipgate AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/threemoonslab/agents-shipgate/agents-md"><img src="https://agentmods.dev/badge/instructions/threemoonslab/agents-shipgate/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19,112 This file is loaded in full into every session.
When invoked 19,112 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.

ModelPer sessionOnce invoked
Fable 5.1 $0.19112 $0.19112
Opus 5.5 $0.07645 $0.07645
Sonnet 5.5 $0.03822 $0.03822
Haiku 4.5 $0.01911 $0.01911

Measured 23d ago against content hash c924e046a29d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agents-shipgate 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 23d 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 · 1,009 lines

How it starts

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

Agents Shipgate · Agent Instructions

Authoritative instructions for AI coding agents (Claude Code, Codex, Cursor, Aider, Cline, Windsurf, Devin, or any other harness — see docs/agents/any-coding-agent.md) working with this repository or a project that uses Agents Shipgate.

If you are a human, the README and the wiki are the right places to start. This file is optimized for agent ingest: short, copy-pasteable, machine-friendly.


What this project is

The deterministic merge gate for AI-generated agent capability changes. Reads shipgate.yaml plus tool sources (MCP exports, MCP server source (TypeScript/Go registration idioms), OpenAPI specs, OpenAI Agents SDK Python files, Anthropic Messages API tool/prompt artifacts, Google ADK Python/config files, LangChain/LangGraph Python files, CrewAI Python files, OpenAI API artifacts, Codex repo config, Codex plugin packages and marketplaces, n8n workflow JSON/stubs, Conductor OSS workflow JSON) and produces deterministic findings. Local-first and static by default — no agent execution, tool calls, LLM calls, or network access.

  • Host-configuration review: agents-shipgate diff shows what a change does to declared coding-agent configuration — .claude/settings.json, .mcp.json, hooks, Codex, Cursor and VS Code MCP config, GitHub workflow permissions — with no shipgate.yaml, saved baseline or skill. It compares against the base already in Git history, names recognized sources it could not read, and implies no verdict. A no-change answer covers only what both sides read. It names a changed input a bounded candidate list recognises but no reader reads — a plugin's mcp.json, .cursor/hooks.json, a nested .claude/settings.json, an external marketplace source — as added, removed or changed, not read by this entry, and says nothing about the other surfaces diff does not read, such as hook scripts, composite actions and subagent hooks; see Run (canonical) and docs/host-boundary-support.md for what it reads.
  • Inputs: MCP · MCP server source · OpenAPI · OpenAI Agents SDK · Anthropic Messages API · Google ADK · LangChain/LangGraph · CrewAI · OpenAI API · Codex config · Codex plugin · n8n · Conductor OSS workflow JSON
  • Outputs: Markdown · JSON · SARIF
  • Trust: Static-by-default. No agent execution, tool calls, LLM calls, or network access.
  • Marketing site: threemoonslab.com — human-readable companion pages. If you are an agent working inside this repo, use the in-tree .well-known/agents-shipgate.json (current main contract, may be ahead of the site's released copy) for schema-version and gating-signal decisions.

Read the full file on GitHub · 1,009 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.

  1. 23d ago Changed · +2 tokens per session c924e046a29d
  2. 1mo ago Changed · +4 lines · +69 tokens per session 1e37d5cb1d35
  3. 1mo ago Changed · +61 tokens per session 8aa93de811cb
  4. 1mo ago Changed · +2 lines · +323 tokens per session cc9a33dc5e1f
  5. 1mo ago Changed 5a05b0009dc8
  6. 1mo ago Changed · +5 lines · +219 tokens per session c07f80a53fce
  7. 1mo ago Changed · +27 lines · +452 tokens per session a27da2435dc2
  8. 1mo ago Changed · +19 lines · +228 tokens per session 1f2a13ac35fc
  9. 1mo ago Changed · +12 lines · +171 tokens per session 66d844b47ac8
  10. 1mo ago First seen · 940 lines · 17,587 tokens per session scan A 59f49cef1600

Subscribe to this mod's changes

agents-shipgate AGENTS.md is an instructions file published in the GitHub repository ThreeMoonsLab/agents-shipgate (87 stars, last pushed today), licensed Apache-2.0. It adds 19,112 tokens to every session, about $0.0764 per session on Opus 5.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.

Related

agents-shipgate AGENTS.md compared with instructions from other repositories

agents-shipgate AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
agents-shipgate AGENTS.mdThreeMoonsLab/agents-shipgateInstructions file87todayApache-2.0A19,112Claude Code, Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode