Skip to content

Craft v1.16.0 - Documentation Complete 🎉

Choose a tag to compare

View all tags
@Data-Wise Data-Wise released this 01 Jan 02:36
· 110 commits to main since this release
craft-v1.16.0
3c9054d

Craft v1.16.0 - Documentation Complete 🎉

Release Date: December 31, 2025
Status: Production Ready

🎯 Milestone: Complete Documentation

This release marks the completion of comprehensive documentation for all Craft plugin features with 100% coverage of commands, skills, agents, and visual workflow demonstrations.

📊 What's Included

Category Count Status
Commands 74 ✅ Fully documented
Skills 21 ✅ Fully documented
Agents 8 ✅ Fully documented
Workflow GIFs 10 ✅ Created with VHS

✨ Major Features (v1.16.0)

1. Complete Command Documentation

All 74 commands now have comprehensive documentation across 9 categories:

New Command Categories (v1.16.0):

  • Architecture (4 commands) - /craft:arch:analyze, diagram, plan, review
  • Distribution (3 commands) - /craft:dist:homebrew, pypi, curl-install
  • Planning (3 commands) - /craft:plan:feature, sprint, roadmap

Updated Categories:

  • Code & Testing (17 commands) - Added CI/CD, dependencies, release management
  • Site Management (15 commands) - Added page creation, validation, framework support
  • Documentation (17 commands) - Added site integration and workflows
  • Smart Commands (3 commands) - AI routing and orchestration
  • Git & CI (5 commands) - Worktrees, sync, automation

2. Visual Workflow Demonstrations (NEW)

10 VHS-generated GIF demonstrations covering core workflows:

  1. Documentation Update - /craft:docs:update smart cycle
  2. Site Creation - /craft:site:create --preset adhd-focus
  3. Release Workflow - /craft:check --for release comprehensive audit
  4. Development - /craft:do AI task routing
  5. Testing - /craft:test:run debug with suggestions
  6. Linting - /craft:code:lint optimize parallel execution
  7. Git Worktree - /craft:git:worktree add parallel development
  8. Homebrew Distribution - /craft:dist:homebrew setup wizard
  9. Pre-commit Checks - /craft:check --for commit safety validation
  10. Orchestrator - /craft:orchestrate with live monitoring

Total: ~14MB of visual documentation with Catppuccin Mocha theme

3. Complete Skills & Agents Guide

21 Skills documented:

  • Design (3): backend-designer, frontend-designer, system-architect
  • Testing (2): test-strategist, cli-test-strategist
  • Development (3): devops-helper, project-planner, mode-controller
  • Documentation (4): changelog-automation, ADR, doc-classifier, mermaid-linter
  • Distribution (5): strategist, Homebrew experts, multi-formula support
  • Infrastructure (2): session-state, project-detector
  • Core (2): task-analyzer, mode-controller

8 Agents documented:

  • backend-architect - Scalable API design
  • docs-architect - Technical documentation
  • api-documenter - OpenAPI/SDK generation
  • tutorial-engineer - Step-by-step guides
  • reference-builder - API references
  • mermaid-expert - Diagram creation
  • demo-engineer - VHS/GIF creation
  • orchestrator-v2 - Multi-agent coordination

4. One-Command Installation

# Quick install
curl -fsSL https://raw.githubusercontent.com/Data-Wise/claude-plugins/main/craft/install.sh | bash

Features:

  • Automatic dependency checking (Claude Code CLI)
  • Sparse checkout for fast installation
  • Update detection and reinstall option
  • Installation verification
  • Post-install quick start guide

📚 Documentation Site

Live at: https://data-wise.github.io/claude-plugins/craft/

Navigation Structure:

  • 🚀 Quick Start (30-second onboarding)
  • 🧠 ADHD Guide (neurodivergent-friendly)
  • 📊 Visual Workflows (10 GIF demonstrations)
  • 🎮 Playground (interactive examples)
  • 📚 Reference Card (quick command lookup)
  • Commands (9 categories, all 74 documented)
  • Guide (getting started, skills & agents, orchestrator)

ADHD-Friendly Features:

  • 8 design presets (data-wise, adhd-focus, adhd-calm, etc.)
  • TL;DR boxes on every page (30-second summaries)
  • Time estimates for all tutorials
  • Visual hierarchy with emojis and sections
  • Mermaid diagrams (validated, error-free)
  • Mobile responsive design

