__ __
____ ____ / /______ _ __ ______ / /______ ___ __
/ __ \/ __ \/ //_/ __ `/ / / / / __ \/ //_/ __ `/ / / /
/ /_/ / /_/ / ,< / /_/ / / /_/ / /_/ / ,< / /_/ / /_/ /
/ .___/\____/_/|_|\__,_/ \__, /\____/_/|_|\__,_/\__, /
/_/ /____/ /____/
pokayokay
AI-assisted development orchestration - A Claude Code plugin that orchestrates AI-assisted development sessions with configurable human oversight, bridging the gap between hands-on control and full automation through skills, hooks, agents, and integration with ohno for task management.
Features
- PRD to Tasks - Automatically break down requirements into epics, stories, and tasks
- Orchestrated Sessions - Work across multiple sessions without losing context
- Human Checkpoints - Choose your autonomy level: supervised, semi-auto, auto, or unattended
- Multi-Dimensional Auditing - Verify accessibility, testing, security, docs, and observability
- 21 Specialized Skills - Route work to domain-specific workflows automatically
- Spike Protocol - Time-boxed investigations with mandatory decisions
Prerequisites
- Claude Code v1.0.0 or later
- Node.js v18 or later (for ohno CLI)
- Git (for version control integration)
Installation
The easiest way to install is with the setup wizard:
npx pokayokay
This interactive wizard will:
- Install the pokayokay Claude Code plugin
- Configure the ohno MCP server
- Initialize ohno in your project
- Optionally set up kaizen integration
Run npx pokayokay doctor anytime to verify your installation.
Manual Installation
Click to expand manual steps
# 1. Add the marketplace (one-time setup)
claude plugin marketplace add srstomp/pokayokay
# 2. Install the plugin
claude plugin install pokayokay@srstomp-pokayokay
Or from inside Claude Code REPL:
/plugin marketplace add srstomp/pokayokay
/plugin install pokayokay@srstomp-pokayokay
Required: ohno MCP Server
Add to your MCP configuration (~/.claude/settings.json):
{
"mcpServers": {
"ohno": {
"command": "npx",
"args": ["@stevestomp/ohno-mcp"]
}
}
}
Initialize ohno
npx @stevestomp/ohno-cli init
Quick Start
# 1. Run setup wizard (if not done already)
npx pokayokay
# 2. Restart Claude Code to activate MCP server
# 3. Plan from a PRD
/pokayokay:plan docs/prd.md
# 4. View kanban board
npx @stevestomp/ohno-cli serve
# 5. Start working
/pokayokay:work supervised
# 6. Audit completeness
/pokayokay:audit --full
Commands
Core Workflow
| Command | Description |
|---|
/pokayokay:plan [--headless] [--review] <path> | Analyze PRD and create tasks with skill routing |
/pokayokay:revise [--direct] | Revise existing plan with impact analysis |
/pokayokay:work [mode] [-n N] | Start/continue work session (supervised/semi-auto/auto/unattended) |
/pokayokay:audit [feature] | Audit feature completeness across 5 dimensions |
/pokayokay:review | Analyze session patterns and skill effectiveness |
/pokayokay:handoff | Prepare session handoff with context preservation |
/pokayokay:hooks | View and manage hook configuration |
/pokayokay:worktrees | List, cleanup, switch, or remove worktrees |
Ad-Hoc Work
| Command | Description |
|---|
/pokayokay:quick <task> | Create task and work inline (no agents) |
/pokayokay:fix [--thorough] <bug> | Bug fix with diagnosis + light pipeline (--thorough for full) |
/pokayokay:spike <question> | Time-boxed technical investigation |
/pokayokay:hotfix <incident> | Production incident response |
Development
| Command | Description |
|---|
/pokayokay:api <task> | API design - REST/GraphQL patterns |
/pokayokay:arch <area> | Architecture review and refactoring |
/pokayokay:db <task> | Database schema and migrations |
/pokayokay:test <task> | Testing strategy and implementation |
/pokayokay:integrate <api> | Third-party API integration |
/pokayokay:sdk <task> | SDK creation and extraction |
Infrastructure & Quality
| Command | Description |
|---|
/pokayokay:cicd <task> | CI/CD pipeline creation and optimization |
/pokayokay:security <area> | Security audit and vulnerability scanning |
/pokayokay:observe <task> | Logging, metrics, and tracing |
Research & Documentation
| Command | Description |
|---|
/pokayokay:research <topic> | Extended technical research |
/pokayokay:docs <task> | Technical documentation |
Skills
The plugin includes 21 specialized skills loaded on demand via commands or planner routing:
srstomp