convez.ai
SkillDevOps & InfraestruturaIntermediário
Data-Wise

Craft - Kit de Ferramentas Full-Stack para Desenvolvedor

Data-Wise/craft

86 comandos, 8 agentes e 21 skills para todo ciclo de dev

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin completo para Claude Code com 86+ comandos, 8 agentes e 21+ skills que automatizam fluxos de desenvolvimento, testes, CI/CD, documentação e versionamento. Inclui workflows otimizados para TDAH e orquestração inteligente entre múltiplos agentes.

Instalação

$npx convez-ai Data-Wise/craft

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 2 semanas
Versão
v4.8.2
Issues abertas
10
Contribuidores
1

Casos de uso

  • Automação de fluxos de desenvolvimento (scaffolding, refactoring, testes)
  • Coordenação multi-agente para arquitetura e documentação
  • Integração CI/CD e versionamento Git otimizado
  • Workflows amigáveis com TDAH e planejamento contextual

Veredito

Solução madura (v2.35) com infraestrutura sólida (1638 testes, docs 98% completas) e orquestração inteligente de agentes. Ideal para desenvolvedores que precisam automatizar pipelines completos; requer leitura da documentação para aproveitar todas as 21+ skills disponíveis.

README

A tradução para o português deste README ainda está na fila.

Craft - Full Stack Developer Toolkit Plugin

Documentation Docs Sync Docs Homebrew Release Validate Dependencies

main: Craft CI Deploy Docs dev: Craft CI Documentation Quality Version

v2.34.0 — Commands → Skills Migration 🚀 109 commands | 38 skills | 8 agents | 1638 tests passing 11 new skills (preflight-check, git-workflow, claude-md-lifecycle, nav-sync, site-lifecycle, dist-extras, plan-orchestrator, demonstration-builder, adhd-workflow, brainstorm-insights, background-task-manager) consolidating 53 source commands across 3 batches. Skills auto-activate from conversation context — no command memorization required.

A comprehensive production-ready toolkit for Claude Code featuring smart orchestration, ADHD-friendly workflows, multi-agent coordination, and complete documentation coverage.

Installation

Craft works in both Claude Code CLI and Claude Desktop app. No MCP server dependencies required.

Option 1: Marketplace (Recommended)

# Install from the Claude Code plugin marketplace
claude plugin add github:Data-Wise/craft

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 v1.17.0 loaded
109 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:

  1. Open Claude Desktop app
  2. Start a new conversation
  3. 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 — 109 commands, 8 agents, 38 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:

ModeTimeUse Case
default< 10sQuick checks
debug< 120sVerbose output, traces
optimize< 180sParallel, performance
release< 300sComprehensive 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

Teaching Mode

Specialized workflows for teaching projects with automated validation, semester tracking, and safe publishing.

Key Features:

  • Auto-detection via .flow/teach-config.yml configuration
  • Content validation (syllabus sections, schedule completeness, assignment files)
  • Preview-before-publish workflow (draft → production branches)
  • Semester progress tracking with automatic week calculation
  • ADHD-friendly dashboards and output

Teaching Workflow Demo

Quick Start:

  1. Create .flow/teach-config.yml with course info and semester dates
  2. Run /craft:site:validate to check content completeness
  3. Publish with confidence using /craft:site:publish

Example workflow:

# Check semester progress
/craft:site:progress

# Validate content before publishing
/craft:site:validate

# Publish draft → production (with preview)
/craft:site:publish

Full Tutorial • Config Schema

Commands (109 total)

Workflow Commands (12)

CommandDescription
/brainstorm [depth] [focus] [action]Enhanced brainstorming with smart detection, design modes, time budgets, and agent delegation
/spec-review <file>Interactive spec review with validation, status updates, and archival
/focus [task]Enter focus mode for deep work on a specific task
/nextGet next task recommendation
/done [message]Mark current task as complete
/recapGenerate session summary and progress report
/stuck [description]Get help when blocked on a task
/refine <spec-file>Refine and improve existing spec documents
/task-status [task-id]Check status of background tasks
/task-output <task-id>Get output from completed task
/task-cancel <task-id>Cancel running background task
/adhd-guideADHD-friendly workflow guide and best practices

Brainstorming Modes:

/brainstorm q feat        # Quick feature brainstorm
/brainstorm d arch        # Deep architecture analysis
/brainstorm max ux save   # Max depth UX design with spec capture

Smart Commands (4) - ENHANCED

