Help us improve
Share bugs, ideas, or general feedback.
From popkit-dev
Orchestrates development workflows via task descriptions, issues (work #N), or subcommands (brainstorm, plan, execute, prd, suite); auto-routes to quick 5-step or full 7-phase processes with mode/provider flags.
npx claudepluginhub jrc1883/popkit-ai --plugin popkit-devHow this command is triggered — by the user, by Claude, or both
Slash command
/popkit-dev:dev [subcommand|description] [flags]The summary Claude sees in its command listing — used to decide when to auto-load this command
# /popkit-dev:dev - Development Workflows Unified entry point for development workflows. **Intelligent routing:** Auto-selects quick (5-step) or full (7-phase) workflow. ## Usage ## Subcommands | Subcommand | Description | Use Case | | ------------ | -------------------- | -------------------- | | `work #N` | Issue-driven dev | GitHub issue | | `brainstorm` | Socratic questioning | Unclear requirements | | `plan` | Implementation plan | Planning | | `execute` | Execute plan | Implementation | | `prd` | G...
/planTransforms feature descriptions, bug reports, or improvement ideas into well-structured markdown project plans following conventions.
/devteam-planConducts interactive requirements gathering, researches codebase, creates PRD, and generates development plan with tasks and sprints. Supports spec files, folders, and auto-detection.
/feature-planningGuides feature planning workflow: gathers description/reqs interactively, generates PRD/SDD, creates planning dir, outputs TASKS.json/MD.
/makeCreates structured implementation plan in docs/plans/yyyymmdd-<task-name>.md for described feature or task via interactive context gathering and focused questions.
/create_planCreates detailed implementation plans interactively by researching tickets, task descriptions, and codebase using specialized analysis agents.
/plannewCreates new development plan from scratch using feature/project description. Enters plan mode, enforces TDD/DRY/SOLID principles, sets up tasks with strict rules.
Share bugs, ideas, or general feedback.
Unified entry point for development workflows.
Intelligent routing: Auto-selects quick (5-step) or full (7-phase) workflow.
/popkit-dev:dev "add dark mode" # Auto-routed
/popkit-dev:dev work #123 # Issue-driven
/popkit-dev:dev brainstorm # Idea refinement
/popkit-dev:dev plan "feature" # Write plan
/popkit-dev:dev execute # Run plan
/popkit-dev:dev "task" --mode quick # Override
/popkit-dev:dev "task" --provider feature-dev
| Subcommand | Description | Use Case |
|---|---|---|
work #N | Issue-driven dev | GitHub issue |
brainstorm | Socratic questioning | Unclear requirements |
plan | Implementation plan | Planning |
execute | Execute plan | Implementation |
prd | Generate PRD | Requirements |
suite | Full doc suite | Complete docs |
| Mode | When | Process |
|---|---|---|
quick | Simple, clear | 5 steps: Understand → Find → Fix → Verify → Commit |
full | Complex | 7 phases: Discovery → Exploration → Questions → Architecture → Impl → Review → Summary |
Override: --mode quick|full
| Flag | Short | Description |
|---|---|---|
--mode | quick or full | |
--provider | auto, popkit, feature-dev | |
--thinking | -T | Extended thinking |
--think-budget N | Token budget (10000) | |
--from FILE | From design/plan | |
--issue N | Reference issue | |
--power | -p | Power Mode |
--solo | -s | Sequential |
Quick: Simple, greenfield, few files Full: Complex, architecture, multi-domain
Details: commands/examples/dev/routing-examples.md
--provider auto (default) uses first-principles resolution:
Use explicit overrides for experimentation:
--provider popkit - force native PopKit orchestration--provider feature-dev - force upstream workflow (fallback to PopKit if unavailable)Implementation references:
packages/shared-py/popkit_shared/utils/dev_provider_resolver.pypackages/shared-py/popkit_shared/utils/dev_workflow_router.pyquick|full|work)Before executing implementation steps, run the provider preflight:
python packages/shared-py/popkit_shared/utils/dev_workflow_router.py \
--task "<description>" \
--mode <quick|full> \
--provider <auto|popkit|feature-dev> \
[--issue N] \
--format display
Then route execution using preflight output:
feature-dev, run /popkit:feature-dev and keep the printed fallback_command ready.popkit, continue native /popkit-dev:dev ... --provider popkit flow.7-phase workflow.
| Phase | Goal | Agent/Skill |
|---|---|---|
| 1. Discovery | What to build | pop-brainstorming |
| 2. Exploration | Understand code | code-explorer |
| 3. Questions | Clarify | pop-project-templates |
| 4. Architecture | Design | code-architect |
| 5. Implementation | Build | pop-writing-plans, pop-executing-plans |
| 6. Review | Quality | code-reviewer |
| 7. Summary | Complete | pop-finish-branch |
Details: commands/examples/dev/full-mode-walkthrough.md
Issue-driven with Power Mode.
/popkit-dev:dev work #57 -p
CRITICAL: Always present next actions (Issue #118)
Details: commands/examples/dev/work-mode-completion.md
Socratic design refinement via pop-brainstorming.
Details: commands/examples/dev/brainstorm-session.md
Implementation plans via pop-writing-plans.
Details: commands/examples/dev/plan-structure.md
Batch execution via pop-executing-plans.
/popkit-dev:dev execute --batch-size 5 --start-at 4
Details: commands/examples/dev/execute-batch-flow.md
5-step minimal ceremony.
/popkit-dev:dev "fix timezone bug"
| Task Type | Checks |
|---|---|
| Animations/Physics | Energy, collision |
| UI Components | A11y, responsive |
| API Endpoints | Validation, security |
| Data Processing | Edge cases, perf |
| Bug Fixes | Regression, root cause |
Details: commands/examples/dev/quick-mode-examples.md
Generate PRD with Summary, Problem, Goals, Requirements (P0/P1/P2), Stories, Tech, Risks.
Generate complete docs:
| Document | Location | Purpose |
|---|---|---|
problem_statement.md | docs/discovery/ | Problem |
PRD.md | docs/prd/ | Requirements |
user_stories.md | docs/prd/ | Stories |
ARCHITECTURE.md | docs/architecture/ | Design |
TECHNICAL_SPEC.md | docs/architecture/ | Tech details |
# Provider preflight (Issue #218)
python packages/shared-py/popkit_shared/utils/dev_workflow_router.py --task "<description>" --mode <quick|full> --provider <auto|popkit|feature-dev> --format display
# Full
Use Task tool (Explore|Plan|code-reviewer)
git worktree add .worktrees/feature-<name> -b feature/<name>
# Work
gh issue view <number> --json number,title,body,labels,state,author
# Skills
Use Skill tool (pop-brainstorming|pop-writing-plans|pop-executing-plans)
| Old | New |
|---|---|
/popkit:design | /popkit-dev:dev brainstorm |
/popkit:plan | /popkit-dev:dev plan |
/popkit:feature-dev | /popkit-dev:dev full |
/popkit-dev:git - Version control/popkit-dev:issue - Issue management/popkit-dev:worktree - Worktree management/popkit-core:power - Multi-agent orchestration