trace-first-starter CLAUDE.md

trace-first-starter CLAUDE.md is an instructions file for Claude Code from saubakirov/trace-first-starter. It costs 801 tokens per session, scanned A, original, MIT.

Instructions for Trace-First Workflow, a structured way to plan, research, hand off, implement, and review coding tasks. It defines the files to read first and slash commands such as /tfw-plan and /tfw-review.

In plain words
What is it for?
Researching a task, writing and freezing its requirements, handing work to an implementer, resuming multi-phase tasks, and reviewing the finished result against the agreed contract.
Why use it?
It gives agents a fixed order for loading project context and separates planning, implementation, and review so task decisions remain traceable.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions Claude Code; mentions AGENTS.md.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/saubakirov/trace-first-starter/claude-md
Clone the repo
git clone --depth 1 https://github.com/saubakirov/trace-first-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 trace-first-starter CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/saubakirov/trace-first-starter/claude-md.svg)](https://agentmods.dev/instructions/saubakirov/trace-first-starter/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/saubakirov/trace-first-starter/claude-md"><img src="https://agentmods.dev/badge/instructions/saubakirov/trace-first-starter/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 801 This file is loaded in full into every session.
When invoked 801 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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.00801 $0.00801
Opus 5 $0.00400 $0.00400
Sonnet 5 $0.00160 $0.00160
Haiku 4.5 $0.00080 $0.00080

Measured 2d ago against content hash 2c77f63c7ee9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

trace-first-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 2d 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 · 55 lines

How it starts

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

TFW — Claude Code Adapter

TFW (Trace-First Workflow)

This project follows Trace-First Workflow. The tool-agnostic core lives in .tfw/. Version: see .tfw/VERSION.

Context Loading (new session, strict order)

  1. AGENTS.md — AI role and mission
  2. .tfw/conventions.md — formal rules, naming, scope budgets
  3. .tfw/glossary.md — terminology
  4. KNOWLEDGE.md (if exists) — architecture, decisions
  5. The selected task's status.md — its live state, and the only authority for it
  6. Relevant HL/TS/RF files for the current task

Slash Commands

Command Workflow Role Purpose
/tfw-plan .tfw/workflows/plan.md Coordinator Research, write HL, freeze the contract, RESEARCH gate, route amendments, write TS
/tfw-research .tfw/workflows/research/base.md Coordinator Structured investigation — pipeline or standalone
/tfw-handoff .tfw/workflows/handoff.md Executor ONB, implement, RF
/tfw-review .tfw/workflows/review.md Reviewer Review RF against checklist, Purpose Check against the contract baseline, write REVIEW
/tfw-resume .tfw/workflows/resume.md Coordinator Status matrix for multi-phase task, decide next phase
/tfw-docs .tfw/workflows/docs.md Coordinator Update KNOWLEDGE.md after REVIEW
/tfw-knowledge .tfw/workflows/knowledge.md Coordinator Consolidate fact candidates into verified project knowledge
/tfw-release .tfw/workflows/release.md Coordinator Version bump, CHANGELOG, tag
/tfw-init .tfw/workflows/init.md Coordinator Initialize TFW in a project — discover, interview, setup
/tfw-update .tfw/workflows/update.md Coordinator Fetch upstream, compare versions, sync adapters
/tfw-config .tfw/workflows/config.md Coordinator Interactive config change, propagate to all inline values

Key References

  • .tfw/README.md — philosophy, thesis, lifecycle
  • .tfw/conventions.md — all formal rules
  • .tfw/templates/ — canonical artifact templates (see tfw.templates in .tfw/project_config.yaml)
  • .tfw/CHANGELOG.md — version history
  • .tfw/project_config.yaml — project parameters (task prefix, build commands)

Read the full file on GitHub · 55 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. 2d ago Changed · -1 lines · -31 tokens per session 2c77f63c7ee9
  2. 6d ago First seen · 56 lines · 832 tokens per session scan A 476ac08c90aa

Subscribe to this mod's changes

trace-first-starter CLAUDE.md is an instructions file published in the GitHub repository saubakirov/trace-first-starter (29 stars, last pushed 3d ago), licensed MIT. It adds 801 tokens to every session, about $0.0040 per session on Opus 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

Other instructions, from other repositories