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.