Harness-Starter: Instructions file for Claude Code

CLAUDE.md

Harness-Starter CLAUDE.md is an instructions file for Claude Code from chenklein26-maker/Harness-Starter. It costs 1,273 tokens per session, scanned A, original, MIT.

A project instruction file for Harness Starter, a workflow template for starting and managing a software project. It defines project context, coding principles, review expectations, and rules for separating discussion from implementation.

In plain words
What is it for?
Use it to initialize a project, inspect its architecture, remove unnecessary parts, check its directory structure, plan verifiable tasks, and guide later code changes.
Why use it?
It gives the coding agent consistent project-specific guidance before work begins. It also encourages small, focused changes and requires assumptions and technical choices to be made explicit.

Instructions file for Claude Code

Written for Claude Code: SessionStart hook event. Also seen: reads .claude/ paths; mentions CLAUDE.md.

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

Reuse

Borrowing it

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

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 Harness-Starter CLAUDE.md

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

Your own site · 80×15
<a href="https://agentmods.dev/instructions/chenklein26-maker/harness-starter/claude-md"><img src="https://agentmods.dev/badge/instructions/chenklein26-maker/harness-starter/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,273 This file is loaded in full into every session.
When invoked 1,273 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.01273 $0.01273
Opus 5.5 $0.00509 $0.00509
Sonnet 5.5 $0.00255 $0.00255
Haiku 4.5 $0.00127 $0.00127

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

Security

Grade A, and why

Harness-Starter 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 · 92 lines

How it starts

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

项目概要

🚀 首次使用请说 开始 或 初始化 — AI 会自动走完 harness-start 四步流程(初始化 → 看架构 → 删多余 → 目录体检)

用途:【待填写:项目用途】 技术栈:【待填写:例如 Next.js 15 + tRPC + PostgreSQL + Codegraph】 跑测试:【待填写:例如 pnpm test】

行为准则(Karpathy 原则)

Think Before Coding

  • 假设必须说清楚,不确定就问
  • 有多个方案时列出,不要默默选一个
  • 有更简单的方法就说出来

消除信息差

  • 追问:用户描述有歧义或缺失关键信息时,先追问再动手
  • 质疑:即使指令看似完整,也多想一步——有没有逻辑漏洞?有没有被忽略的前提?
  • 质疑要带证据:说出你观察到的问题 + 给出替代方案
  • 用户说"就这样做"不意味着就是对的——双方可能存在你看不到的盲区
  • 技术方案审查规则:用户指定"用 X 做 Y"的技术实现方案时,AI 必须先调用 tech-review 审查该方案在当前行业是否仍是最佳实践

讨论与执行分离

  • 讨论阶段只分析、提问、列方案,不修改文件
  • 不要自己判断"讨论已经够了"——问出口才算数
  • 用户明确同意执行后才动手,一次只做一件事

Simplicity First — 动手前先爬 6 级梯子

动手前逐级检查,停在第 1 级能通过的台阶:

# 原则 做法
1 YAGNI 这东西真的需要存在吗?不需要就跳过
2 标准库 JavaScript/Python/Rust 标准库能搞定?用它
3 平台原生 浏览器/Node/OS 自带能力能满足?用 native
4 已有依赖 项目已经装的依赖能解决?复用,不新增
5 一行 能一行写完?写一行
6 最少 以上都不行 → 写最少代码,不加抽象和配置

保留的安全区:边界校验、数据防丢、安全防护、无障碍 —— 这些不能"偷懒"。

Surgical Changes

  • 只动必须动的代码,不顺手"改善"无关代码
  • 不重构没坏的东西
  • 每行改动的代码都应能追溯到用户请求

Goal-Driven Execution

  • 每个任务转成可验证的目标
  • 多步骤任务先列计划再动手

目标定义规则(硬性)

执行多步骤任务前,完成条件必须满足:

  1. 可被机器验证 — 能用自动化命令验证,不依赖主观判断
  2. 含边界条件 — 明确什么能做、什么不能做
  3. 有失败降级方案 — 设置停止条件,防止无限重试(3 轮未通过 → 停止并汇报)
  4. 目标分层 — 区分长期目标和本轮目标

详细示例 → GitHub 仓库 .claude/references/goal-definition-guide.md

全局约定

  • 规则放 CLAUDE.md,工作流放 Skills
  • 涉及文件操作先问用户意图
  • 每次对话只给 AI 看需要的内容,避免无关上下文稀释注意力
  • 架构决策:如果项目中存在 openspec/ 目录,涉及架构变更时必须先走 OpenSpec propose。未安装则先口头讨论方案再动手

自动审查闭环

  • SessionStart → 注入 git 状态 + 当前进度
  • PreToolUse → 拦截 .env 写入、危险操作
  • Stop → 生成审查报告至 .claude/reviews/(按日期累积)

L3 进阶:启用 PostToolUse(自动格式化)和 PreCompact(长会话保护)可形成完整闭环。详见 GitHub 仓库 README。

进阶特性(按需启用)

本模板默认安装 L2 核心。以下高级功能留在 GitHub 仓库中,到达对应成熟度后手动复制:

级别 功能 安装方式
L3 自动格式化 (PostToolUse) 复制 .claude/hooks/post-tool-check.mjs + 注册到 settings.json
L3 长会话保护 (PreCompact) 复制 .claude/hooks/pre-compact.mjs + 注册到 settings.json
L4 GC 自治扫描 复制 scripts/gc-scan.mjs + .claude/skills/harness-gc/
L4 技术方案审查 复制 .claude/skills/tech-review/
L4 目标验证 复制 .claude/skills/verify-goal/
L5 循环工程 详见仓库 .claude/references/loop-templates.md

Read the full file on GitHub · 92 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 · 92 lines · 1,273 tokens per session scan A 7d787cf61cb6

Subscribe to this mod's changes

Harness-Starter CLAUDE.md is an instructions file published in the GitHub repository chenklein26-maker/Harness-Starter (119 stars, last pushed 4mo ago), licensed MIT. It adds 1,273 tokens to every session, about $0.0051 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-30.

Related

Harness-Starter CLAUDE.md compared with instructions from other repositories

Harness-Starter CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
Harness-Starter CLAUDE.mdchenklein26-maker/Harness-StarterInstructions file1194mo agoMITA1,273Claude 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