skills.rest
masa-codehub
masa-codehubCOMMUNITY
Explore all skills by this author →
GitHub

planning-specs

Analyze design docs and ADRs to create PR-ready specification plans.

Updated Aug 18, 2025
Search Tags:#planning#tdd#specification#audit#issues#pull-request#design-docs
One-click install
npx skills add https://github.com/masa-codehub/gemini_agent --skill planning-specs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: planning-specs
Source: https://github.com/masa-codehub/gemini_agent/tree/main/.gemini/skills/planning-specs
Command: npx skills add https://github.com/masa-codehub/gemini_agent --skill planning-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Spec planning is a complex, multi-step process that ensures teams align on requirements, definitions, and acceptance criteria before coding. This skill coordinates design-doc analysis, common definition creation, task slicing, and plan submission to remove ambiguity and accelerate delivery.

Core Features & Use Cases

  • Orchestrates goal setting, preparation, and plan submission to streamline specification work.
  • Creates common definitions and task slices to enable consistent implementation and testing.
  • Drafts integration and main-line PR plans for approval and auditing.

Quick Start

Run the planning-specs workflow to initiate goal setting and plan submission.

Frequently Asked Questions about planning-specs

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

FAQPage Schema
How do I plan specification work from design docs and ADRs?▼

Spec planning analyzes design docs, architecture plans, and ADRs to set clear goals, creates common definitions and task slices, and delivers a PR-ready plan with draft issues aligned with the roadmap.

What is the best way to draft integration and main-line PR plans for auditing?▼

Drafting PR plans for approval involves coordinating design-doc analysis and creating self-audit artifacts to consolidate definitions and task slices into a PR-ready submission.

How do I slice tasks and create common definitions before coding?▼

Task slicing and common definition creation are orchestrated during the preparation phase to remove ambiguity, enable consistent implementation, and prepare self-audit artifacts for approval.

Can I consolidate draft issues and definitions into a single plan for project roadmaps?▼

Yes, you can consolidate draft issues and common definitions into a single PR-ready plan that aligns with the project roadmap for streamlined specification work and accelerated delivery.

Does spec planning support TDD workflows and pull-request auditing?▼

Spec planning supports TDD workflows by preparing self-audit artifacts and task slices, and generates pull-request ready plans to facilitate integration and main-line auditing.

Related Skills

Explore More Product & Management Skills→
justincordovajustincordova
1

spec

Create and maintain a living project specification in docs/SPEC.md.

Community
Advanced
sunnypatneedisunnypatneedi
11

pr-checklist

Generate a tailored PR checklist from code diff changes.

Community
Basic
Agent-Pattern-LabsAgent-Pattern-Labs
4

github

Manage GitHub repositories, issues, pull requests, and CI workflows via the GitHub CLI.

Official
Intermediate
myrtlepnmyrtlepn
24

priority

Reorder project tasks and set before or after conditions.

Community
Intermediate