workflow-commands

Kyle's Claude Code Plugins

Personal plugin marketplace for Claude Code workflow extensions with beads/deciduous tracking integration, lightly and lovingly wrapping ed3d's coding plugins. In desperate search of a name that doesn't suck.

Table of Contents

• Installation
• Prerequisites
• Commands Reference
• Workflow
• Customization
• Structure

---

Installation

1. Register the marketplace

/plugin marketplace add kyle-claude-plugins

2. Install plugins

# Workflow commands (required)
/plugin install workflow-commands@kyle-claude-plugins

# Tracking hooks (optional - session start reminders, git hooks)
chmod +x ~/code/kyle-claude-plugins/plugins/tracking-hooks/hooks/*.sh
chmod +x ~/code/kyle-claude-plugins/plugins/tracking-hooks/hooks/*.py
/plugin install tracking-hooks@kyle-claude-plugins

---

Prerequisites

Required Tools

1. beads (Task Tracking)

Local task/issue tracking stored in .beads/ directory.

# Install
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# Verify
bd --version

Key commands:

bd init                          # Initialize in project
bd create "Task" -t task -p 3    # Create task (priority 0-4)
bd list                          # List all tasks
bd ready                         # Show unblocked tasks
bd update <id> --status done     # Update status
bd close <id> --reason "Done"    # Close task

2. deciduous (Decision Journaling)

Decision graph stored in .deciduous/ directory.

# Install
npm install -g deciduous

# Verify
deciduous --version

Key commands:

deciduous init                             # Initialize in project
deciduous add goal "What I'm doing" -c 80  # Confidence 0-100
deciduous add decision "Choice and why" -c 80
deciduous add action "What I did"
deciduous add outcome "What happened"
deciduous add action "Committed X" --commit HEAD  # Link to git
deciduous query                            # View graph

3. ed3d-plugins (Core Workflow)

Design and implementation workflow framework.

# Register marketplace
/plugin marketplace add https://github.com/ed3dai/ed3d-plugins.git

# Install plugins
/plugin install ed3d-plan-and-execute@ed3d-plugins
/plugin install ed3d-research-agents@ed3d-plugins
/plugin install ed3d-basic-agents@ed3d-plugins

Optional Tools

Linear Integration

If using --linear flag with /workflow-commands:intake:

• Must have Linear MCP connector enabled in Claude
• Requires access to at least one Linear team

Pre-commit

For automatic verification hooks:

pip install pre-commit
pre-commit install  # In each project

---

Commands Reference

/workflow-commands:project-init

Initialize beads and deciduous tracking in a project.

/workflow-commands:project-init [--beads-only | --deciduous-only] [--with-guidance]

Flag	Description
--beads-only	Only initialize beads, skip deciduous
--deciduous-only	Only initialize deciduous, skip beads
--with-guidance	Create .ed3d/ directory with customization files

Creates:

• .beads/ - Task database
• .deciduous/ - Decision graph
• .ed3d/ - Guidance files (if --with-guidance)

---

/workflow-commands:intake

Import features from a roadmap file or inline list.

# From markdown file
/workflow-commands:intake @docs/roadmap.md

# With Linear sync
/workflow-commands:intake @docs/roadmap.md --linear

# Inline features
/workflow-commands:intake "OAuth integration" "Rate limiting" "Audit logging"

# Inline with Linear and team
/workflow-commands:intake "Feature 1" "Feature 2" --linear --team Engineering

Argument	Description
@file.md	Path to markdown roadmap file
"feature"	Inline feature names (quoted)
--linear	Also create Linear issues
--team <n>	Linear team name (required if multiple teams)

Roadmap format:

## Q1 Features

### OAuth Integration
Support Google and GitHub providers.
Priority: High

### Rate Limiting  
Token bucket algorithm.
Priority: Normal

Creates:

• Beads epic per feature (with priority)
• Linear issue per feature (if --linear)
• Bidirectional links between beads and Linear

---

/workflow-commands:explore

Research a topic with automatic tracking.

/workflow-commands:explore <topic> [--codebase-only | --web-only] [--no-tracking]

Flag	Description
--codebase-only	Only search local codebase
--web-only	Only search web
--no-tracking	Skip beads task creation (deciduous still logs)