pharaoh-trace

Map and analyze traceability across sphinx-needs projects with structured trace trees.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traces and visualizes how needs, specifications, implementations, tests, and code relate in sphinx-needs projects to reveal coverage and potential gaps and to support validation workflows.

Core Features & Use Cases

  • Build a bidirectional trace graph across standard links, extra_links, and sphinx-codelinks to reveal upstream and downstream relationships.
  • Detect and surface cycles and gaps, support multi-project contexts, and apply depth/type filters for scalable navigation.
  • Generate structured trace trees with edge labels and statuses to guide reviews and remediation in requirements engineering workflows.

Quick Start

Identify a target need and run a trace to display its upstream and downstream relationships across all configured link types.

Frequently Asked Questions about pharaoh-trace

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

FAQPage Schema
How do I trace requirements across needs, specifications, and tests in sphinx-needs?▼

Tracing requirements in sphinx-needs involves mapping a target need to build a bidirectional trace graph. This graph surfaces upstream and downstream relationships across standard links, extra_links, and codelinks to reveal coverage and gaps.

What is requirements traceability and how does graph analysis help identify coverage gaps?▼

Requirements traceability tracks relationships between needs, specifications, implementations, tests, and code. Graph analysis helps by building a structured trace tree with labeled edges and statuses to surface cycles, gaps, and coverage for validation workflows.

Can I filter traceability depth and link types when navigating sphinx-needs projects?▼

Yes, you can filter traceability depth and link types when navigating sphinx-needs projects. The trace supports optional depth and type filters, allowing scalable navigation across standard links, extra_links, and codelinks.

Does sphinx-needs traceability support multi-project contexts and cycle detection?▼

Yes, sphinx-needs traceability supports multi-project contexts and cycle detection. It reads project configuration like extra_links and pharaoh.toml to detect cycles, surface gaps, and emit a structured trace tree across project boundaries.

What is the best way to analyze downstream relationships from a requirement to code in sphinx-needs?▼

The best way to analyze downstream relationships from requirements to code is running a trace on a target need. It traverses configured sphinx-codelinks and extra_links to emit a structured trace tree showing labeled edges and statuses.