crow: Instructions file for Claude Code

CLAUDE.md

crow CLAUDE.md is an instructions file for Claude Code from kh0pper/crow. It costs 3,483 tokens per session, scanned B, original, MIT.

Repository instructions for working with Crow, including rules for commits, rebasing before pushes, tests, server startup, and maintaining instruction files. A repository is the project’s tracked source and configuration files.

In plain words
What is it for?
Use them when changing Crow, committing files, pushing branches, running the test suite, starting servers, or updating CLAUDE.md and crow.md.
Why use it?
They give coding agents the project-specific rules needed to avoid sweeping in unrelated work and to run the expected checks correctly.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md.

This is kh0pper/crow's own configuration. It tells Claude Code how to work on crow 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 crow configures →

Reuse

Borrowing it

Nothing to install: this file belongs to kh0pper/crow. 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/kh0pper/crow/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/kh0pper/crow

Made for: Claude Code.

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/kh0pper/crow/claude-md/github.svg)](https://agentmods.dev/instructions/kh0pper/crow/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/kh0pper/crow/claude-md"><img src="https://agentmods.dev/badge/instructions/kh0pper/crow/claude-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 crow CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/kh0pper/crow/claude-md"><img src="https://agentmods.dev/badge/instructions/kh0pper/crow/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 3,483 This file is loaded in full into every session.
When invoked 3,483 The same file — it is already loaded in full.
Security scan B 1 finding. 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.03483 $0.03483
Opus 5.5 $0.01393 $0.01393
Sonnet 5.5 $0.00697 $0.00697
Haiku 4.5 $0.00348 $0.00348

Measured yesterday against content hash 68755c331451, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

crow CLAUDE.md scanned grade B 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 yesterday.

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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- The guard is `scripts/check-public-hygiene.mjs` (CI `static-checks` + `tests/public-hygiene.test.js`). It refuses process-doc paths (`docs/superpowers/`, `.superpowers/`, `handoffs/`, `*handoff*` docs, `.claude/`), lit
CLAUDE.md · 79 lines

How it starts

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

CLAUDE.md

Index for working on this repo. Load-bearing rules inline; deep reference is in docs/.

Working with this repo

  • Always commit with a positional path arg: git commit <path> -m "...", not git add <path> && git commit -m "...". Parallel Claude sessions modify the working tree concurrently; git add then a bare git commit will sweep in unrelated WIP. Verify with git show --stat HEAD after every commit. (See ~/.claude/CLAUDE.md Learnings 2026-04-14.)
  • Always git pull --rebase before pushing a branch — parallel sessions commonly push to main between your fetch and your push.
  • Tests (Node 24 — the one declared version: CI, engines, installer and prod units; tests/node-standard.test.js keeps them in step): npm test runs the FULL suite in a scratch env (safe on any box — it can never touch the real ~/.crow; see scripts/run-suite.mjs). Node built-in test runner, no third-party framework. Single file: npm test -- tests/<file>.test.js (or raw node --test tests/<file>.test.js — but NOT from a systemd-launched shell without the scratch env). Also verify a server starts cleanly: node servers/<name>/index.js (ctrl-C to exit) or node servers/gateway/index.js --no-auth for the gateway.
  • CI red blocks ALL merges — including the operator's (decision Q6, 2026-07-18). The Tests workflow (.github/workflows/test.yml) runs the full suite + check-ports + build-registry --check + npm audit (critical/prod tier) on every PR and push to main, with no path filters — every commit gets check-runs now; an empty check-runs result on a current sha means something is WRONG, not normal. Query https://api.github.com/repos/<owner>/<repo>/commits/<sha>/check-runs (public, no auth) and confirm every run is completed/success before merging (the legacy commit-status API omits Actions and can read green when a check is red). Job keys suite/static-checks/audit are branch-protection contexts — never add a name: to those jobs or rename a key without updating protection. CI green does NOT cover schema migrations — SCHEMA_GENERATION bumps still require the manual migration rail (scripts/schema-migration-dryrun.sh). Notably any new bundle host port must be added to docs/developers/port-allocation.md or check-ports (scripts/check-port-allocation.js) fails. (See ~/.claude/CLAUDE.md Learnings 2026-06-28.)

Read the full file on GitHub · 79 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. yesterday Changed · +3 lines · +437 tokens per session 68755c331451
  2. 2d ago Changed · +148 tokens per session e8251280f684
  3. 8d ago Changed · +2 lines · +229 tokens per session 7b3b3951453a
  4. 1mo ago Changed · +9 lines · +401 tokens per session scan A → B 55923c62df15
  5. 1mo ago Changed · +32 tokens per session b86f91726f81
  6. 2mo ago Changed · +2 lines · +146 tokens per session 16277aa29e23
  7. 2mo ago First seen · 63 lines · 2,090 tokens per session scan A 416ce7fbfa45

Subscribe to this mod's changes

crow CLAUDE.md is an instructions file published in the GitHub repository kh0pper/crow (26 stars, last pushed yesterday), licensed MIT. It adds 3,483 tokens to every session, about $0.0139 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

crow CLAUDE.md compared with instructions from other repositories

crow CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
crow CLAUDE.mdkh0pper/crowInstructions file26yesterdayMITB3,483Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,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