메뉴
Session-start sync ritual. Pulls latest Beads state, lists active OpenSpec changes, shows ready and blocked work, and outputs a one-paragraph state summary. Use at the start of any session before picking up OpenSpec-backed Beads work.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Change-wide completion workflow. Verify no open or in-progress required Beads issues, run openspec validate and quality gates, close the epic, invoke openspec-archive-change, then follow the session-close protocol. Use when all implementation issues for an OpenSpec change are done.
Triage discovered work into in-scope bug, in-scope task, or out-of-scope follow-up. Sets correct type, priority, and dependency linkage in Beads. Does not silently expand the claimed issue's scope.
Import an approved OpenSpec change into Beads. Creates one epic, one Beads issue per tasks.md entry, infers task-level dependencies by reading each task description, then shows bd ready snapshot. Use after OpenSpec artifacts are approved and before coding starts.
Handle a spec gap discovered mid-implementation. Updates OpenSpec artifacts first via openspec-continue-change or openspec-sync-specs, validates, then creates and links Beads issues for the new work. Use when implementation reveals missing, contradictory, or changed behavior that must be reflected in OpenSpec before coding continues.
Single-issue agent execution loop for OpenSpec-backed Beads work. Claim one ready issue, re-read the referenced OpenSpec artifacts, plan, implement scoped changes, run unit tests and openspec validate, then close or update with blockers. Self-contained — no runbook needed.
Use when deciding between built-in Agent parallelism and ruflo-swarm for multi-agent tasks. Default is always the built-in Agent tool. Ruflo swarm is the escalation path for consensus-required or state-sharing tasks only.
SOC 직업 분류 기준
| name | openspec-beads-sync |
| description | Session-start sync ritual. Pulls latest Beads state, lists active OpenSpec changes, shows ready and blocked work, and outputs a one-paragraph state summary. Use at the start of any session before picking up OpenSpec-backed Beads work. |
| license | MIT |
| compatibility | Requires openspec CLI and bd (beads) CLI. |
| metadata | {"author":"openspec","version":"1.0","generatedBy":"1.1.1"} |
Sync Beads and OpenSpec state at session start.
Input: None.
Steps
Repair worktree Beads runtime
if [ -x scripts/setup-worktree-beads.sh ]; then
scripts/setup-worktree-beads.sh
fi
This is local runtime setup only: it links ignored worktree Beads runtime files to the main checkout so all worktrees share the same Dolt database. If it reports that the main checkout is detected, continue.
Pull latest Beads state
bd prime
bd dolt pull
If bd dolt pull reports no remote, continue with local state and note it in the summary.
Show active OpenSpec changes
openspec list
Show ready and blocked work
bd ready
bd blocked
Write state summary
Output one paragraph covering:
Guardrails
bd ready returns nothing, surface that explicitly so the user knows no work is availablebd dolt pull fails, note it in the summary and continue — do not stop