pp-spec

Generates functional specifications through multi-agent requirements gathering and iterative review cycles.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill pp-spec-ohmyhotelco
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pp-spec
Source: https://github.com/ohmyhotelco/hare-cc-plugins/tree/main/planning-plugin/skills/pp-spec
Command: npx skills add https://github.com/ohmyhotelco/hare-cc-plugins --skill pp-spec-ohmyhotelco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a complete, review-ready functional specification before implementation is slow and error-prone. This Skill automates the process by coordinating analyst, planner, tester, and translator agents to gather requirements, draft spec documents, and iterate through scored review cycles until the spec converges. ## Core Features & Use Cases - Structured Requirements Gathering: An analyst agent analyzes project context and asks questions across 8 categories, scoring completeness until it reaches a threshold. - Iterative Review Cycles: Planner and tester agents review the draft spec sequentially with convergence scoring (scores >= 8 or up to 3 rounds per cycle), and every accepted issue is verified before finalization. - Multilingual Output & Notion Sync: Generates the spec in a working language, translates it to target languages (en/ko/vi) via parallel translator agents, and optionally syncs pages to Notion. - Use Case: A product manager starting a new "social login" feature runs the Skill, answers structured questions, and receives a finalized multi-file spec (overview, screens with ASCII layouts, test scenarios) ready for downstream design and code generation. ## Quick Start Ask the assistant to create a functional specification for your new feature, for example by describing the feature you want to build.

Frequently Asked Questions about pp-spec

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

FAQPage Schema
How do I generate a functional specification for a new feature?▼

Run the pp-spec skill with a feature description. An analyst agent gathers requirements through structured questions across 8 categories, then drafts spec files that planner and tester agents review in scored cycles until convergence.

What files does a functional specification generator produce?▼

It produces three markdown files per language: a spec overview with user stories and functional requirements, a screens file with ASCII layout diagrams and error handling, and a test-scenarios file covering NFRs and test cases.

Can I resume an interrupted specification workflow?▼

Yes. The skill writes a progress JSON file under docs/specs/{feature}/.progress/ tracking status, review rounds, and translation sync state. When the feature directory already exists, it asks whether to resume or start fresh.

Does the spec generator support multiple languages?▼

Yes. It reads workingLanguage and supportedLanguages from .claude/planning-plugin.json, writes the spec in the working language, and launches parallel translator agents for target languages such as Korean and Vietnamese.

Why does the skill refuse to finalize my spec after one review round?▼

Finalization requires both planner and tester scores of at least 8, or a minimum of 3 rounds in the current review cycle. This hard rule prevents premature sign-off, and a verification gate also confirms every accepted suggestion was actually applied.