pharaoh-trace

Trace upstream and downstream relationships across needs and linked artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traces and analyzes how needs, specifications, implementations, tests, and code relate, helping teams understand impact and coverage in Sphinx-needs projects.

Core Features & Use Cases

  • Upstream and downstream trace of needs and links across the project graph
  • Support for standard links, extra_links, and sphinx-codelinks to surface complete traceability
  • Gap highlighting and cross-project awareness for multi-project configurations

Quick Start

Trace a target need to view its complete upstream and downstream trace.

Frequently Asked Questions about pharaoh-trace

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

FAQPage Schema
How do I trace upstream and downstream needs in Sphinx projects?

To trace upstream and downstream needs in Sphinx projects, you navigate traceability across needs and their linked artifacts to reveal relationships. This process builds an indexed graph of standard links, extra links, and code links to surface complete traceability.

What is traceability analysis for Sphinx-needs specifications?

Traceability analysis for Sphinx-needs specifications is the process of tracking how needs, implementations, tests, and code relate. It helps teams understand impact and coverage by mapping upstream and downstream relationships across the project graph.

Can I trace links across multiple Sphinx-needs projects?

Yes, you can trace links across multiple Sphinx-needs projects. The traceability navigation supports multi-project configurations, allowing you to track cross-project awareness and apply optional depth or type filters to the results.

Does Sphinx-needs traceability support sphinx-codelinks?

Yes, Sphinx-needs traceability supports sphinx-codelinks. It applies to projects that use standard links, extra links, and sphinx-codelinks to surface complete traceability between requirements and the actual code artifacts.

How do I find coverage gaps in Sphinx-needs linked artifacts?

To find coverage gaps in Sphinx-needs linked artifacts, you trace a target need to view its complete upstream and downstream trace. The resulting structured tree highlights gaps and uses edge labels with status markers to indicate missing links.

What happens if there are circular dependencies in Sphinx-needs traceability?

If there are circular dependencies in Sphinx-needs traceability, the navigation system detects and handles cycles within the indexed needs and link graphs. This prevents infinite loops and ensures a structured tree with edge labels and status markers is still presented.