🔧 Technical Improvements

Documentation Infrastructure

  • MkDocs Material theme with custom styling
  • Strict mode validation - zero warnings or errors
  • Broken link detection - automated checking
  • Mermaid diagram linting - syntax validation
  • VHS integration - reproducible GIF demos

Content Quality

  • All command counts updated (74 commands, 21 skills, 8 agents)
  • Cross-referenced documentation (commands ↔ workflows)
  • Integration tables showing command relationships
  • Troubleshooting sections for common issues
  • Next steps guidance on every page

Build & Deploy

  • GitHub Actions auto-deployment
  • mkdocs build --strict passes cleanly
  • Navigation structure optimized (< 7 top sections)
  • Search enabled with suggestions
  • Dark mode support

🚀 Installation

Method 1: Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/Data-Wise/claude-plugins/main/craft/install.sh | bash

Method 2: Manual Install

# Clone the repository
git clone --depth 1 --filter=blob:none --sparse https://github.com/Data-Wise/claude-plugins.git
cd claude-plugins
git sparse-checkout set craft

# Copy to Claude plugins directory
cp -r craft ~/.claude/plugins/

# Restart Claude Code to load the plugin

Method 3: Symlink (Development)

# For plugin development or local modifications
ln -s ~/projects/dev-tools/claude-plugins/craft ~/.claude/plugins/craft

📖 Getting Started

After installation, restart Claude Code and try:

# Discover all commands
/craft:hub

# Get context-aware help
/craft:help

# AI routes your task automatically
/craft:do "add authentication to my API"

# Create a documentation site
/craft:site:create --preset adhd-focus

# Check before release
/craft:check --for release

# Multi-agent orchestration
/craft:orchestrate "prepare v2.0 release" release

📊 Statistics

Code & Documentation

  • Lines of Documentation: ~12,000+ (across all .md files)
  • Command Files: 74 command implementations
  • Skills: 21 auto-triggered expertise modules
  • Agents: 8 specialized long-running assistants
  • GIF Demos: 10 workflow demonstrations (~14MB)
  • MkDocs Pages: 25+ comprehensive guides

Test Coverage

  • All documentation builds without errors (mkdocs build --strict)
  • Zero broken links
  • All Mermaid diagrams validated
  • All code examples tested

🎯 Use Cases

For Individual Developers

  • /craft:do - Natural language task routing
  • /craft:code:lint optimize - Fast parallel linting
  • /craft:test:run debug - Detailed test output
  • /craft:check --for commit - Pre-commit safety

For Teams

  • /craft:site:create - Documentation sites in minutes
  • /craft:arch:analyze - Architecture pattern detection
  • /craft:plan:sprint - Sprint planning with capacity management
  • /craft:dist:homebrew setup - Automated release distribution

For Open Source Projects

  • /craft:docs:update - Smart documentation sync
  • /craft:git:worktree - Parallel development workflows
  • /craft:check --for release - Pre-release validation
  • /craft:orchestrate - Multi-agent task coordination

🔄 Upgrade from v1.15.0

If you have v1.15.0 installed:

# Reinstall with the install script
curl -fsSL https://raw.githubusercontent.com/Data-Wise/claude-plugins/main/craft/install.sh | bash

# Or manually update
cd ~/.claude/plugins/craft
git pull origin main

What's New:

  • 3 new command categories (Architecture, Distribution, Planning)
  • 16 additional commands documented
  • 10 workflow GIF demonstrations
  • Complete skills & agents guide
  • One-command installation script

📝 Breaking Changes

None. This is a documentation-focused release with full backward compatibility.

🐛 Known Issues

None currently. Documentation build validates cleanly with mkdocs build --strict.

🙏 Acknowledgments

Built with Claude Code and documented with the help of Claude Sonnet 4.5.

Key Technologies:

  • MkDocs Material (documentation framework)
  • VHS (terminal GIF recording)
  • Mermaid.js (diagram generation)
  • GitHub Actions (auto-deployment)

📄 License

MIT License - see LICENSE file for details

🔗 Links

🎉 What's Next?

v1.16.0 represents the "Documentation Complete" milestone. Future development will focus on:

  • Additional workflow automations
  • Enhanced ADHD-friendly features
  • Community-contributed skills and agents
  • Extended language support

Craft is now production-ready with complete documentation! 🚀

Assets 2
Loading