pharaoh-spec

Generate a spec and plan document from sphinx-needs requirements.

24|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/useblocks/pharaoh --skill pharaoh-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pharaoh-spec
Source: https://github.com/useblocks/pharaoh/tree/main/skills/pharaoh-spec
Command: npx skills add https://github.com/useblocks/pharaoh --skill pharaoh-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a self-contained specification and plan document from one or more sphinx-needs requirements, bridging the gap between what needs to implement and how to implement it. It maps downstream coverage, identifies gaps, records design decisions via pharaoh:decide, and outputs a plan-ready document that feeds into pharaoh:plan.

Core Features & Use Cases

  • Generate a combined spec and plan document from multiple sphinx-needs requirements.
  • Pull full requirement text for the root needs while providing reference-style downstream coverage.
  • Identify gaps in downstream coverage and record design decisions for traceability.
  • Produce a plan table that can be executed by pharaoh:plan.
  • Output location: docs/superpowers/specs/ with sections for requirements, coverage, gaps, decisions, and plan.

Quick Start

Provide one or more sphinx-needs requirement IDs to generate a combined spec and plan document ready for review.

Frequently Asked Questions about pharaoh-spec

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

FAQPage Schema
How do I generate a specification and plan from sphinx-needs requirements?▼

You can generate a combined spec and plan document by providing one or more sphinx-needs requirement IDs, which pulls full requirement text, identifies coverage gaps, records design decisions, and outputs a plan-ready document.

What is requirements traceability and how does it connect to plan generation?▼

Requirements traceability tracks downstream coverage from root needs to implementation, identifying gaps and recording design decisions to produce a plan-ready document ensuring end-to-end alignment between specifications and execution.

How do I identify gaps in downstream coverage for my requirements?▼

Identifying gaps in downstream coverage involves mapping your sphinx-needs requirements against existing implementations, highlighting missing areas, and recording design decisions to ensure full traceability before generating a plan.

Can I record design decisions alongside requirement specifications for traceability?▼

Yes, you can record design decisions alongside requirement specifications using the pharaoh:decide mechanism, ensuring every gap and coverage choice is documented for full traceability within the generated plan document.

Does this work with sphinx-needs to map requirements to a plan table?▼

Yes, it works directly with sphinx-needs by pulling full requirement text for root needs and producing a plan table that maps downstream coverage, which can then be executed by pharaoh:plan.

What are the limitations of generating a combined spec and plan document from multiple requirements?▼

The main limitation is that generating a combined spec and plan document requires existing sphinx-needs requirement IDs as input; without properly defined root needs, the downstream coverage mapping and plan generation cannot function.