{"id":49074798,"url":"https://github.com/useblocks/pharaoh","last_synced_at":"2026-04-20T09:35:17.656Z","repository":{"id":349843458,"uuid":"1156074338","full_name":"useblocks/pharaoh","owner":"useblocks","description":"Agentic AI framework for sphinx-needs projects","archived":false,"fork":false,"pushed_at":"2026-04-19T17:12:10.000Z","size":267,"stargazers_count":5,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T18:35:06.925Z","etag":null,"topics":["ai","sphinx","sphinx-needs","ubc","ubcode"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/useblocks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T08:25:38.000Z","updated_at":"2026-04-17T14:15:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/useblocks/pharaoh","commit_stats":null,"previous_names":["patdhlk/pharaoh","useblocks/pharaoh"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/useblocks/pharaoh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/useblocks%2Fpharaoh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/useblocks%2Fpharaoh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/useblocks%2Fpharaoh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/useblocks%2Fpharaoh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/useblocks","download_url":"https://codeload.github.com/useblocks/pharaoh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/useblocks%2Fpharaoh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32041717,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","sphinx","sphinx-needs","ubc","ubcode"],"created_at":"2026-04-20T09:35:14.287Z","updated_at":"2026-04-20T09:35:17.644Z","avatar_url":"https://github.com/useblocks.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pharaoh\n\nAI assistant framework for [sphinx-needs](https://sphinx-needs.readthedocs.io/) projects. Pharaoh combines structured development workflows with requirements engineering intelligence to help teams author, analyze, trace, and validate requirements using AI.\n\nPharaoh has no runtime binary or Python package. All analysis logic is encoded in skill/agent markdown instructions. The AI is the runtime.\n\n## Quick Start\n\n### Claude Code\n\n```bash\n# Install the plugin\n/plugin install pharaoh\n\n# Run setup to detect your project and generate pharaoh.toml\n/pharaoh:setup\n\n# Analyze the impact of a change\n/pharaoh:change REQ_001\n\n# Check for traceability gaps\n/pharaoh:mece\n```\n\n### GitHub Copilot\n\n```\n# Run setup to scaffold agents into your project\n@pharaoh.setup\n\n# Analyze the impact of a change\n@pharaoh.change REQ_001\n\n# Check for traceability gaps\n@pharaoh.mece\n```\n\n## Skills / Agents\n\n**Core workflow skills:**\n\n| Skill (Claude Code) | Purpose |\n|---------------------|---------|\n| `pharaoh:setup` | Scaffold Pharaoh into a project -- detect structure, generate `pharaoh.toml`, install Copilot agents |\n| `pharaoh:change` | Analyze impact of a change -- trace through needs links and codelinks, produce a Change Document |\n| `pharaoh:trace` | Navigate traceability in any direction -- show everything linked to a need across all levels |\n| `pharaoh:mece` | Gap and redundancy analysis -- find orphans, missing links, MECE violations |\n| `pharaoh:release` | Release management -- changelog from requirements, traceability coverage metrics |\n| `pharaoh:plan` | Structured implementation planning -- break changes into tasks with workflow enforcement |\n| `pharaoh:spec` | Generate spec from requirements -- read needs hierarchy, record decisions, produce spec with plan table |\n| `pharaoh:decide` | Record design decisions -- create `decision` needs with alternatives, rationale, and traceability links |\n\n**Atomic authoring and review chain:**\n\n| Skill (Claude Code) | Purpose |\n|---------------------|---------|\n| `pharaoh:req-draft` | Draft a single requirement directive with ID, status, and shall-clause body |\n| `pharaoh:req-review` | Audit a requirement against ISO 26262-8 §6 axes -- per-axis findings with action items |\n| `pharaoh:req-regenerate` | Regenerate a requirement to address findings from req-review |\n| `pharaoh:arch-draft` | Draft a single architecture element directive from a parent requirement |\n| `pharaoh:arch-review` | Audit an architecture element against ISO 26262-8 §6 axes |\n| `pharaoh:vplan-draft` | Draft a test-case directive linking to a parent requirement |\n| `pharaoh:vplan-review` | Audit a test case against ISO 26262-8 §6 axes plus vplan-specific axes |\n| `pharaoh:fmea` | Derive a failure-mode entry (FMEA/DFA row) from a requirement or architecture element |\n| `pharaoh:flow` | Orchestrate the full V-model chain (req → arch → vplan → fmea) for one feature context |\n\n**Analysis and audit skills:**\n\n| Skill (Claude Code) | Purpose |\n|---------------------|---------|\n| `pharaoh:coverage-gap` | Detect one gap category (orphan / unverified / duplicate / ...) in a corpus |\n| `pharaoh:process-audit` | Full-corpus audit across all gap categories with prioritized findings |\n| `pharaoh:lifecycle-check` | Verify artefact lifecycle state and legality of a state transition |\n| `pharaoh:standard-conformance` | Evaluate an artefact against a regulatory standard (ISO 26262-8, ASPICE 4.0, ISO/SAE 21434) |\n\n**Tailoring skills:**\n\n| Skill (Claude Code) | Purpose |\n|---------------------|---------|\n| `pharaoh:tailor-detect` | Inspect a project and emit detected conventions for tailoring |\n| `pharaoh:tailor-fill` | Author `.pharaoh/project/` tailoring files from detected conventions |\n| `pharaoh:tailor-review` | Audit tailoring files against schemas and cross-file consistency |\n\n## Workflow\n\n```\npharaoh:spec   -\u003e pharaoh:decide (for gaps)\n               -\u003e produces spec doc with plan table\n                    |\npharaoh:plan   -\u003e pharaoh:change -\u003e pharaoh:req-draft  -\u003e pharaoh:req-review  -\u003e pharaoh:release\n                                 -\u003e pharaoh:arch-draft -\u003e pharaoh:arch-review\n                                 -\u003e pharaoh:vplan-draft -\u003e pharaoh:vplan-review\n                                 -\u003e pharaoh:fmea\n                                 -\u003e pharaoh:mece   (optional, for gap analysis)\n                                 -\u003e pharaoh:trace  (optional, for exploration)\n```\n\n## Experience Tiers\n\nPharaoh works with just the AI reading files. Install additional tools for a better experience.\n\n| Tier | What's installed | Experience |\n|------|-----------------|------------|\n| Basic | Pharaoh only | AI reads RST/MD files directly. Works everywhere, slower on large projects. |\n| Good | + [ubc CLI](https://ubcode.useblocks.com/ubc/installation.html) | Fast deterministic indexing, JSON output, CI/CD compatible. |\n| Best | + ubc CLI + [ubCode extension](https://ubcode.useblocks.com/) | Real-time indexing, MCP integration, live validation, full schema checks. |\n\n## Configuration\n\n### `pharaoh.toml`\n\nOptional. Controls Pharaoh's workflow behavior. Without this file, advisory mode applies with sensible defaults.\n\n```toml\n[pharaoh]\nstrictness = \"advisory\"  # \"advisory\" (default) | \"enforcing\"\n\n[pharaoh.id_scheme]\npattern = \"{TYPE}-{MODULE}-{NUMBER}\"\nauto_increment = true\n\n[pharaoh.workflow]\nrequire_change_analysis = true\nrequire_verification = true\nrequire_mece_on_release = false\n\n[pharaoh.traceability]\nrequired_links = [\n    \"req -\u003e spec\",\n    \"spec -\u003e impl\",\n    \"impl -\u003e test\",\n]\n\n[pharaoh.codelinks]\nenabled = true\n```\n\nSee [`pharaoh.toml.example`](pharaoh.toml.example) for a fully commented template.\n\n### Advisory vs Enforcing Mode\n\n- **Advisory** (default): Skills suggest the recommended workflow but never block. Tips are shown for skipped steps.\n- **Enforcing**: Skills check prerequisites and block if not met. For example, authoring skills (e.g. `pharaoh:req-draft`) require `pharaoh:change` to be run and acknowledged first.\n\n### Project Configuration\n\nPharaoh reads need types, link types, and ID settings from your existing sphinx-needs configuration:\n- `ubproject.toml` (preferred) -- the `[needs]` section\n- `conf.py` (fallback) -- `needs_types`, `needs_extra_links`, etc.\n\nPharaoh never re-defines these settings. `pharaoh.toml` only controls Pharaoh's own behavior on top.\n\n## sphinx-codelinks Support\n\nWhen a project uses [sphinx-codelinks](https://sphinx-codelinks.useblocks.com/), Pharaoh follows codelink references in change analysis and traceability. A change to a requirement surfaces affected code files, not just other requirements.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuseblocks%2Fpharaoh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fuseblocks%2Fpharaoh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fuseblocks%2Fpharaoh/lists"}