takt CLAUDE.md

takt CLAUDE.md is an instructions file for coding agents from nrslib/takt. It costs 3,512 tokens per session, scanned A, original, MIT.

A repository guide for Claude Code, an AI coding assistant, explaining the TAKT project, its commands, tests, and command-line interface. It also explains details such as how the test pool works.

In plain words
What is it for?
Use it when Claude Code builds, tests, reviews, or changes the TAKT multi-agent workflow tool.
Why use it?
It gives the coding assistant project-specific rules and context, reducing mistakes such as misreading test failures or skipping files needed at runtime.

Instructions file

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/nrslib/takt/claude-md
Clone the repo
git clone --depth 1 https://github.com/nrslib/takt

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 takt CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/nrslib/takt/claude-md.svg)](https://agentmods.dev/instructions/nrslib/takt/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/nrslib/takt/claude-md"><img src="https://agentmods.dev/badge/instructions/nrslib/takt/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,512 This file is loaded in full into every session.
When invoked 3,512 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 $0.03512 $0.03512
Opus 5 $0.01756 $0.01756
Sonnet 5 $0.00702 $0.00702
Haiku 4.5 $0.00351 $0.00351

Measured 4d ago against content hash 755ecdcc9911, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

takt 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 4d 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 · 146 lines

How it starts

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

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

This file is not user-facing documentation. It exists for Claude Code to read while working in the repository — it does not substitute for the real docs under docs/ or README.md. Content being recorded here NEVER implies "we don't need to write this up for users." Anything users should see must still be added to README.md / docs/** separately.

Project Overview

TAKT (TAKT Agent Koordination Topology) is a multi-agent orchestration CLI. It runs AI agents through YAML-defined workflows with rule-based routing, parallel review, dynamic task decomposition, and worktree-isolated execution. This repository dogfoods TAKT for its own review and development.

Development Commands

Command Notes
npm run build tsc (+ opencode-probe tsconfig) plus copies of src/shared/prompts/{en,ja}/**/*.md, src/shared/i18n/*.yaml, and src/core/runtime/presets/*.sh into dist/. Skipping any copy breaks runtime resolution.
npm run watch TypeScript incremental build (no asset copy).
npm run lint ESLint on src/. no-explicit-any is error; unused vars must be prefixed _.
npm test Fast unit gate: type-contracts tsc, the test type-check (tsconfig.tests.json), then an adaptive number of unit shards launched concurrently (capped at 8 from availableParallelism() in scripts/run-npm-test.mjs, each shard --maxWorkers=1). Excludes integration tests; the output names the follow-up command.
npm run test:it Light integration gate for real filesystem, bounded storage, and multi-component contracts. Run after implementation.
npm run test:it:heavy Full heavy integration gate for real child processes, Git, complete engines, integration/regression/performance suites, and serial groups. Local execution uses one worker; PR CI shards across isolated runners.
npm test -- src/__tests__/<file>.test.ts Route a single file to the correct unit, light-IT, heavy-parallel-IT, or heavy-serial-IT runner. For an added or changed IT, also run releaseVerificationWiring.test.ts by itself. Always target-run an added or changed heavy IT before handoff.
npm test -- -t "<pattern>" Run unit tests whose name matches <pattern>.
npm run test:opencode-probe Deterministic OpenCode probe smoke gate (11 cases, no API cost). Standalone; not part of routine gates or check:release.
npm run test:e2e:mock Full mock-provider E2E suite (parallel shards). Single spec: TAKT_E2E_PROVIDER=mock npx vitest run --config vitest.config.e2e.mock.ts e2e/specs/<file>.e2e.tswithout that env var the specs run against the real provider (provider: claude in e2e/fixtures/config.e2e.yaml) and cost API credits.
npm run test:e2e:provider:{claude,claude-sdk,codex,opencode,cursor} E2E against a real provider (slow, costs API credits).
npm run check:release Full pre-release gate: build + lint + adaptive local unit + light IT + heavy IT + e2e. The main pull-request CI workflow runs the unit gate separately in 8 isolated shard jobs; local check:release does not run that CI matrix.

Read the full file on GitHub · 146 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. 4d ago First seen · 146 lines · 3,512 tokens per session scan A 755ecdcc9911

Subscribe to this mod's changes

takt CLAUDE.md is an instructions file published in the GitHub repository nrslib/takt (1,328 stars, last pushed 2d ago), licensed MIT. It adds 3,512 tokens to every session, about $0.0176 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