cofin/choosing-beads-backend
skills/choosing-beads-backend/SKILL.md
Use when a workflow depends on Beads persistence and you need to choose or adapt between official Beads, beads_rust compatibility, or a no-Beads fallback
$ install --global
skillsauthnpx skillsauth add cofin/flow choosing-beads-backendInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 3:23 AM4.6s2 files scanned
SKILL.md
- name:
- choosing-beads-backend
- description:
- Use when a workflow depends on Beads persistence and you need to choose or adapt between official Beads, beads_rust compatibility, or a no-Beads fallback
Choosing Beads Backend
Overview
Default to official Beads (bd). Beads is the Primary Source of Truth for the Flow framework. All tasks, notes, and state MUST be recorded in the active backend. Markdown files are synchronized views of this state.
- Official Beads (
bd): preferred default. Hierarchical epics, rich notes. - Compatibility (
br): use when the repo already depends onbrsemantics or when official Beads is unavailable. - No Beads: DEGRADED MODE. Use only when persistence is not possible. Markdown markers must be updated manually.
- If the user asks for the official Beads experience, use
bd. - If the repo already contains
br-specific commands, documentbras compatibility mode. - If persistence is unavailable, inform the user that
/flow:syncwill be disabled and they must manage Markdown markers manually.
- For local-only artifacts, prefer
.git/info/exclude. - Only modify
.gitignorewhen the user explicitly wants a shared repo policy. - Do not relabel
bras the official Beads experience. - Do not force Beads installation when degraded mode is viable.
Before recommending a backend, verify:
- [ ]
bdis preferred unless compatibility or user constraints say otherwise - [ ]
bris framed as compatibility mode, not the default official path - [ ] No-Beads fallback is mentioned when it is viable
- [ ] Ignore guidance matches the user's intended scope
Example decision:
- "This repo can use official Beads (
bd) by default, keepbravailable for older workflows, and still continue without Beads when the user wants low admin overhead."
Reference
Read references/backend-matrix.md for command mapping and setup guidance.
Related Skills
cofin/tracer
development
VerifiedTrustedCommunity
Use when tracing execution paths, mapping dependencies, understanding unfamiliar code, following data flow, investigating end-to-end behavior, debugging call chains, or deciding which files to read next.
12SKILL.mdUpdated Jun 7, 2026
cofin/security-auditor
development
VerifiedTrustedCommunity
Use when reviewing authentication, authorization, user input, secrets, API keys, database queries, file uploads, session management, external API calls, OWASP risks, or data handling attack surface.
12SKILL.mdUpdated Jun 7, 2026
cofin/perspectives
testing
VerifiedTrustedCommunity
Use when analyzing tradeoffs, comparing approaches, weighing options, assessing risks, stress-testing conclusions, identifying blind spots, or applying multiple viewpoints to a decision.
12SKILL.mdUpdated Jun 7, 2026
cofin/performance-analyst
development
VerifiedTrustedCommunity
Use when reviewing hot paths, slow code, database queries, N+1 risks, memory usage, loops, I/O, caching strategy, concurrency, latency-sensitive paths, or resource efficiency.
12SKILL.mdUpdated Jun 7, 2026