CommandDescription
/craft:do <task>Universal command - routes to appropriate workflow
/craft:orchestrate <task> [mode]ENHANCED v2.1 Launch orchestrator with mode-aware execution, context tracking, timeline view
/craft:checkPre-flight checks (commit/pr/release)
/craft:helpContext-aware help and suggestions

Orchestrator Modes

/craft:orchestrate "add auth" optimize    # Fast parallel (4 agents)
/craft:orchestrate "prep release" release # Thorough audit
/craft:orchestrate status                 # Agent dashboard
/craft:orchestrate timeline               # Execution timeline
/craft:orchestrate budget                 # Context tracking
/craft:orchestrate continue               # Resume session

Code Commands (12)

CommandDescriptionModes
/craft:code:debugSystematic debugging-----
/craft:code:demoCreate demonstrations-----
/craft:code:docs-checkPre-flight doc check-----
/craft:code:refactorRefactoring guidance-----
/craft:code:releaseRelease workflow-----
/craft:code:test-genGenerate test files-----
/craft:code:lintCode style checks✓
/craft:code:coverageCoverage report✓
/craft:code:deps-checkDependency health-----
/craft:code:deps-auditSecurity scan-----
/craft:code:ci-localCI checks locally-----
/craft:code:ci-fixFix CI failures-----

Test Commands (3)

CommandDescriptionModes
/craft:testUnified test runner✓
/craft:test:genGenerate test suites-----
/craft:test:templateManage test templates-----

Architecture Commands (4)

CommandDescriptionModes
/craft:arch:analyzeArchitecture analysis✓
/craft:arch:planDesign architecture-----
/craft:arch:reviewReview changes-----
/craft:arch:diagramGenerate diagrams-----

Planning Commands (3)

CommandDescription
/craft:plan:featurePlan features with tasks
/craft:plan:sprintSprint planning
/craft:plan:roadmapGenerate roadmaps

Documentation Commands (13) - CONSOLIDATED in v1.11.0

Super Commands (3) - Smart defaults, do everything useful

CommandDescription
/craft:docs:updateSmart-Full: Detect → Generate all needed → Check → Changelog
/craft:docs:syncDetection: Classify changes, report stale docs, recommend actions
/craft:docs:checkValidation: Links + stale + nav + auto-fix (Version C: full-by-default)
# Just run it - figures out what's needed
/craft:docs:update                    # Smart detection → full execution
/craft:docs:update "sessions"         # Feature-specific full cycle
/craft:docs:sync                      # Quick: "3 stale, guide recommended"
/craft:docs:check                     # Full check cycle, auto-fixes issues
/craft:docs:check --report-only       # CI-safe mode (no modifications)

# ADHD-friendly website enhancement (NEW v1.15.0)
/craft:docs:website                   # Full enhancement (all 3 phases)
/craft:docs:website --analyze         # Show ADHD score only
/craft:docs:website --phase 1         # Quick wins: TL;DR, mermaid fixes, time estimates
/craft:docs:website --phase 2         # Structure: Visual workflows, navigation
/craft:docs:website --phase 3         # Polish: Mobile responsive, interactions
/craft:docs:website --dry-run         # Preview changes without writing

Specialized Commands (9)

CommandDescription
/craft:docs:apiOpenAPI/Swagger documentation
/craft:docs:changelogAuto-update CHANGELOG
/craft:docs:siteWebsite-focused updates with optional deploy
/craft:docs:websiteNEW v1.15.0 ADHD-friendly website enhancement (scoring, TL;DR, mermaid fixes)
/craft:docs:mermaidMermaid diagram templates (6 types)
/craft:docs:nav-updateUpdate mkdocs.yml navigation
/craft:docs:promptGenerate reusable maintenance prompts
/craft:docs:demoTerminal recorder for GIF demos (asciinema/VHS)
/craft:docs:guideNEW Feature guide + demo + refcard generator

Internal (1)

CommandDescription
/craft:docs:claude-mdUpdate CLAUDE.md (called by other commands)

Site Commands (12) - ENHANCED in v1.9.0

CommandDescription
/craft:site:createFull documentation site wizard with 8 design presets
/craft:site:navNEW v1.9.0 Navigation reorganization (ADHD-friendly, max 7 sections)
/craft:site:auditNEW v1.9.0 Content inventory & audit (outdated, duplicates, gaps)
/craft:site:consolidateNEW v1.9.0 Merge duplicate/overlapping documentation files
/craft:site:updateUpdate site content from code changes
/craft:site:statusDashboard and health check
/craft:site:themeQuick theme changes (colors, presets, fonts)
/craft:site:addAdd new documentation pages
/craft:site:buildBuild site
/craft:site:previewPreview locally
/craft:site:deployDeploy to GitHub Pages
/craft:site:initBasic initialization (use create for full wizard)

