agentmods.dev

ClaudeForge CLAUDE.md

ClaudeForge CLAUDE.md is an instructions file for coding agents from alirezarezvani/ClaudeForge. It costs 964 tokens per session, scanned A, original, MIT.

Repository instructions for managing CLAUDE.md files, which give Claude Code guidance about a project. They describe a ClaudeForge toolkit for creating, improving, synchronizing, and splitting those files.

In plain words
What is it for?
Use them when working on ClaudeForge or changing its file-generation, synchronization, validation, commands, and background guardian.
Why use it?
They help keep the guidance accurate, organized, linked across files, and within the stated 150-line limit.

Instructions file

not rated 424 +3 3mo ago A scan 964 tokens original MIT
View the source file alirezarezvani/ClaudeForge
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/alirezarezvani/claudeforge/claude-md
Clone the repo
git clone --depth 1 https://github.com/alirezarezvani/ClaudeForge

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 ClaudeForge CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/alirezarezvani/claudeforge/claude-md.svg)](https://agentmods.dev/instructions/alirezarezvani/claudeforge/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/alirezarezvani/claudeforge/claude-md"><img src="https://agentmods.dev/badge/instructions/alirezarezvani/claudeforge/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 964 This file is loaded in full into every session.
When invoked 964 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.00964 $0.00964
Opus 5 $0.00482 $0.00482
Sonnet 5 $0.00193 $0.00193
Haiku 4.5 $0.00096 $0.00096

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

Security

Grade A, and why

ClaudeForge 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 5d 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 · 71 lines

How it starts

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

CLAUDE.md

Top-level guidance for Claude Code when working on this repository.

Project Overview

ClaudeForge is a Claude Code plugin (manifest at .claude-plugin/plugin.json) and standalone toolkit for the CLAUDE.md lifecycle: initialise, enhance, sync, and modularise files with a hard 150-line cap, automatic chaining via @path imports, and Karpathy behavioural guardrails. Works in any Claude Code or Claude.cowork project.

Five components ship in this repo:

  1. Skill (claudeforge-skill, in skill/) — Python modules for analysis, generation, validation. Enforces the 150-line cap.
  2. Slash command (/enhance-claude-md, in command/) — interactive init/enhance workflow. Delegates deep codebase scans to the Explore subagent.
  3. Slash command (/sync-claude-md, in command/) — walks every CLAUDE.md, prunes stale references, enforces the 150-line cap, repairs the root ↔ sub chain.
  4. Guardian agent (claude-md-guardian, in agent/) — background sync triggered by SessionStart / PreToolUse / PostToolUse hooks.
  5. Karpathy guidelines skill (karpathy-guidelines, in skill/karpathy-guidelines/) — behavioural guardrails embedded into every generated CLAUDE.md. Adapted with attribution from the MIT-licensed forrestchang/andrej-karpathy-skills repo.

Current version: 2.1.0 — see CHANGELOG.md. v1 → v2 upgrade: docs/MIGRATION_V2.md.

Quick Navigation

Chained context (Claude Code auto-imports these):

@skill/CLAUDE.md @command/CLAUDE.md @agent/CLAUDE.md @docs/CLAUDE.md

Behavioral Guidelines

Behavioural guardrails applied to every coding, review, and refactoring task in this repo. Full skill: ~/.claude/skills/karpathy-guidelines/SKILL.md.

  1. Think before coding. State load-bearing assumptions; if a request has multiple reasonable interpretations, surface them instead of picking silently. Stop and ask when something is genuinely unclear.
  2. Simplicity first. Write the minimum code that solves the stated problem. No speculative abstractions, no unrequested configuration, no error handling for conditions that cannot occur.
  3. Surgical changes. Touch only what the task requires. Match surrounding style. Every changed line should trace directly to the user's request.
  4. Goal-driven execution. Convert vague requests into verifiable success criteria before coding (failing test first), and state a step-by-step plan with per-step verification for multi-step work.

Read the full file on GitHub · 71 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. 5d ago First seen · 71 lines · 964 tokens per session scan A 320a12e83ddc

Subscribe to this mod's changes

ClaudeForge CLAUDE.md is an instructions file published in the GitHub repository alirezarezvani/ClaudeForge (424 stars, last pushed 3mo ago), licensed MIT. It adds 964 tokens to every session, about $0.0048 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.

agentic-aiagentic-workflowclaude-codeclaude-skillclaude-subagents
Related

Other instructions, from other repositories

toh-framework CLAUDE.md

Claude Code instructions for wasintoh/toh-framework, covering claude.md — toh framework (repo development guide), what this is, everyday commands, verification protocol and single source, transformed per ide.

wasintoh/toh-framework · 3,979 tokens

agent-rules child-process.instructions.md

Instructions for lirantal/agent-rules, covering system processes secure coding guidelines, your mission and spawning system processes.

lirantal/agent-rules · 196 tokens

claude-code-templates CLAUDE.md

Claude Code instructions for Justdvp/claude-code-templates, covering claude.md, project overview, development commands, package management and application commands.

Justdvp/claude-code-templates · 4,007 tokens

deckforge AGENTS.md

Instructions for tph-kds/deckforge, covering deckforge agent entry point, code intelligence, read order, default routing and non-negotiable implementation rules.

tph-kds/deckforge · 498 tokens

coordinate-agents AGENTS.md

AGENTS.md instructions for hogancv/coordinate-agents, covering repository instructions for ai contributors, canonical identity, repository map, required checks and change rules.

hogancv/coordinate-agents · 1,451 tokens

AmbyKit CLAUDE.md

Instructions for ambystechcom/AmbyKit, covering claude code — notes for the ambykit repo and claude-specific.

ambystechcom/AmbyKit · 257 tokens