One-click install
npx skills add https://github.com/EliasOulkadi/shokunin --skill plan-eliasoulkadi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/EliasOulkadi/shokunin/tree/main/.pack/skills/plan
Command: npx skills add https://github.com/EliasOulkadi/shokunin --skill plan-eliasoulkadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The plan skill helps you avoid jumping straight into implementation by structuring how to explore an unfamiliar codebase and produce a concrete, reviewable implementation strategy.

Core Features & Use Cases

  • Codebase-first planning: Uses research agents to map existing patterns, conventions, and related features before proposing changes.
  • Trade-off aware design: Considers multiple approaches and their trade-offs, then selects one recommended direction.
  • Safety guardrails for the planning phase: Ensures no files are written or edited during planning (read-only exploration), and produces a scan-friendly final plan with verification steps.
  • Use Case: Before adding a new feature or doing a substantial refactor, generate a Phase 1–4 plan so you know exactly what to change and how to test it.

Quick Start

Use the plan skill via spawn_subagent with skill='plan' to generate an implementation plan for the codebase without writing any code.

Frequently Asked Questions about plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan before refactoring an unfamiliar codebase?

An implementation plan maps existing codebase patterns and architectural conventions using read-only research agents, then proposes a trade-off aware design strategy with verification steps before any code changes are made.

What is the best way to design a feature without modifying existing code during exploration?

A read-only planning phase uses research agents for codebase exploration and design agents to produce a reviewable implementation strategy, ensuring no files are written or edited during the discovery process.

How do I map architectural patterns and edge cases before starting a complex software refactor?

Deploy up to three research agents to explore the target codebase and map architectural patterns, followed by design agents that identify edge cases and align the final review with your original request.

Can I generate a trade-off analysis for different implementation approaches before coding?

Yes, design agents consider multiple approaches and their trade-offs, then select one recommended direction to include in your implementation plan before any coding begins.

Does the planning process support technical documentation and architecture decisions?

Yes, the planning process produces a scan-friendly final plan that captures architectural patterns, trade-offs, and verification steps, directly supporting technical documentation and architecture decisions.

When should I avoid jumping straight into implementation for a new feature?

You should avoid jumping straight into implementation when adding a new feature or doing a substantial refactor where scope and edge cases must be understood, generating a structured plan instead.