Craft - Full Stack Developer Toolkit Plugin
main:
dev:
Docs/publishing commands moved to folio — see
MIGRATION-v4.md for the old-command → new-location table.
v4.7.0 — Craft OpenAI workflow skills + branch-guard updates 🚀
48 commands | 41 skills | 2 agents
Adds skills-first Codex workflows for restoring context, doing project work, and finishing sessions; synchronizes branch-guard improvements; and raises release-gate test coverage above 90%. See NEWS.md.
A comprehensive production-ready toolkit for Claude Code featuring smart orchestration, ADHD-friendly workflows, multi-agent coordination, and complete documentation coverage.
Codex users can use the Craft OpenAI guide for the
skills-first pilot and its local install steps. Package details are in
openai/README.md; this package does not install or modify
the Claude plugin.
Installation
Craft works in both Claude Code CLI and Claude Desktop app. No MCP server dependencies required.
Option 1: Marketplace (Recommended)
# Install from the Data-Wise marketplace, inside Claude Code
claude plugin marketplace add Data-Wise/claude-plugins
claude plugin install craft@data-wise
Works on all platforms (macOS, Linux, Windows). No additional tools required.
Option 2: Homebrew (macOS)
# Add the Data-Wise tap
brew tap data-wise/tap
# Install craft plugin
brew install craft
The Homebrew formula automatically:
- Installs the plugin to
~/.claude/plugins/craft
- Makes it available in Claude Code CLI and Claude Desktop
- No additional configuration needed
Option 3: Quick Install (curl)
# One-command installation
curl -fsSL https://raw.githubusercontent.com/Data-Wise/craft/main/install.sh | bash
Then restart Claude Code to load the plugin.
Option 4: npm (When published)
# Install from npm (after publishing)
npm install -g @data-wise/claude-craft-plugin
# Plugin will auto-install to ~/.claude/plugins/craft
Option 5: Manual Installation (Local Development)
For Claude Code CLI and Claude Desktop:
# Clone the repository
git clone https://github.com/Data-Wise/craft.git
cd craft
# Install in development mode (symlink - changes reflected immediately)
ln -s $(pwd) ~/.claude/plugins/craft
# Or install in production mode (copy - stable)
cp -r . ~/.claude/plugins/craft
Installation locations:
- Plugin directory:
~/.claude/plugins/craft
- Commands:
~/.claude/plugins/craft/commands/
- Skills:
~/.claude/plugins/craft/skills/
- Agents:
~/.claude/plugins/craft/agents/
Verify Installation
# Check plugin directory exists
ls -la ~/.claude/plugins/craft
# Verify plugin.json
cat ~/.claude/plugins/craft/.claude-plugin/plugin.json
# Test a command
claude
/craft:help
Expected output:
Craft v4.0.0 loaded
48 commands available
Using in Claude Code CLI
After installation, commands are immediately available:
# Start Claude Code in any directory
claude
# Use craft commands
/craft:do "add user authentication"
/craft:check
/craft:test unit
Using in Claude Desktop App
Craft automatically loads when you open Claude Desktop. Commands work the same way:
- Open Claude Desktop app
- Start a new conversation
- Use slash commands:
/craft:do, /brainstorm, etc.
MCP Server Setup
Craft does NOT require any MCP server configuration.
Craft is a pure plugin that uses built-in Claude Code capabilities. No external servers needed.
Benefits:
- ✅ Instant startup (no server overhead)
- ✅ Simple installation (no server config)
- ✅ Works offline
- ✅ Self-contained
📚 Documentation
Full documentation: https://data-wise.github.io/craft/ (99% complete)
Full-stack developer toolkit for Claude Code — 48 commands, 2 agents, 41 skills with smart orchestration and ADHD-friendly workflows
Quick Start - Smart Commands
# Universal command - AI routes to best workflow
/craft:do "add user authentication"
# Pre-flight checks
/craft:check # Quick validation
/craft:check --for release # Full release audit
# Context-aware help
/craft:help # Suggestions for your project
/craft:help testing # Deep dive into testing
# Discover all commands
/craft:hub
Mode System
Commands support execution modes for different use cases:
| Mode | Time | Use Case |
|---|
| default | < 10s | Quick checks |
| debug | < 120s | Verbose output, traces |
| optimize | < 180s | Parallel, performance |
| release | < 300s | Comprehensive audit |
/craft:code:lint # Quick check
/craft:code:lint debug # Verbose with suggestions
/craft:test release # Full suite with coverage
/craft:arch:analyze optimize # Performance analysis
Commands (48)
Every command is /craft:<name>. Four root commands (brainstorm, check, next, refine) are
thin shims: the command still works, and its logic lives in the skill named in its
replaced-by: frontmatter.
Workflow & discovery (14)
| Command | What it does |
|---|
/craft:do <task> | Universal entry point — scores the task and routes to the right commands |
/craft:plan <topic> | Universal planning entry — routes to brainstorm, grill, plan-orchestrator, or feature planning |
/craft:brainstorm | Brainstorming with design modes, time budgets, and spec capture (shim → brainstorm skill) |
/craft:grill | Adversarially interrogate a plan or spec, one question at a time |
/craft:check | Pre-flight readiness check before commit / PR / release (shim → preflight-check skill) |
/craft:test | Unified test runner with category filtering and modes |
/craft:orch | Orchestrator mode — subagent delegation, monitoring, mode-aware execution |
/craft:finish | Session completion and context capture (renamed from /craft:done in v4.2.0) |
/craft:restore | Restore git + .STATUS context when returning to a project |
/craft:next | Decision support — what to work on next (shim → adhd-workflow skill) |
/craft:brief | 3-line action block: next step / watch out for / connects to |
/craft:refine | Prompt optimizer (shim → prompt-refiner skill) |
/craft:hub · /craft:smart-help | Browse all commands · context-aware command suggestions |
Code (13)
| Command | What it does |
|---|
/craft:code:lint | Style and quality checks, with modes |
/craft:code:debug | Guided bug diagnosis |
/craft:code:refactor | Refactoring guidance |
/craft:code:test-gen | Generate tests |
/craft:code:demo | Code demonstration |
/craft:code:deps-check · /craft:code:deps-audit | Dependency health · security audit for known vulnerabilities |
/craft:code:docs-check | Documentation and website pre-flight check |
/craft:code:release | Release workflow (delegates to the release skill for plugins) |
/craft:code:release-watch | Track Claude Code + Desktop releases for plugin-relevant changes |
/craft:code:command-audit | Validate command frontmatter and report a health score |
/craft:code:skill-standards | Audit SKILL.md files against Anthropic's authoring standards |
/craft:code:fewer-prompts | Install a curated read-only Bash allowlist |
CI (8)
| Command | What it does |
|---|
/craft:ci:detect · /craft:ci:generate · /craft:ci:validate | Detect project/CI needs · generate a GitHub Actions workflow · validate an existing one |
/craft:ci:local | Run CI checks locally before pushing |
/craft:ci:status | Cross-repo CI status dashboard |
/craft:ci:watch | Poll a run to completion, then route: merge if green, triage if red |
/craft:ci:triage | Classify a failing check as diff-caused vs pre-existing/infra |
/craft:ci:fix | Fix CI failures |
Architecture & planning (5)
| Command | What it does |
|---|
/craft:arch:analyze · /craft:arch:review | Analyze architecture (with modes) · review it |
/craft:arch:plan · /craft:arch:diagram | Plan architecture · generate diagrams |
/craft:plan:feature | Feature planning, with test and doc plans on by default (--no-tests / --no-docs) |
Orchestration (2)
| Command | What it does |
|---|
/craft:orch:drive | Drive an approved SPEC to completion via the /goal loop, with a real verify gate |
/craft:orch:workflow | Run a coded, fixed-control-flow workflow with schema-gated agents |
Docs, site & distribution (6)
| Command | What it does |
|---|
/craft:docs:update · /craft:docs:changelog | Smart doc updates · CHANGELOG from commits |
/craft:site:deploy | Deploy the docs site to GitHub Pages |
/craft:dist:homebrew · /craft:dist:surfaces | Homebrew automation · read-only multi-surface release registry |
/craft:git:issue-check <N> | Check whether an open issue's premise still holds before fixing it |
The rest of the docs-authoring surface (docs:sync, docs:mermaid, docs:tutorial, docs:site,
…) moved to the separate folio plugin in v4.0.0 as
/folio:docs:*. Git workflow operations (branches, worktrees, sync, protection) are the
dev/git skill — ask in plain language ("create a worktree for X"); only
/craft:git:issue-check remains a command.
Skills (41)
Skills trigger from plain-language requests; no slash command needed.
| Area | Skills |
|---|
| Workflow | brainstorm, brainstorm-insights, grill, prompt-refiner, adhd-workflow, background-task-manager |
| Orchestration | task-analyzer, plan-orchestrator, drive-engine, workflow-engine, session-state, repo-triage, orchestrator-resilience |
| Code & quality | audit-router, plugin-audit, command-skill-token-efficiency, sync-features, preflight-check, guard-audit, hooks, insights-apply |
| Design & architecture | system-architect, backend-designer, frontend-designer, devops-helper, project-planner |
| Testing | test-generator, test-strategist |
| Git & release | git-workflow (dev/git), release, changelog-automation |
| Distribution | distribution-strategist, dist-extras, homebrew-formula-expert, homebrew-multi-formula, homebrew-setup-wizard, homebrew-workflow-expert |
| Docs | architecture-decision-records, claude-md-lifecycle |
| CI & modes | project-detector, mode-controller |
Agents (2)
| Agent | Purpose |
|---|
orchestrator-v2 | Multi-step orchestration with subagent monitoring and mode-aware execution — what /craft:do delegates to for complex tasks |
workflow-orchestrator | Background agent delegation, task parallelization, and result synthesis |
The documentation agents (docs-architect, api-documenter, tutorial-engineer, …) ship with
folio.
Workflows
Daily development
/craft:do "add input validation to the signup form" # routed to the right commands
/craft:code:lint && /craft:test # quick quality pass
/craft:finish # capture session context
Returning to a project
/craft:restore # where did I leave off? (git + .STATUS)
/craft:next # what to work on next
Planning a feature
/craft:plan "redesign the auth flow" # picks brainstorm / grill / feature plan
/craft:grill # stress-test the resulting spec
Release preparation
/craft:check --for release # pre-flight
/craft:test release # full suite
/craft:code:release # release workflow
Documentation & site
/craft:docs:update # detect and apply doc updates
/craft:docs:changelog # CHANGELOG from commits
/craft:site:deploy # publish to GitHub Pages
Version
- Version: 4.8.2
- Author: DT (Data-Wise)
- License: MIT
Development
For plugin development and contributions:
- 📖 Architecture Guide - How Craft works internally
- 📖 Commands Reference - All 48 commands documented
- 📖 Skills & Agents - 41 skills, 2 agents
- Development commands (testing, validation, documentation)
- Architecture patterns and plugin structure
- CI/CD workflows and quality standards
- Documentation staleness detection (4-phase checks with traffic light output)
See the documentation site for comprehensive guides.
Changelog
[1.11.0] - 2025-12-30
Changed
- Documentation Commands Consolidation (16→12 commands):
- Super Commands (3):
update, sync, check - smart defaults, do everything useful
- Specialized Commands (8):
api, changelog, site, mermaid, nav-update, prompt, demo, guide
- Internal (1):
claude-md
update: Smart-Full default - detect → generate all needed → check → changelogsync: Merged analyze logic - detection + classification + stale reportcheck: Renamed from validate, Version C full-by-default (links + stale + nav + auto-fix)
Added
/craft:docs:demo - Terminal recorder for GIF demos (asciinema default, VHS optional)/craft:docs:guide - Feature guide + demo + refcard generator
Removed
/craft:docs:validate → renamed to /craft:docs:check/craft:docs:done → merged into sync (default is quick)/craft:docs:generate → merged into update/craft:docs:feature → use update "name" instead/craft:docs:analyze → merged into sync
Philosophy
"Just run the command. It figures out what's needed, then does it."
- Total: 68 commands, 17 skills, 7 agents
[1.10.0] - 2025-12-28
Added
- CI Toolkit (3 commands):
/craft:ci:detect - Smart detection of project type, build tools, and CI requirements/craft:ci:generate - Generate GitHub Actions workflow from detection (Python, Node, R, Rust, Go templates)/craft:ci:validate - Validate existing CI workflow against project configuration
- Project Detector Skill:
- Core detection logic for Python (uv/poetry/pip), Node (npm/pnpm/yarn), R, Rust, Go, Claude plugins
- Detects test frameworks (pytest, jest, vitest, testthat, cargo test)
- Identifies linting configs (ruff, eslint, lintr, clippy)
- Recommends appropriate CI templates based on project type
- Total: 67 commands, 17 skills, 7 agents
[1.9.0] - 2025-12-28
Added
- Site Navigation Command:
/craft:site:nav - ADHD-friendly navigation reorganization- Interactive mode selection menu (analyze, adhd, apply, preview)
- Enforces max 7 top-level sections
- Generates reorganization proposals
- Site Audit Command:
/craft:site:audit - Content inventory & quality audit- Modes: full, outdated, duplicates, gaps
- Generates AUDIT-CONTENT-INVENTORY.md
- Detects version mismatches, duplicate files, missing docs
- Site Consolidate Command:
/craft:site:consolidate - Merge duplicate documentation files- Auto-detect duplicates or merge specific files
- Preview mode, safety backups, link updates
- Archive option instead of delete
- Docs Prompt Command:
/craft:docs:prompt - Generate reusable maintenance prompts- Types: full, reorganize, audit, edit
- Pre-filled with project context
- ADHD-friendly design principles included
- Sub-command UX Pattern:
- Standard menu pattern for commands with modes
- Argument bypass for power users
- Keyboard: ↑↓ Navigate, ⏎ Select, "cancel" to exit
- Consistent footer with tips and related commands
- Total: 63 commands, 16 skills, 7 agents
[1.8.0] - 2025-12-28
Added
- Git Worktrees:
/craft:git:worktree for parallel development
- Mermaid Diagrams:
/craft:docs:mermaid with 6 diagram templates
- New Skills:
mermaid-linter, worktree-expert
- Total: 60 commands, 16 skills, 7 agents
[1.7.0] - 2025-12-27
Added
- Site Commands Redesign (5 new commands):
/craft:site:create - Full documentation site wizard with design presets/craft:site:update - Smart content sync from code changes/craft:site:status - Site dashboard and health check/craft:site:theme - Quick theme changes (colors, presets, fonts)/craft:site:add - Add new documentation pages with templates
- 8 Design Presets:
- Standard:
data-wise, minimal, open-source, corporate
- ADHD-Friendly:
adhd-focus, adhd-calm, adhd-dark, adhd-light
- ADHD-Friendly Features:
- Reduced animations, larger click targets
- Calm color palettes, clear hierarchy
- Warm backgrounds (no harsh white/black)
- Design System: Templates, presets, color palettes
- Preset Gallery: Visual reference for all 8 presets
- Total: 61 commands, 15 skills, 7 agents
[1.6.0] - 2025-12-27
Added
- Docs Workflow Commands (4 new commands):
/craft:docs:update [full] - Smart universal documentation updater/craft:docs:feature [name] - Comprehensive feature documentation/craft:docs:done [summary] - End-of-session doc updates/craft:docs:site [--deploy] - Website-focused updates with deploy
- Documentation Workflow Section in README
- Total: 58 commands, 15 skills, 7 agents
[1.5.0] - 2025-12-27
Added
- Distribution Commands (2 new commands):
/craft:dist:homebrew - Generate/update Homebrew formulas/craft:dist:curl-install - Create curl-based installation scripts
- Distribution Skills (2 new skills):
distribution-strategist - Recommend optimal distribution channelshomebrew-formula-expert - Homebrew formula best practices
- Total: 54 commands, 15 skills, 7 agents
[1.4.0] - 2025-12-27
Enhanced
- Orchestrator v2.1 with major improvements:
- Mode-aware execution (default, debug, optimize, release)
- Improved context tracking with token estimation heuristics
- Timeline view for visual execution progress
- Session persistence with auto-save and resume
- Per-agent context budgets (~15% each)
- Smart summarization for large agent responses
- New commands:
timeline, budget, mode, continue, save, history, new
- Total: 51 commands, 12 skills, 7 agents
[1.3.0] - 2025-12-26
Added
- 5 documentation agents (ported from documentation-generation plugin)
docs-architect - Long-form technical documentationtutorial-engineer - Step-by-step tutorialsapi-documenter - OpenAPI/Swagger documentationreference-builder - Technical reference guidesmermaid-expert - Mermaid diagram generation
- 3 documentation skills
changelog-automation - Changelog patternsarchitecture-decision-records - ADR generationopenapi-spec-generation - OpenAPI specs
- 4 new commands
/craft:docs:generate - Full documentation generation/craft:docs:api - OpenAPI/Swagger documentation/craft:test:cli-gen - Generate CLI test suites/craft:test:cli-run - Run CLI test suites
- Total: 50 commands, 11 skills, 6 agents
[1.2.0] - 2025-12-26
Added
- Mode system (default, debug, optimize, release)
- 3 smart commands (do, check, help)
- 2 new skills (mode-controller, task-analyzer)
- Mode support for lint, test:run, arch:analyze, coverage
- Total: 46 commands, 8 skills, 1 agent
[1.1.0] - 2025-12-26
Added
- 6 new code commands (lint, coverage, deps-check, deps-audit, ci-local, ci-fix)
- 4 new test commands (run, watch, coverage, debug)
- 4 new architecture commands (analyze, plan, review, diagram)
- 3 new planning commands (feature, sprint, roadmap)
- 3 new skills (test-strategist, system-architect, project-planner)
- Total: 42 commands, 6 skills, 1 agent
[1.0.0] - 2025-12-26
Added
- Initial release with 26 commands
- 6 code, 6 site, 8 git, 5 docs commands
- 3 skills (backend, frontend, devops)
- 1 orchestrator agent
- Hub command for discovery
