claude-constructor

Claude Constructor

A workflow automation plugin for Claude Code that guides feature development through structured planning, validation, and review—with human approval gates at every critical decision point.

Why Use This?

Problem	Solution
Claude loses focus mid-implementation	State-tracked workflow keeps execution on rails
Scope creep and unplanned changes	Sign-off gates lock requirements before coding starts
Implementation diverges from intent	Detailed specs with parallel execution plans
Hidden assumptions and blind spots	Explicit requirements you review and approve

Quick Start

# 1. Add the marketplace
/plugin marketplace add https://github.com/Hurblat/claude-constructor

# 2. Install the plugin
/plugin install claude-constructor@hurblat-plugins

# 3. Start your first feature
/feature Add dark mode toggle to settings page

That's it. Claude Constructor will guide you through planning → approval → implementation → review → PR.

The Workflow

┌─────────────────────────────────────────────────────────────────────┐
│                           PLANNING                                  │
├─────────────────────────────────────────────────────────────────────┤
│  /feature "description"                                             │
│       ↓                                                             │
│  Requirements Definition  →  Audit  →  ✋ YOUR SIGN-OFF             │
│       ↓                                                             │
│  Specification Writing    →  Audit  →  ✋ YOUR SIGN-OFF             │
├─────────────────────────────────────────────────────────────────────┤
│                        IMPLEMENTATION                               │
├─────────────────────────────────────────────────────────────────────┤
│  Git checkout  →  Parallel implementation  →  Security review       │
│       ↓                                                             │
│  E2E tests  →  Code review  →  Create PR                            │
├─────────────────────────────────────────────────────────────────────┤
│                           REVIEW                                    │
├─────────────────────────────────────────────────────────────────────┤
│  ✋ YOU REVIEW PR  →  Address feedback  →  ✋ YOU MERGE              │
└─────────────────────────────────────────────────────────────────────┘

Human checkpoints (✋): You approve requirements, specifications, and the final PR. Nothing ships without your sign-off.

Commands

Command	Description
/feature <description or issue-key>	Main orchestrator—runs the full workflow
/feature ABC-123	Start from a Linear/Jira issue
/feature ABC-123 --silent=true	Skip external API calls (testing mode)

Internal Commands (called by orchestrator)

Command	Phase
/create-state-management-file	Setup
/read-settings	Setup
/requirements-sign-off	Planning
/specification-sign-off	Planning
/git-checkout	Implementation
/implement-increment	Implementation
/write-end-to-end-tests	Implementation
/create-pull-request	Review
/review-pull-request	Review
/implementation-summary	Review

Resuming Workflows

If your session ends mid-workflow, simply run /feature with the same issue key. Claude Constructor will detect existing progress and offer to resume:

Progress for ABC-123:
- [x] Requirements defined + approved
- [x] Specification written + approved
- [ ] Implementation ← Resume point

Existing workflow found for ABC-123. Resume from 'Implementation'?
> Resume (Recommended)
> Start Fresh

What gets preserved:

• Approved requirements and specifications
• Completed implementation agents (parallel work)
• Security and code review history
• Git branch and PR state

Start Fresh: Archives the existing state to claude_constructor/{issue_key}-archived-{timestamp}/ and begins a new workflow.

Agents

Specialized subagents handle complex tasks:

Agent	Purpose
requirements-definer	Extracts and structures requirements from issue/prompt
requirements-definer-auditor	Validates requirements are complete and testable
specification-writer	Creates implementation spec with parallel execution plan
specification-writer-auditor	Validates spec is actionable and properly scoped
increment-implementer	Executes implementation tasks (can run in parallel)
increment-implementer-auditor	Verifies implementation quality and scope adherence
code-reviewer	Reviews code against specification requirements
security-reviewer	Security-focused code analysis

Issue Tracking Integration

Claude Constructor auto-detects your issue tracking system via MCP tools: