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:
Hurblat