Git Commands (10 + 4 guides)

CommandDescription
/craft:git:initInitialize repository with craft workflow
/craft:git:branchBranch management
/craft:git:statusEnhanced git status (teaching-aware)
/craft:git:syncSmart git sync
/craft:git:cleanClean merged branches
/craft:git:recapActivity summary
/craft:git:worktreeNEW v1.8.0 Parallel development with git worktrees
/craft:git:protectManage local hook (branch-guard.sh) — 3-tier risk classification
/craft:git:protect-baselineNEW v2.32.0 GitHub-side branch protection (PR required, no force-push, no delete)
/craft:git:unprotectSession-scoped bypass for the local hook

Git Guides: refcard, undo-guide, safety-rails, learning-guide

CI Commands (3)

CommandDescription
/craft:ci:detectSmart detection of project type, build tools, and CI requirements
/craft:ci:generateGenerate GitHub Actions workflow from detection
/craft:ci:validateValidate existing CI workflow against project configuration

Distribution Commands (2)

CommandDescription
/craft:dist:homebrewGenerate/update Homebrew formula or cask
/craft:dist:curl-installCreate curl-based install scripts

Discovery

CommandDescription
/craft:hubCommand discovery hub

Skills (17)

SkillCategoryTriggers
backend-designerDesignAPI, database, auth
frontend-designerDesignUI/UX, components
devops-helperDesignCI/CD, deployment
test-strategistTestingTest strategy
cli-test-strategistTestingCLI testing
system-architectArchitectureSystem design
project-plannerPlanningFeature planning
mode-controllerModesMode behavior
task-analyzerOrchestrationTask routing
changelog-automationDocumentationChangelog patterns
architecture-decision-recordsDocumentationADR generation
openapi-spec-generationDocumentationOpenAPI specs
mermaid-linterDocumentationMermaid diagram validation
project-detectorCINEW v1.10.0 Smart project type detection
distribution-strategistDistributionRelease channels
homebrew-formula-expertDistributionHomebrew formulas
worktree-expertGitGit worktree workflows

Agents (7)

AgentPurpose
orchestratorSmart delegation to skills
orchestrator-v2ENHANCED Mode-aware execution, context tracking, timeline view
docs-architectLong-form technical documentation
tutorial-engineerStep-by-step tutorials
api-documenterOpenAPI/Swagger documentation
reference-builderTechnical reference guides
mermaid-expertMermaid diagram generation

Workflows

Daily Development

/craft:check → /craft:test unit → /craft:git:sync

Release Preparation

/craft:check --for release
# OR
/craft:code:deps-audit → /craft:test release → /craft:code:release

Feature Development

/craft:do "add feature name"
# Routes to: arch:plan → code:test-gen → git:branch

Documentation Workflow (v1.11.0 - Consolidated)

# THE ONE COMMAND - detects what's needed, does it all
/craft:docs:update                    # Smart detection → full execution

# Feature-specific documentation
/craft:docs:update "auth"             # Full cycle for auth feature

# Check documentation health
/craft:docs:check                     # Full: links + stale + nav + auto-fix
/craft:docs:check --report-only       # CI mode (no changes)

# Quick status check
/craft:docs:sync                      # "3 stale, guide recommended (score: 7)"

# Deploy website
/craft:docs:site --deploy

Site Workflow

# Create new documentation site with design preset
/craft:site:create --preset adhd-focus

# Change theme quickly
/craft:site:theme --preset adhd-calm
/craft:site:theme --primary "#1a73e8"

# Add new pages
/craft:site:add guide "Getting Started"

# Update content from code changes
/craft:site:update

# Check site health
/craft:site:status

# Build and deploy
/craft:site:build → /craft:site:deploy

Version

  • Version: 2.14.0
  • Author: DT (Data-Wise)
  • License: MIT

Development

For plugin development and contributions:

  • 📖 Architecture Guide - How Craft works internally
  • 📖 Commands Reference - All 109 commands documented
  • 📖 Skills & Agents - 38 skills, 8 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 → changelog
  • sync: Merged analyze logic - detection + classification + stale report
  • check: 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 channels
    • homebrew-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 documentation
    • tutorial-engineer - Step-by-step tutorials
    • api-documenter - OpenAPI/Swagger documentation
    • reference-builder - Technical reference guides
    • mermaid-expert - Mermaid diagram generation
  • 3 documentation skills
    • changelog-automation - Changelog patterns
    • architecture-decision-records - ADR generation
    • openapi-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
Ver o original no GitHub

Bom para

Relacionados