docs: add spec-driven-with-beads to community schemas table#1232
docs: add spec-driven-with-beads to community schemas table#1232mehmood-baryalai wants to merge 2 commits into
Conversation
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (1)
✅ Files skipped from review due to trivial changes (1)
📝 WalkthroughWalkthroughA single row is added to the Community Schemas table in ChangesCommunity Schema Documentation
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~2 minutes Possibly related PRs
Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/customization.md`:
- Line 349: The table entry for the `spec-driven-with-beads` schema in the
community schemas section references a repository path that only exists on the
feature branch `add-spec-driven-with-beads` and not on main, resulting in a 404
error for users. Either remove this entire row from the table in
customization.md and add it back after the feature branch has been merged to
main, or update the link in the yoinks-yoinks/openspec-schemas repository URL to
explicitly reference the `add-spec-driven-with-beads` branch instead of main
(though this is not recommended for stable documentation as it ties
documentation to a temporary branch).
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: c2f9aaa9-de0c-4831-9b25-d797df1d122b
📒 Files selected for processing (1)
docs/customization.md
1 participant
Adds — an OpenSpec community schema that uses Beads (Issues chained together like beads. A lightweight issue tracker with first-class dependency support.
Usage:
bd [flags]
bd [command]
Working With Issues:
assign Assign an issue to someone
children List child beads of a parent
close Close one or more issues
comment Add a comment to an issue
comments View or manage comments on an issue
create Create a new issue (or batch from markdown/graph JSON)
create-form Create a new issue using an interactive form
delete Delete one or more issues and clean up references
edit Edit an issue field in $EDITOR
gate Manage async coordination gates
label Manage issue labels
link Link two issues with a dependency
list List issues
merge-slot Manage merge-slot gates for serialized conflict resolution
note Append a note to an issue
priority Set the priority of an issue
promote Promote a wisp to a permanent bead
q Quick capture: create issue and output only ID
query Query issues using a simple query language
reopen Reopen one or more closed issues
search Search issues by text query
set-state Set operational state (creates event + updates label)
show Show issue details
state Query the current value of a state dimension
tag Add a label to an issue
todo Manage TODO items (convenience wrapper for task issues)
update Update one or more issues
Views & Reports:
count Count issues matching filters
diff Show changes between two commits or branches
find-duplicates Find semantically similar issues using text analysis or AI
history Show version history for an issue
lint Check issues for missing template sections
stale Show stale issues (not updated recently)
status Show issue database overview and statistics
statuses List valid issue statuses
types List valid issue types
Dependencies & Structure:
dep Manage dependencies
duplicate Mark an issue as a duplicate of another
duplicates Find and optionally merge duplicate issues
epic Epic management commands
graph Display issue dependency graph
supersede Mark an issue as superseded by a newer one
swarm Swarm management for structured epics
Sync & Data:
backup Back up your beads database
branch List or create branches
export Export issues to JSONL format
federation Manage peer-to-peer federation with other workspaces
import Import issues from a JSONL file or stdin into the database
restore Restore full history of a compacted issue from Dolt history
vc Version control operations
Setup & Configuration:
bootstrap Non-destructive database setup for fresh clones and recovery
config Manage configuration settings
context Show effective backend identity and repository context
dolt Configure Dolt database settings
forget Remove a persistent memory
hooks Manage git hooks for beads integration
human Show essential commands for human users
info Show database information
init Initialize bd in the current directory
kv Key-value store commands
memories List or search persistent memories
onboard Display minimal snippet for agent instructions file
prime Output AI-optimized workflow context
quickstart Quick start guide for bd
recall Retrieve a specific memory
remember Store a persistent memory
setup Setup integration with AI editors
where Show active beads location
Maintenance:
batch Run multiple write operations in a single database transaction
compact Squash old Dolt commits to reduce history size
doctor Check and fix beads installation health (start here)
flatten Squash all Dolt history into a single commit
gc Garbage collect: decay old issues, compact Dolt commits, run Dolt GC
migrate Database migration commands
ping Check database connectivity
preflight Show PR readiness checklist
prune Delete old closed beads to reclaim space and shrink exports
purge Delete closed ephemeral beads to reclaim space
rename-prefix Rename the issue prefix for all issues in the database
rules Audit and compact Claude rules
sql Execute raw SQL against the beads database
upgrade Check and manage bd version upgrades
worktree Manage git worktrees for parallel development
Integrations & Advanced:
admin Administrative commands for database maintenance
jira Jira integration commands
linear Linear integration commands
repo Manage multiple repository configuration
Additional Commands:
ado Azure DevOps integration commands
audit Record and label agent interactions (append-only JSONL)
blocked Show blocked issues
completion Generate the autocompletion script for the specified shell
cook Compile a formula into a proto (ephemeral by default)
defer Defer one or more issues for later
formula Manage workflow formulas
github GitHub integration commands
gitlab GitLab integration commands
help Help about any command
init-safety Explain bd init flag semantics and the destroy-token format
mail Delegate to mail provider (e.g., gt mail)
mol Molecule commands (work templates)
notion Notion integration commands
orphans Identify orphaned issues (referenced in commits but still open)
ready Show ready work (open, no active blockers)
rename Rename an issue ID
ship Publish a capability for cross-project dependencies
undefer Undefer one or more issues (restore to open)
version Print version information
Flags:
--actor string Actor name for audit trail (default: $BEADS_ACTOR, git user.name, $USER)
--db string Database path (default: auto-discover .beads/*.db)
-C, --directory string Change to this directory before running the command (like git -C)
--dolt-auto-commit string Dolt auto-commit policy (off|on|batch). 'on': commit after each write. 'batch': defer commits to bd dolt commit; uncommitted changes persist in the working set until then. SIGTERM/SIGHUP flush pending batch commits. Default: off. Override via config key dolt.auto-commit
--global Use the global shared-server database (beads_global)
-h, --help help for bd
--ignore-schema-skew Proceed despite forward schema drift (some queries may fail)
--json Output in JSON format
--profile Generate CPU profile for performance analysis
-q, --quiet Suppress non-essential output (errors only)
--readonly Read-only mode: block write operations (for worker sandboxes)
--sandbox Sandbox mode: disables Dolt auto-push
-v, --verbose Enable verbose/debug output
-V, --version Print version information
Use "bd [command] --help" for more information about a command.) for task tracking and execution — to the community schemas table in docs/customization.md.
Summary by CodeRabbit
spec-driven-with-beads, including maintainer and repository links, plus workflow details for how the task and apply phases run using Beads.