kraftwork-github

Kraftwork

Opinionated developer workflow orchestration for Claude Code. Manages the full development lifecycle — from ticket to merge request — through spec-driven planning, git worktree isolation, and modular integrations.

Quick Start

Install via Claude Code CLI

claude plugin marketplace add https://github.com/filipeestacio/kraftwork.git

claude plugin install kraftwork@kraftwork-marketplace

Then restart Claude Code and run /kraft-config to set up your workspace.

Install extensions

Pick the ones relevant to your stack:

claude plugin install kraftwork-gitlab@kraftwork-marketplace   # GitLab CI/CD + merge requests
claude plugin install kraftwork-github@kraftwork-marketplace   # GitHub pull requests
claude plugin install kraftwork-jira@kraftwork-marketplace     # Jira ticket management
claude plugin install kraftwork-clickup@kraftwork-marketplace  # ClickUp tickets + docs
claude plugin install kraftwork-intel@kraftwork-marketplace    # Local knowledge base + metrics
claude plugin install kraftwork-argocd@kraftwork-marketplace   # ArgoCD deployment health
claude plugin install kraftwork-review@kraftwork-marketplace   # Independent code review
claude plugin install kraftwork-zellij@kraftwork-marketplace   # Zellij terminal multiplexer

Let Claude Code install it for you

Copy this entire block into a Claude Code session:

Install the Kraftwork plugin marketplace and plugins for this workspace.

1. Add the marketplace:
   claude plugin marketplace add https://github.com/filipeestacio/kraftwork.git

2. Install the core plugin (always required):
   claude plugin install kraftwork@kraftwork-marketplace

3. Then install whichever extensions match this project's tooling. Available:
   - kraftwork-github — GitHub git hosting provider
   - kraftwork-gitlab — GitLab CI/CD and merge requests
   - kraftwork-jira — Jira ticket management
   - kraftwork-clickup — ClickUp tickets and document storage
   - kraftwork-intel — local knowledge base, metrics, and evals
   - kraftwork-argocd — ArgoCD deployment health
   - kraftwork-review — independent code review perspectives
   - kraftwork-zellij — Zellij terminal multiplexer
   - presentation — standalone HTML slideshow generator

   Install with: claude plugin install <name>@kraftwork-marketplace

   If any install fails with EACCES on ~/.claude/settings.json (common with
   Nix / Home Manager), retry with --scope project.

4. After installing, tell me to restart the session so plugin skills are
   registered, then run /kraft-config to initialize the workspace.

Alternative installation methods

Local path (for development or if you've cloned this monorepo):

claude --plugin-dir /path/to/kraftwork/kraftwork
claude --plugin-dir /path/to/kraftwork/kraftwork-gitlab

Nix / Home Manager — if ~/.claude/settings.json is a read-only symlink, use --scope project for all installs:

claude plugin install kraftwork@kraftwork-marketplace --scope project

Overview

Kraftwork is a monorepo containing a core plugin and optional extensions, all built as Claude Code plugins. It enforces a structured workflow: plan before you code, isolate work in worktrees, decompose into small reviewable MRs, and capture learnings along the way.

kraftwork/              Core workflow plugin with pluggable provider interfaces
kraftwork-github/       GitHub git hosting provider
kraftwork-gitlab/       GitLab CI/CD and merge request provider
kraftwork-jira/         Jira ticket management provider
kraftwork-clickup/      ClickUp ticket management and document storage provider
kraftwork-intel/        Local intelligence — metrics, knowledge, evals (memory provider)
kraftwork-argocd/       ArgoCD deployment health and debugging
kraftwork-review/       Independent code review perspectives
kraftwork-zellij/       Zellij terminal multiplexer control

Core Workflow

The typical development cycle:

1. /kraft-config — Configure workspace with repos, providers, and directory scaffolding
2. /kraft-work TICKET-123 — Create a git worktree for a ticket, resume existing work, or stack worktrees
3. /kraft-plan — Brainstorm, create a spec, and decompose work into MR-sized tasks
4. /kraft-implement — Execute tasks from the spec with change tracking
5. /kraft-split — Split a branch into stacked MRs with verification
6. /kraft-archive — Clean up completed worktrees with safety checks

Additional commands: /kraft-sync (pull latest across repos), /kraft-import (import remote branches), /kraft-retro (post-merge retrospective).

Workspace Layout