claude-tweaks

claude-tweaks

A structured workflow system for Claude Code — from idea capture through build, review, and wrap-up.

What this does

Claude Code is powerful but unstructured. claude-tweaks adds a complete development lifecycle: capture ideas, challenge assumptions, decompose into specs, build with quality gates, and learn from what was built. Every finding is explicitly resolved — nothing silently drops.

See CHANGELOG.md for release history.

Installation

/plugin marketplace add thomasholknielsen/claude-tweaks-marketplace
/plugin install claude-tweaks@claude-tweaks-marketplace
/plugin install superpowers@claude-plugins-official
/claude-tweaks:init

How it works

  SKILL                      ARTIFACT                 SUPERPOWERS USED
  ─────                      ────────                 ────────────────

  capture ──────────────►  Backlog record
     │
  challenge ────────────►  Brief
     │
     │                     Design Doc          ◄───  brainstorm
     │                     (specify can invoke brainstorm directly on topic input)
     │
  specify ──────────────►  Ready record(s)    (writes surface: + design-intent: body metadata)
     │  calls: design shape (frontend only — appends Impeccable shape output to design doc)
     │  calls: visualize (diagram suggestion, all surfaces)
     │                     (deletes Brief + Design Doc)
     │
  ┈┈ /claude-tweaks:triage grants, /claude-tweaks:dispatch claims (utility skills, no fixed position) ┈┈
     │
  ┈┈ /claude-tweaks:flow automates below (worktree mode default) ┈┈
     │
  build ────────────────►  Code + Journeys    ◄───  subagent-driven-development
     │  calls: design pre-build (lazy-load Impeccable references)
     │         simplify,                             executing-plans
     │         journeys                              using-git-worktrees ⚙
     │           calls: visualize (diagram suggestion)
     ┊  (if UI changed)
  stories ──────────────►  Story YAML
     │
  test ─────────────────►  TEST_PASSED
     │  calls: design test (Impeccable detect — deterministic CLI gate)
     │
  review ───────────────►  Review Summary     ◄───  dispatching-parallel-agents
     │  calls: design review (Impeccable critique + audit — advisory)
     │         visualize (diagram gap finding — Lens 3i-diagram),
     │         reflect,
     │         simplify,
     │         visual-review (calls: design survey — Creative Opportunities)
     │
  polish ───────────────►  Polished Code      (frontend specs only)
     │  calls: design polish (auto-fit + issue-driven + intent-driven)
     │         test skip-qa  (re-verify gate, 1-cycle cap)
     │
  flow summary ─────────►  Pipeline report    (Creative Opportunities block)
     │  calls: design survey (full diff; decline tracking)
     │
  wrap-up ──────────────►  Done               ◄───  finishing-a-dev-branch ⚙
     │  calls: reflect
     │         (full)
                           (deletes plans, ledger, design caches; legacy spec file
                            deleted too — a record-mode build's materialized file
                            stays on the branch as committed audit trail instead;
                            applies demo:pending + posts a Verification Brief on
                            the record — record mode only)
     │
  ┈┈ /claude-tweaks:demo resolves demo:pending → approved/changes-requested (utility skill, no fixed position — run anytime, aggregates every in-flight thread, plus this session's own unrecorded work via session-recall) ┈┈

Left column: /claude-tweaks:{name} — Right column: /superpowers:{name} (Superpowers plugin) ⚙ = worktree mode only — ┊ = conditional step /claude-tweaks:init runs once per project, before entering the pipeline.

Work Records

Every unit of work — a captured idea, a health-skill finding, or a human-filed issue — is the same thing underneath: a work record, tracked through one spine regardless of who filed it:

BACKLOG ──/specify shapes──► READY ──human grants──► AUTHORIZED ──/dispatch claims──► BUILDING ──user merges──► CLOSED