forge CLAUDE.md

Repository instructions for Forge, an open-source control system for managing projects and running an AI-agent pipeline. They describe its backend, web interface, shared types, Rust runner, database, WebSocket connection, and MCP server.

In plain words
What is it for?
Navigating the Forge workspace, choosing the correct package for a change, understanding data and agent-pipeline connections, and following the project's documented commands and rules.
Why use it?
They tell coding agents where the main parts of the system live and which project principles guide changes. This reduces guesswork when working across the backend, web app, runner, and shared contracts.

Instructions file

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/sidcorp-co/forge/claude-md
Clone the repo
git clone --depth 1 https://github.com/SidCorp-co/forge
Per session 2,344 This file is loaded in full into every session.
When invoked 2,344 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.

ModelPer sessionOnce invoked
Fable 5 $0.02344 $0.02344
Opus 5 $0.01172 $0.01172
Sonnet 5 $0.00469 $0.00469
Haiku 4.5 $0.00234 $0.00234

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

Security

Grade A, and why

forge CLAUDE.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.

CLAUDE.md · 147 lines

How it starts

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

@.forge/orientation.md

Forge

Open-source control plane for Claude Code — full-stack project management + an AI agent pipeline that drives Claude end-to-end.

Constitution: docs/VISION.md — what Forge is / is not, why, who, and the principles (incl. VISION: state-never-lies, VISION: kernel-hard-policy-soft). Intent only: no architecture, no versions, no roadmap. On intent conflicts, VISION wins — cite it by name, never by section number.

Workspace

Package What
packages/core Hono backend. Single app (src/index.ts) mounting per-domain route modules (src/<domain>/routes.ts); Drizzle ORM over Postgres (pgvector); WebSocket server (/ws); MCP server (/mcp, tools in src/mcp/tools/forge-*.ts); the pipeline dispatcher that drives Claude.
packages/web-v2 Next.js cloud UI, canonical at /. Feature modules under src/features/<domain>/.
packages/runner Headless Rust forge-runner CLI daemon (crates forge-runner / forge-runner-core) for servers/CI; pairs as a device.
packages/contracts Shared cross-app TS types & registries (issues.ts, pipeline-registry.ts, requests.ts, responses.ts, rows.ts, domain-templates.ts).
packages/observability Shared telemetry helpers (incl. the secret scrubber).

Commands

pnpm verify when you finish coding, before you push — the conformance entrypoint. It runs every check CI runs, reports all of them in one pass instead of stopping at the first, and prints the cm:guard / cm:edge / cm:flow declared on the files you touched. Exit 0 clean · 1 violations · 2 a check could not run. Hooks only make it arrive sooner; a contributor with no plugin installed is held to exactly the same bar.

From the repo root, turbo fans out: pnpm dev / pnpm build / pnpm test / pnpm typecheck / pnpm lint. Per package (from inside packages/<pkg>/):

Package Dev Build Test Lint
core pnpm dev (tsx watch) pnpm build (tsc) pnpm test (vitest); pnpm test:integration pnpm lint (biome)
web-v2 pnpm dev (next, :3100) pnpm build pnpm test (vitest) pnpm lint (check-lint-budget, not biome directly)
runner cargo build (in packages/runner) cargo test

Read the full file on GitHub · 147 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 · 147 lines · 2,344 tokens per session scan A 2e0a249495c2

Subscribe to this mod's changes

forge CLAUDE.md is an instructions file published in the GitHub repository SidCorp-co/forge (5 stars, last pushed 3d ago), licensed Apache-2.0. It adds 2,344 tokens to every session, about $0.0117 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.