CLAUDE.mdA

CLAUDE.md from itsomidkarami/kraft is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

Install it, pinned
mdr add itsomidkarami/kraft/CLAUDE.md@git:20261020.5c017a9

Pins git:20261020.5c017a9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
CLAUDE.md file
Repository
itsomidkarami/kraft
Path
CLAUDE.md
Versions recorded
5
Latest version
git:20261020.5c017a9, committed Oct 20, 2026
First version recorded
Oct 16, 2026
Size
16,327 bytes
Repository stars
7
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Project Instructions for AI Agents

## Build & Test

Everything goes through `just` — run `just` for the list.

```bash
just setup      # uv sync + npm ci + superpowers and impeccable for every agent
just test       # backend tests affected by your changes (testmon); --no-testmon for all
just test-ui    # frontend typecheck + unit tests
just test-py 3.12  # the unit tier on another Python (CI runs 3.12, 3.13, 3.14); `requires-python` is the floor
just lint       # ruff check + format check
```

**Never call `pytest` / `uv run pytest` directly.** Always go through `just
test` (add `-k pattern` or a path to target specific tests; use
`--no-testmon` for a full run). Calling pytest raw skips testmon's
change-tracking and burns the full ~14min suite.

**Testing guideline:** see `docs/testing.md`. Two tiers (unmarked unit,
mocked at the adapter seam; `@pytest.mark.e2e("<cli>")` for a real CLI's
contract) and one rule for every pin: mutate the code it covers and confirm
that same test fails, or it isn't proof of anything. `just check-tests`
enforces what can be checked mechanically.

## Running Kraft

Two ways, and neither is `python -m kraft` by hand.

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add itsomidkarami/kraft/CLAUDE.md@sha256:e7bd7e6d054f7b77

The line at the top of this page pins the label git:20261020.5c017a9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_dskmcx56nqmk3h7r.svg)](https://markdownregistry.com/a/art_dskmcx56nqmk3h7r)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 16, 2026 and Oct 20, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261020.5c017a9 latest2026-10-20 5c017a9 16,327 BA view · diff
git:20261020.40d883a2026-10-20 40d883a 16,071 BA view · diff
git:20261017.7783a082026-10-17 7783a08 16,067 BA view · diff
git:20261016.e14dd882026-10-16 e14dd88 15,944 BA view · diff
git:20261016.97a5f642026-10-16 97a5f64 15,902 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (16327 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

itsomidkarami/kraft · 7 stars · license Apache-2.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_dskmcx56nqmk3h7r
GET https://markdownregistry.com/api/v1/resolve?ref=itsomidkarami/kraft/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/e7bd7e6d054f7b77cacf82fa8dd7d5bd30cfb745da4a195d229e13b882b5fd38

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

More from itsomidkarami/kraft

beads SKILL.md skill
itsomidkarami/kraft · .agents/skills/beads/SKILL.md · Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker…
git:20260831.c6f6998 · audit A · 7 stars
AGENTS.md AGENTS.md file
itsomidkarami/kraft · AGENTS.md
git:20261015.522e6e5 · audit A · 7 stars
gate SKILL.md skill
itsomidkarami/kraft · plugins/kraft-lite/skills/gate/SKILL.md · Presents a Kraft Lite gate to the human and records their answer with `approve` or `reject`, sending rejected work back…
git:20261004.8097c6f · audit A · 7 stars
init SKILL.md skill
itsomidkarami/kraft · plugins/kraft-lite/skills/init/SKILL.md · Writes `.kraft-lite/registry.yaml`, which binds each hook of a Kraft Lite chain to an installed skill, an instruction…
git:20261004.8097c6f · audit A · 7 stars
next SKILL.md skill
itsomidkarami/kraft · plugins/kraft-lite/skills/next/SKILL.md · Runs the next node of a Kraft Lite chain from its recorded state and reports the finished run's time and attempts per…
git:20261004.8097c6f · audit A · 7 stars
start SKILL.md skill
itsomidkarami/kraft · plugins/kraft-lite/skills/start/SKILL.md · Creates a new Kraft Lite chain for the work and hands it to the first node. Use when the human asks to begin new work…
git:20261004.8097c6f · audit A · 7 stars
status SKILL.md skill
itsomidkarami/kraft · plugins/kraft-lite/skills/status/SKILL.md · Reports where a Kraft Lite chain has got to (its node, running or blocked at a gate, attempts spent) and, on request…
git:20261004.8097c6f · audit A · 7 stars
board SKILL.md skill
itsomidkarami/kraft · plugins/kraft/skills/board/SKILL.md · Reads what Kraft is doing across work items: the board, and a cross-repo search of specs, plans and session summaries…
git:20261012.d18b384 · audit A · 7 stars
check SKILL.md skill
itsomidkarami/kraft · plugins/kraft/skills/check/SKILL.md · Reports where a repo's Kraft config has drifted from what this Kraft version ships: chains that no longer resolve…
git:20261012.d18b384 · audit A · 7 stars
doctor SKILL.md skill
itsomidkarami/kraft · plugins/kraft/skills/doctor/SKILL.md · Diagnoses an unhealthy Kraft server and applies the reload, restart or update its health check calls for. Use when the…
git:20261012.d18b384 · audit A · 7 stars
gates SKILL.md skill
itsomidkarami/kraft · plugins/kraft/skills/gates/SKILL.md · Approves or rejects the gate a Kraft work item is waiting on, files and submits review threads, and pauses or resumes…
git:20261012.d18b384 · audit A · 7 stars
handoff SKILL.md skill
itsomidkarami/kraft · plugins/kraft/skills/handoff/SKILL.md · Files work with Kraft as a paused work item, with any agreed spec and plan attached. Use when work settled in this…
git:20261012.d18b384 · audit A · 7 stars

Every file in itsomidkarami/kraft

Other files named CLAUDE.md

CLAUDE.md CLAUDE.md file
affaan-m/ecc · CLAUDE.md
git:20260528.04c68e4 · audit A · 284,510 stars
CLAUDE.md CLAUDE.md file
firecrawl/firecrawl · CLAUDE.md
git:20261008.5a75dca · audit A · 193,096 stars
CLAUDE.md CLAUDE.md file
garrytan/gstack · CLAUDE.md
git:20261011.5d64745 · audit A · 136,966 stars
CLAUDE.md CLAUDE.md file
juliusbrussee/caveman · CLAUDE.md
git:20261010.505ac30 · audit B · 113,780 stars
CLAUDE.md CLAUDE.md file
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 109,013 stars
CLAUDE.md CLAUDE.md file
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 102,533 stars
CLAUDE.md CLAUDE.md file
thedotmack/claude-mem · CLAUDE.md
git:20261013.84bbb53 · audit A · 102,153 stars
CLAUDE.md CLAUDE.md file
egonex-ai/understand-anything · CLAUDE.md
git:20260710.6677c67 · audit B · 87,696 stars

Browse by kind, by grade A, or by owner.