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.