dev-plan

Orchestrate GitHub issue planning with design reviews, threat models, and documentation.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill dev-plan-learnzdevelopmenthub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-plan
Source: https://github.com/learnzdevelopmenthub/paadhai/tree/main/.claude/skills/dev-plan
Command: npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill dev-plan-learnzdevelopmenthub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning GitHub issues can skip crucial design reviews, threat modeling, and documentation, so this Skill enforces a 17-step, config-aware checklist that guarantees every plan honors security, version, and branch expectations before implementation begins.

Core Features & Use Cases

  • Structured Context Gathering: Detects feature or fix branches, pulls issue metadata, loads .paadhai.json, and tracks progress through every planning step so nothing is missed.
  • Design, Security, and Version Reviews: Guides brainstorming questions, design alignment investigations, and threat modeling while validating dependency versions before work starts.
  • Deliverable Docs & Handoff: Produces docs/plans/issue-<n>/plan.md and implementation.md, triggers ADRs when needed, and commits the artifacts to share a ready-to-implement plan with reviewers.

Quick Start

Run /dev-plan on your feature or fix branch after loading the repo to generate the issue plan and implementation documents.

Frequently Asked Questions about dev-plan

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

FAQPage Schema
How do I generate implementation docs and threat models for GitHub issues?▼

To generate implementation docs and threat models for GitHub issues, use a config-driven planning workflow that synthesizes brainstorming, design reviews, and security assessments into structured handoff artifacts before coding begins.

What is included in a config-driven issue planning workflow?▼

A config-driven issue planning workflow includes detecting feature branches, pulling issue metadata, validating dependency versions, running design alignment investigations, and producing structured plan and implementation documents for reviewer handoff.

How do I ensure my feature branch passes security assessment before implementation?▼

Ensure your feature branch passes security assessment by applying a structured checklist that enforces threat modeling, validates dependency versions, and requires design review documentation before writing any implementation code.

Does this issue planning workflow require specific repository configuration files?▼

Yes, this issue planning workflow requires loading repository configuration files like `.paadhai.json` to ensure the generated plans comply with config-driven build, lint, and test commands specific to your project environment.

Where are the generated plan and implementation documents stored in the repository?▼

The generated plan and implementation documents are stored as structured markdown files within the `docs/plans/issue-<n>/` directory, automatically committing the artifacts to share ready-to-implement plans with reviewers.

When should I run an issue planning workflow on my repository branch?▼

You should run an issue planning workflow after loading the repository and checking out a feature or fix branch, ensuring all design reviews and threat models are completed before any coding starts.