Conductor-Beads: Instructions file for Claude Code

CLAUDE.md

Conductor-Beads CLAUDE.md is an instructions file for Claude Code from NguyenSiTrung/Conductor-Beads. It costs 1,890 tokens per session, scanned A, original, Apache-2.0.

Project instructions for Claude Code describing the Conductor-Beads toolkit, its repository layout, planning approach, TDD workflow, and Beads integration.

In plain words
What is it for?
Use them when Claude Code is working in the Conductor-Beads repository and needs to understand its files, architecture, or development commands.
Why use it?
They give Claude Code the project context and conventions needed to work consistently across Conductor plans, commands, skills, and persistent tasks.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

This is NguyenSiTrung/Conductor-Beads's own configuration. It tells Claude Code how to work on Conductor-Beads 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 Conductor-Beads configures →

Reuse

Borrowing it

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

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 Conductor-Beads CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/nguyensitrung/conductor-beads/claude-md/github.svg)](https://agentmods.dev/instructions/nguyensitrung/conductor-beads/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/nguyensitrung/conductor-beads/claude-md"><img src="https://agentmods.dev/badge/instructions/nguyensitrung/conductor-beads/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 Conductor-Beads CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/nguyensitrung/conductor-beads/claude-md"><img src="https://agentmods.dev/badge/instructions/nguyensitrung/conductor-beads/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,890 This file is loaded in full into every session.
When invoked 1,890 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.01890 $0.01890
Opus 5 $0.00945 $0.00945
Sonnet 5 $0.00378 $0.00378
Haiku 4.5 $0.00189 $0.00189

Measured 7d ago against content hash 2195f7d7e276, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

Conductor-Beads 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 7d 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 · 169 lines

How it starts

The opening of the file, as written. The whole thing — 169 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.

Project Overview

Conductor-Beads is a unified toolkit for Context-Driven Development that combines:

  • Conductor: Spec-first planning, human-readable context, TDD workflow
  • Beads: Dependency-aware task graph, cross-session memory, agent-optimized output

It works with both Gemini CLI (via extension) and Claude Code (via commands and skills).

Architecture

Repository Structure

Conductor-Beads/
├── .claude/
│   ├── commands/           # Claude Code slash commands (16 commands)
│   └── skills/             # Claude Code skills
│       ├── conductor/      # Context-driven development skill
│       ├── beads/          # Persistent task memory skill
│       └── skill-creator/  # Skill creation guide
├── commands/conductor/     # Gemini CLI TOML commands (16 commands)
├── templates/              # Workflow and styleguide templates
├── docs/                   # Documentation
├── CLAUDE.md               # This file
├── GEMINI.md               # Gemini CLI context
└── gemini-extension.json   # Gemini extension manifest

Commands

Gemini CLI Claude Code Purpose
/conductor:setup /conductor-setup Initialize project with context files and first track
/conductor:newTrack /conductor-newtrack Create feature/bug track with spec and plan
/conductor:implement /conductor-implement Execute tasks from track's plan (TDD workflow)
/conductor:status /conductor-status Display progress overview
/conductor:revert /conductor-revert Git-aware revert of tracks, phases, or tasks
/conductor:validate /conductor-validate Validate project integrity and fix issues
/conductor:block /conductor-block Mark task as blocked with reason
/conductor:skip /conductor-skip Skip current task with justification
/conductor:revise /conductor-revise Update spec/plan when implementation reveals issues
/conductor:archive /conductor-archive Archive completed tracks
/conductor:export /conductor-export Generate project summary export
/conductor:handoff /conductor-handoff Create context handoff for section transfer
/conductor:refresh /conductor-refresh Sync context docs with current codebase state
/conductor:formula /conductor-formula List and manage track templates (Beads formulas)
/conductor:wisp /conductor-wisp Create ephemeral exploration track (no audit trail)
/conductor:distill /conductor-distill Extract reusable template from completed track

Read the full file on GitHub · 169 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. 7d ago First seen · 169 lines · 1,890 tokens per session scan A 2195f7d7e276

Subscribe to this mod's changes

Conductor-Beads CLAUDE.md is an instructions file published in the GitHub repository NguyenSiTrung/Conductor-Beads (24 stars, last pushed 6mo ago), licensed Apache-2.0. It adds 1,890 tokens to every session, about $0.0095 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-09-03.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens