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.