Beads — Deliberately Short Entry Point
A model of restraint: the file opens by stating it is intentionally short, links the canonical AGENTS.md / instructions / architecture…
- Type
- CLAUDE.md Example
- Repository
- gastownhall/beads
- GitHub stars
- 27.5k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- CLAUDE.md
What Beads — Deliberately Short Entry Point is
Beads — Deliberately Short Entry Point is a claude.md example published in the gastownhall/beads repository on GitHub, which has about 27.5k stars. The repository describes itself as: “Beads - A memory upgrade for your coding agent”
A CLAUDE.md file holds standing instructions that Claude Code reads at the start of every session in a project, such as conventions, commands, and rules. Examples like Beads — Deliberately Short Entry Point show how other teams structure theirs.
In Claude Cowork, the equivalent places for this kind of guidance are your global instructions, project instructions, and folder instructions.
How to install Beads — Deliberately Short Entry Point
Claude Code
- Copy the parts that fit your project into CLAUDE.md at the project root, or into ~/.claude/CLAUDE.md for rules that apply everywhere.
- Keep it short and specific; remove anything that doesn't match how your team works.
Claude Cowork
- Put personal rules in Settings → Instructions for Claude (global instructions).
- Put project or folder rules in the project's instructions or the folder instructions for that directory.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from CLAUDE.md, shared under the repository's MIT license. Read the full file on GitHub.
This file is intentionally short. Do not copy workflow, build, storage, or UI rules here; those details drift quickly when repeated across agent entrypoints.
Read First
- Workflow and safety: AGENTS.md
- Detailed agent operations: AGENT_INSTRUCTIONS.md
- Architecture orientation: engdocs/CLAUDE.md
- PR maintenance policy: PR_MAINTAINER_GUIDELINES.md
Current Ground Rules
- Run bd prime before doing tracked work.
- Follow go.mod and AGENT_INSTRUCTIONS.md for build and test commands; do not hard-code toolchain versions here.
- Beads uses Dolt as the issue database. Use bd dolt push / bd dolt pull for issue data sync; do not use export/import as a routine git workflow.
- The CLI Visual Design System lives in AGENT_INSTRUCTIONS.md.
- If this file conflicts with a linked source, trust the linked source and fix this file by removing the duplicate.
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Beads — Deliberately Short Entry Point?
Beads — Deliberately Short Entry Point is a claude.md example for Claude Code and Claude Cowork from the gastownhall/beads repository on GitHub. A model of restraint: the file opens by stating it is intentionally short, links the canonical AGENTS.md / instructions / architecture…
How do I install Beads — Deliberately Short Entry Point in Claude Code?
Copy the parts that fit your project into CLAUDE.md at the project root, or into ~/.claude/CLAUDE.md for rules that apply everywhere. Keep it short and specific; remove anything that doesn't match how your team works.
Can I use Beads — Deliberately Short Entry Point in Claude Cowork?
Put personal rules in Settings → Instructions for Claude (global instructions). Put project or folder rules in the project's instructions or the folder instructions for that directory.
Is Beads — Deliberately Short Entry Point safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Beads Dolt-powered issue tracker for multi-session work with dependencies and persistent memory across conversation compaction. Use when work spans sessions, has blockers, or needs context recovery after compaction. Trigger with "create task", "what's ready", "track this work", "resume after compaction". Make sure to use this skill whenever managing multi-session work, tracking dependencies, or… Skill · gastownhall/beads
- Beads AI-supervised issue tracker for coding workflows. Manage tasks, discover work, and maintain context with simple CLI commands. Plugin · gastownhall/beads
- SwiftUI Agent Skill — Scoping What NOT to Include A rare example that spends most of its length defining boundaries: what the skill must exclude (architecture opinions, formatting, tool… CLAUDE.md Example · AvdLee/SwiftUI-Agent-Skill
- Vercel Labs Agent Skills — Skill-Authoring Template One of the most-copied skill-authoring references: a full SKILL.md skeleton (How It Works / Usage / Output / Present Results /… CLAUDE.md Example · vercel-labs/agent-skills
- Supabase Agent Skills — Symlinked Config + Task Runner Shows the pragmatic way to serve multiple agents from one file — CLAUDE.md is a symlink to AGENTS.md, noted up front — and routes all… CLAUDE.md Example · supabase/agent-skills
- Ponytail — Lazy Senior Dev Persona A persona file that is actually a decision procedure: the 'lazy senior dev' framing resolves into a concrete 7-rung ladder (YAGNI → reuse… CLAUDE.md Example · DietrichGebert/ponytail
- Tiger pg-aiguide — MCP Server Code Style Guide A tight, transferable style guide for a TypeScript MCP server: ESM with .js import extensions, zod for tool-input validation, and the… CLAUDE.md Example · timescale/pg-aiguide
- Callstack Agent Skills — Quick Checklist & 'Good Skill' Rubric Distills skill authoring to a numbered quick checklist plus a 'What Makes a Good Skill' rubric (concise, third-person description… CLAUDE.md Example · callstackincubator/agent-skills