agentmods.dev

plain-forge AGENTS.md

Repository instructions for plain-forge, an npm package that installs instructions teaching AI coding agents to create and maintain plain specification files. Its installer copies these files into an agent directory; another tool turns the specifications into code.

In plain words
What is it for?
It helps developers install, update, or remove plain-forge, run its Node.js tests, and edit the skills and rules under the forge directory.
Why use it?
It explains which parts of the repository contain the installer and which contain the instructional content, reducing confusion when making changes or running tests.

Instructions file for CodexOpenCode

55 4d ago A scan 2,193 tokens original MIT
View the source file plainlang/plain-forge
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/plainlang/plain-forge/agents-md
Clone the repo
git clone --depth 1 https://github.com/plainlang/plain-forge

Made for: Codex, OpenCode.

Per session 2,193 This file is loaded in full into every session.
When invoked 2,193 The same file — it is already loaded in full.
Security scan A 1 finding. 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.

ModelPer sessionOnce invoked
Fable 5 $0.02193 $0.02193
Opus 5 $0.01097 $0.01097
Sonnet 5 $0.00439 $0.00439
Haiku 4.5 $0.00219 $0.00219

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

Security

Grade A, and why

plain-forge AGENTS.md scanned grade A with 1 finding 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.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

- `test/cli.test.mjs` mixes unit tests (importing named exports from `bin/cli.mjs`) with black-box integration tests that `spawnSync` the real CLI into isolated temp `HOME`/cwd dirs.
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 82 lines

How it starts

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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this repo is

plain-forge is an npm package with two distinct halves:

  1. A tiny installer CLI (bin/cli.mjs) — npx plain-forge install|update|uninstall.
  2. The actual product under forge/ — a library of AI-agent skills and rules that teach an agent to author and maintain ***plain specification files. The CLI copies forge/ verbatim into an agent directory; there is no build step and no generated/committed output.

So a change here is almost always one of: (a) editing the installer CLI, or (b) editing the instructional content under forge/skills/ and forge/rules/. These need different mindsets — see "Editing forge/ content" below.

plain-forge only authors .plain specs. Rendering specs into code is done by a separate tool, the codeplain CLI (codeplain.ai), which this repo does not contain.

Commands

npm test                                                   # full suite: node --test test/*.test.mjs
node --test --test-name-pattern="<regex>" test/*.test.mjs  # run a single test by name
node --test test/cli.test.mjs                              # run a single test file
  • Test runner is Node's built-in node:test (node:assert/strict) — not jest/vitest, no test framework dependency. Requires Node ≥18.
  • test/cli.test.mjs mixes unit tests (importing named exports from bin/cli.mjs) with black-box integration tests that spawnSync the real CLI into isolated temp HOME/cwd dirs.
  • Releases are cut by publishing a GitHub Release tagged vX.Y.Z, which publishes to npm via OIDC — see RELEASING.md. The version lives in the tag, so package.json on main is intentionally stale.
  • There is no working build or lint step. package.json declares build/clean scripts (tsx bin/forge-build.ts) and tsconfig.json references bin/**/*.ts + runtimes/**/*.ts, but those files do not exist — npm run build/npm run clean error out. The TS toolchain (tsx/typescript) is vestigial; the CLI is plain .mjs run directly by Node. Don't try to build.

Read the full file on GitHub · 82 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. 2d ago First seen · 82 lines · 2,193 tokens per session scan A a33dbbe706f5

Subscribe to this mod's changes

plain-forge AGENTS.md is an instructions file published in the GitHub repository plainlang/plain-forge (55 stars, last pushed 4d ago), licensed MIT. It adds 2,193 tokens to every session, about $0.0110 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Learning and teachingTestingWriting and docs
Related

Other instructions, from other repositories

n8n-skills CLAUDE.md

Instructions for czlonkowski/n8n-skills, covering claude.md, project overview, repository structure, the 14 skills and 1. n8n expression syntax.

czlonkowski/n8n-skills · 2,609 tokens

Tutorial_AwesomeModernCPP AGENTS.md

Instructions for Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP, covering agents.md, 这是什么, 通用 essentials(所有 agent 必读) and 你来做什么?(按场景路由).

Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP · 778 tokens

python-cheatsheet copilot-instructions.md

Copilot instructions for labex-labs/python-cheatsheet, covering python cheatsheet - ai coding assistant instructions, project overview, architecture & key patterns, content structure and routing & layout system.

labex-labs/python-cheatsheet · 1,155 tokens

fix-quera AGENTS.md

Instructions for AlirezaKeshavarz83/fix-quera, covering agent guidance, project shape, visual style, quera page data findings and compatibility findings.

AlirezaKeshavarz83/fix-quera · 1,338 tokens

ab900 CLAUDE.md

Instructions for timothywarner-org/ab900, covering claude.md, repository purpose, architecture, commands and 2. non-ascii punctuation -- must return zero.

timothywarner-org/ab900 · 7,662 tokens

agentconfig.org AGENTS.md

Instructions for agentconfig/agentconfig.org, covering agent instructions for agentconfig.org, project overview, target audience, site structure and tech stack.

agentconfig/agentconfig.org · 2,368 tokens