popkit-dev

work #N | brainstorm | plan | execute | prd | suite | "description" [--mode quick|full] [--provider auto|popkit|feature-dev] [-T, --power]

commit | push | pr | review | ci | release | publish | prune | finish [--draft, --squash]

create | list | view | close | comment | edit | link [--state, --label]

list | create | close | report | health [--json, --verbose]

[quick|verbose] - Analyze project state and recommend next actions

Designs feature architectures and implementation blueprints based on codebase patterns. Use during architecture phase when multiple implementation approaches exist and trade-offs need evaluation.

Deeply analyzes existing codebase features by tracing execution paths, data flow, and dependencies. Use during exploration phase of feature development or when understanding unfamiliar code.

Performs comprehensive code reviews focusing on TypeScript, React, and Node.js best practices. Use after implementing significant features or when code quality assessment is needed.

Code restructuring specialist focused on improving quality, maintainability, and performance without changing external behavior. Use for code smell detection, design pattern application, and systematic codebase improvements.

AI-powered merge conflict resolution with complexity-based prioritization and architectural intelligence. Detects conflicts, analyzes complexity, prioritizes resolution order, proposes intelligent fixes with reasoning, validates changes with tests. Use when git merge fails with conflicts.

Collaborative design refinement that transforms rough ideas into fully-formed specifications through Socratic questioning. Explores alternatives, validates incrementally, and presents designs in digestible chunks for feedback. Use before writing code or implementation plans when requirements are unclear or multiple approaches exist. Do NOT use when requirements are already well-defined, you're implementing a known pattern, or making small changes - proceed directly to implementation instead.

Enhanced changelog generation with semantic versioning, auto-categorization, and release notes. Parses conventional commits, determines version bump (MAJOR.MINOR.PATCH), categorizes changes by type, generates CHANGELOG.md updates, and creates GitHub release notes. Use before releases or on PR merge to automate version management.

Analyzes task/feature complexity (1-10) and recommends subtask breakdown for planning and prioritization. Provides actionable recommendations for agent selection, phase distribution, and risk assessment. Silent analysis that feeds into other workflows.

Use when you need to fully restore working context from a previous session - loads STATUS.json, reads key files, rebuilds mental model of current work state. Do NOT use for quick questions or when starting fresh unrelated work - the full context restoration adds overhead that isn't needed for standalone tasks.

Controlled batch execution of implementation plans with review checkpoints between phases. Loads plan, critically reviews for issues, executes tasks in batches, then pauses for architect feedback before continuing. Use when you have a complete implementation plan from brainstorming/writing-plans and want structured execution with quality gates. Do NOT use for ad-hoc implementation, exploratory coding, or when you don't have a formal plan - just implement directly with code review at the end.

1 hook across 1 event