Skill
Community

bee-state

Install
1
Install the plugin
$
npx claudepluginhub incubyte/claude-plugins --plugin bee

Want just this skill?

Then install: npx claudepluginhub u/[userId]/[slug]

Description

This skill should be used when updating workflow state in bee-state.local.md. Contains the full command reference for update-bee-state.sh including init, set, get, clear, all flags, and multi-line field syntax.

Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Bee State Script Reference

The state script manages .claude/bee-state.local.md — the source of truth for workflow progress across sessions.

CRITICAL: Never use Write or Edit tools on bee-state.local.md — that triggers permission prompts. Always use this script via Bash. It is pre-approved in allowed-tools.

Script Path

${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh

Commands

Initialize (after triage):

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" init --feature "User auth" --size FEATURE --risk MODERATE

Update fields (incremental — only pass what changed):

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" set --current-phase "single-phase" --phase-spec "docs/specs/user-auth.md — confirmed"

Read state (on startup):

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" get

Read single field:

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" get --field feature

Clear (when done):

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" clear

Available Flags

--feature, --size, --risk, --discovery, --design-brief, --boundaries, --current-phase, --phase-spec, --architecture, --tdd-plan, --current-slice, --phase-progress, --slice-progress

Multi-line Fields

For phase-progress and slice-progress, use | as line separator:

"${CLAUDE_PLUGIN_ROOT}/scripts/update-bee-state.sh" set --phase-progress "Phase 1: done — Cart|Phase 2: executing|Phase 3: not started"
Stats
Stars3
Forks0
Last CommitFeb 22, 2026

Similar Skills