Honed Claude banner
itsnex1s itsnex1s

Honed Claude

Documentation community

Description

Measured, opinionated CLAUDE.md ruleset for Claude Code. No plugins, no frameworks — one markdown file + benchmarks + research.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

honed-claude

**A measured, opinionated `CLAUDE.md` for Claude Code — no plugins, no frameworks.**

*Refined against 30 days / 30,140 assistant messages of empirical adherence data.*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Claude Code](https://img.shields.io/badge/Claude%20Code-compatible-blueviolet)](https://code.claude.com) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome%20(with%20data)-brightgreen)](#contributing) [![Tokens saved](https://img.shields.io/badge/tokens%20saved-50%25%20per%20session-orange)](benchmarks/measurements.md)

[Install](#install) · [Why](#why) · [Measured Impact](#measured-impact) · [Philosophy](docs/philosophy.md) · [Benchmarks](benchmarks/) · [Research](research/ecosystem-2026.md) · [Token economics](research/token-economics-2026.md)


TL;DR

Anthropic's official guidance: *"if your `CLAUDE.md` is too long, Claude ignores half of it."* This repo is what remains after 30 days of measuring which rules actually change agent behaviour — and cutting the ones that don't.

**One file. 617 tokens per session. Every rule justified by measurement.**

cp CLAUDE.md ~/.claude/CLAUDE.md

That's the whole install.


Table of Contents


Why

Every plugin you install becomes a dependency you don't control. Every rule you copy from a tutorial is untested against *your* actual agent behaviour.

`honed-claude` is a **single-file, measurement-driven** alternative:

  • Empirical. Every rule survives an adherence audit against real transcript history.
  • Minimal. 617 tokens per session — half of what a bloated rulese