What is primer CLAUDE.md?

Repository-specific instructions for Claude Code, an AI coding assistant, working on the Primer project. They explain the project, its governing rules, and where its planning documents live.

Use them before changing the repository to understand its learner-record system, local data model, tutor workflow, and required project rules.

They give coding sessions the context and boundaries needed to make changes without losing the project's core design decisions.

How VedSoni-dev/primer configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to VedSoni-dev/primer. 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/VedSoni-dev/primer/master/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/VedSoni-dev/primer

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/vedsoni-dev/primer/claude-md/github.svg)](https://agentmods.dev/instructions/vedsoni-dev/primer/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/vedsoni-dev/primer/claude-md"><img src="https://agentmods.dev/badge/instructions/vedsoni-dev/primer/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/vedsoni-dev/primer/claude-md"><img src="https://agentmods.dev/badge/instructions/vedsoni-dev/primer/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,257 This file is loaded in full into every session.

When invoked 1,257 The same file — it is already loaded in full.

Security scan A 0 findings. 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.

Model	Per session	Once invoked
Fable 5.1	$0.01257	$0.01257
Opus 5.5	$0.00503	$0.00503
Sonnet 5.5	$0.00251	$0.00251
Haiku 4.5	$0.00126	$0.00126

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

Security

Grade A, and why

primer 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 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.

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 · 108 lines

How it starts

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

CLAUDE.md

Context for any Claude Code session working in this repository. Read this file fully before making changes. It states what this project is, the doctrine that governs it, and the rules that no refactor, feature, or pipeline may move.

What this repository is

primer is an open learner record plus an MCP server. One SQLite file per family, on the family's machine, holding everything one child knows, struggles with, cares about, and how they learn. An AI tutor (Claude, via the parent's own Claude Code login) reads the record between sessions, builds a one-off HTML activity, and queues it for parent approval. The child never talks to a model. The record is what lasts.

The project answers Y Combinator's RFS "The Primer" while rejecting its dangerous half: no company should own a decade of a child's most intimate learning data. The open version must exist before proprietary lock-in accretes.

The doctrine

One sentence governs every architectural decision:

The Record knows the child. The World knows the field. The humans know the goal. The tutor is the only place the three are allowed to meet.

The Record is the per-family SQLite file. Mastery, misconceptions, interests, accommodations, affect, evidence. It never leaves the family's machine.
The World is versioned, reviewed, public data shipped with primer releases: curriculum packs, prerequisite edges, pedagogy claims with citations, parameter priors, and interest lenses. It is an artifact, never a service. See docs/WORLD.md.
The goal is human-set intent. The goal table is written by parents and teachers. The interest table is revealed by the child and decays if unreinforced. The tutor reads both. Nothing else sets direction.
The tutor composes all three at planning time, on the family's machine, with no network access.

The composition rule that follows, stated as doctrine and pinned by an invariant test:

The World proposes. The Record and the humans dispose. Nothing in The World may target, rank, or select content for an individual child. Which lens activates, which skill comes next, what the session looks like: those decisions are made by the scheduler and the tutor on the family's machine, as a function of the Record and the human-set goals. The World is a menu. It is never a hand on the child's back.

Read the full file on GitHub · 108 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.

2mo ago First seen · 108 lines · 1,257 tokens per session scan A de29c9b8b454

Subscribe to this mod's changes

primer CLAUDE.md is an instructions file published in the GitHub repository VedSoni-dev/primer (1 stars, last pushed 8d ago), licensed Apache-2.0. It adds 1,257 tokens to every session, about $0.0050 per session on Opus 5.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.

primer CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
primer CLAUDE.mdVedSoni-dev/primer	Instructions file	1	8d ago	Apache-2.0	A	1,257	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	yesterday	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

primer: Instructions file for Claude Code