devnotes: Instructions file for Claude Code

CLAUDE.md

devnotes CLAUDE.md is an instructions file for Claude Code from ohnotnow/devnotes. It costs 7,474 tokens per session, scanned B, a copy of devnotes AGENTS.md, MIT.

Project instructions for the ohnotnow/devnotes repository, including how to get oriented and how its web app, command-line tool, and MCP server fit together. An MCP server lets AI tools interact with an application through a standard interface.

In plain words
What is it for?
Use them at the start of work in this repository and when changing its Laravel app, Go command-line tool, API, or MCP server.
Why use it?
They provide the project context needed before making decisions, including where shared notes, authentication, and API behavior fit in.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md.

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

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/jenny/code/test.sh.

Reuse

Borrowing it

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

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

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/ohnotnow/devnotes/claude-md"><img src="https://agentmods.dev/badge/instructions/ohnotnow/devnotes/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 7,474 This file is loaded in full into every session.
When invoked 7,474 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 98% copy Near-identical to another mod 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.07474 $0.07474
Opus 5.5 $0.02990 $0.02990
Sonnet 5.5 $0.01495 $0.01495
Haiku 4.5 $0.00747 $0.00747

Measured 2mo ago against content hash 93dd803ab7b0, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

devnotes 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 2mo 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.

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

Do not try and run any commands or tools that interact with the database. Either lando or artisan or boost. The user will run migrations for you if you ask.
Origin

This is a copy

98% identical to devnotes AGENTS.md — 24 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 533 lines

How it starts

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

devnotes

A scrappy "wiki meets GitHub gists" for our small dev team: tiny markdown notes capturing gotchas and lessons, findable later. One Laravel app; the web UI, a Go CLI (sibling repo ../devnotes-cli), and the MCP server (live, Passport OAuth) are all clients of the same notes data - the first two via /api/v1 + Sanctum tokens. Frictionless capture is the thing to protect; recall matters as much as capture.

Get oriented (do this before deciding anything)

  1. ant foundation - the vision and settled decisions (wiki-style editing IS the product; users are the gate, no allow-list; soft deletes; #id = real Eloquent id).
  2. ant search "handover" - the session handover note has the full state, pending user decisions, and every hard-won gotcha (.env leaks into tests, apiResource route-name theft, soft-delete-vs-FK trap, Flux a11y defaults, permission gates).
  3. ait ready and ait log - what's open and what shipped. The API contract lives in the epic descriptions, including two clarifying notes (everything is data-wrapped; PATCH needs full payloads).
  4. The session-start surfacing design (ait show devnotes-UkLWZ) is deliberately undecided - it's a conversation with the user, never a guess.

House specifics for this repo

  • Local dev: lando at https://devnotes.lndo.site, login admin2x / secret (seeded). lando mfs (migrate:fresh + TestDataSeeder) is fine to run. Tests: php artisan test --compact - in-memory sqlite, no migrations needed; phpunit.xml pins the SSO_* keys because .env leaks into any key it doesn't pin.
  • Models use #[Fillable] attributes (see app/Models/User.php), not $fillable.
  • Any new model whose rows travel through export/import needs a ulid column minted on creation (see Note::booted()) - the ulid is the cross-install identity that keeps re-imports idempotent. Codes/ids do not survive merging two pots; ulids do.
  • Flux UI everywhere; create/edit forms use flux:modal variant="flyout". New screens need: flux:heading level=, autofocus in modals, aria-labels on switches - the a11y bar is real for us (.ac.uk).
  • Commits: agent-commit only (explicit file list, preview then --yes TOKEN, no attribution). The user has permitted its use; never push to GitHub without their say-so.
  • After finishing a piece of PHP work, run ./vendor/bin/phpstan analyse --memory-limit=2G - the repo holds PHPStan level 5 clean, so fix anything it reports before calling the work done.

Read the full file on GitHub · 533 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. 2mo ago First seen · 533 lines · 7,474 tokens per session scan B 93dd803ab7b0

Subscribe to this mod's changes

devnotes CLAUDE.md is an instructions file published in the GitHub repository ohnotnow/devnotes (1 stars, last pushed 22d ago), licensed MIT. It adds 7,474 tokens to every session, about $0.0299 per session on Opus 5.5. A static security scan graded it B with 1 finding (unrestricted tool access). It is 98% identical to devnotes AGENTS.md, differing in 24 lines, and is treated as a copy.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens