beads/CLAUDE.md
Chris Sells 0e017821f4 docs: move internal/maintainer docs from docs/ to engdocs/
Relocate contributor- and maintainer-facing material out of docs/ so the
directory can become the user-facing Mintlify site. Moves preserve subpaths
(adr/, design/, staged-for-removal/ intact). messaging.md, UI_PHILOSOPHY.md,
and AGENT_SIGNING.md move per their DOC_INVENTORY dispositions (design doc,
design philosophy, maintainer convention).

Inbound links updated repo-wide: root guides, CONTRIBUTING, AGENTS,
workflows, lint config, scripts (check-doc-freshness now resolves the
inventory at engdocs/DOC_INVENTORY.md), Go comments, and the synced website
metadata page (regenerated via sync-website-docs.sh + generate-llms-full.sh).

The emitted help text in cmd/bd/init_safety_help.go still references
docs/adr/0002-init-safety-invariants.md; changing it would change bd's
runtime output, which is out of scope for this branch (flagged in the PR).
2026-07-12 10:37:07 -07:00

1.1 KiB

Claude Code Entry Point for Beads

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

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.