potenlab-marketplace

Potenlab Workflow

Full-stack project planning and execution for Claude Code. Orchestrates specialist agents to plan, build, and iterate on projects.

Installation

npx potenlab-workflow

This installs commands, agents, and best-practice rules into ~/.claude/ so Claude Code auto-discovers them.

Options

npx potenlab-workflow              # Install globally to ~/.claude/
npx potenlab-workflow --local      # Install to ./.claude/ (project-scoped)
npx potenlab-workflow --uninstall  # Remove all potenlab files

Verify

Start a new Claude Code session, then:

/potenlab:hello

Expected output:

Potenlab Workflow is active. potenlab-workflow v0.2.0 loaded successfully.

What Gets Installed

~/.claude/
├── commands/potenlab/          # 13 slash commands
│   ├── plan-project.md
│   ├── execute-phase.md
│   ├── developer.md
│   ├── complete-plan.md
│   ├── review-plan.md
│   ├── generate-test.md
│   ├── run-test-all.md
│   ├── run-test-phase.md
│   ├── verify-test.md
│   ├── security-review.md
│   ├── security-resolve.md
│   ├── info.md
│   └── hello.md
├── agents/                     # 9 specialist agents (potenlab-prefixed, project memory enabled)
│   ├── potenlab-ui-ux-specialist.md
│   ├── potenlab-tech-lead-specialist.md
│   ├── potenlab-frontend-specialist.md
│   ├── potenlab-backend-specialist.md
│   ├── potenlab-progress-creator.md
│   ├── potenlab-high-coder.md
│   ├── potenlab-small-coder.md
│   ├── potenlab-qa-specialist.md
│   └── potenlab-security-specialist.md
└── potenlab-workflow/          # Core data
    ├── VERSION
    ├── CLAUDE.md
    ├── rules/                  # React best practices
    └── references/             # Postgres best practices

Workflow

  PRD / Figma
      |
      v
  /potenlab:plan-project       1. Create all plans from PRD
      |
      v
  /potenlab:complete-plan      2. Generate progress.json task tracker
      |
      v
  /potenlab:execute-phase 0    3. Build each phase (parallel agents)
  /potenlab:execute-phase 1        Phase 0: Foundation
  /potenlab:execute-phase 2        Phase 1: Backend
  /potenlab:execute-phase 3        Phase 2: Shared UI
  /potenlab:execute-phase 4        Phase 3: Features
  /potenlab:execute-phase 5        Phase 4: Integration
      |                            Phase 5: Polish
      v
  /potenlab:developer          4. Post-completion adjustments
      |
      v
  /potenlab:security-review    5. Security audit + optional auto-fix

Need to revise plans? Use /potenlab:review-plan at any point. Need to fix security issues later? Use /potenlab:security-resolve.

Step 1: Plan — /potenlab:plan-project

Creates all project plans from a PRD file. Asks clarifying questions first, then orchestrates 4 specialist agents sequentially and in parallel.

Agents spawned:

AskUserQuestion (validate scope, stack, UI priority)
      |
      v
potenlab-ui-ux-specialist       --> docs/ui-ux-plan.md
      |
      v
potenlab-tech-lead-specialist   --> docs/dev-plan.md
      |
      v
potenlab-frontend-specialist ──┐
                               ├──> parallel
potenlab-backend-specialist  ──┘
      |
      v
docs/frontend-plan.md + docs/backend-plan.md

Step 2: Complete — /potenlab:complete-plan

Generates progress.json from the finalized plans. Classifies every task as low or high complexity and assigns the right coder agent.

Output: docs/progress.json with all tasks, dependencies, and agent assignments.

Step 3: Execute — /potenlab:execute-phase

Builds a specific phase by spawning multiple coder agents in parallel.

/potenlab:execute-phase 0        # Foundation
/potenlab:execute-phase 1        # Backend
/potenlab:execute-phase 2        # Shared UI
/potenlab:execute-phase 3        # Features
/potenlab:execute-phase 4        # Integration
/potenlab:execute-phase 5        # Polish

Agent assignment:

• complexity: "low" tasks --> potenlab-small-coder (Sonnet, fast)
• complexity: "high" tasks --> potenlab-high-coder (Opus, deep reasoning)

Step 4: Adjust — /potenlab:developer

Handles changes after all phases are complete. Tracks everything in changes.json.

/potenlab:developer fix the login button hover state
/potenlab:developer add dark mode toggle

Revise Plans — /potenlab:review-plan

Edit existing plans based on feedback. Same agent flow as planning but in edit mode.

/potenlab:review-plan change auth to OAuth
/potenlab:review-plan add a notifications feature

Testing

/potenlab:generate-test          # Generate .test.ts files from test-plan.md
/potenlab:run-test-all           # Run all Vitest tests
/potenlab:run-test-phase 1       # Run tests for a specific phase
/potenlab:verify-test            # Sync tests after code changes

Security