beads-blueprint

Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file"

Use when installing, updating, or verifying JuliusBrussee/caveman in this repository, especially for GitHub Copilot rule wiring and skills-lock refresh. Trigger on phrases like caveman update, refresh caveman, reinstall caveman, copilot caveman install, npx skills add caveman, or npx github:JuliusBrussee/caveman.

Use when multiple agents need consistent linting, typing, formatting, security, and regression checks: run repository gates in deterministic order and enforce fix-then-recheck behavior.

Use when work needs decomposition, multi-step delivery, or delegation across agents: define execution graph, assign specialized subtasks, and run autonomous fix-and-verify loops until done.

Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman:compress FILEPATH or "compress memory file"

Use when development environment status is unknown, onboarding a fresh clone, or missing-tool errors suggest Python, npm, bd, dolt, hooks, or venv are not ready; run preflight checks and bootstrap only when checks fail.

Use when onboarding to Beads, starting sessions, creating/claiming/closing issues, validating issue-prefix + commit trailer behavior, and applying this template's Git-backup sync model (bd backup fetch-git/export-git) while staying aligned with official bd CLI/reference guidance.

Use when preparing a release: generate changelog drafts, write concise release notes, and bump semantic versions for no-tag template release workflows.

Use when asked to search, grep, find files, locate symbol usages, inspect repository structure, or parse JSON/YAML/TOML using rg, fd, jq, and yq across any language or framework.

Use when tasks need latest external library documentation, current API signatures, migration/deprecation guidance, version-sensitive setup decisions, or framework best practices via Context7 MCP.

Use when setting up a new machine or fixing missing CLI tooling (rg/ripgrep, fd, jq, yq, GitHub Copilot CLI). Includes install and verification commands for Windows (winget, no admin), macOS (Homebrew), and Linux (apt/pacman/cargo).

Use when implementing or troubleshooting Azure/.NET/Microsoft APIs: verify method/class names, parameters, packages, and working code samples from official Microsoft references.

Use when you need official Microsoft documentation (concepts, tutorials, configuration, examples) for Azure, .NET, VS Code, GitHub, Agent Framework, or Aspire using Microsoft Learn MCP first.