@pharaoh-so/mcp 0.3.0 → 0.3.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pharaoh-so/mcp",
   "mcpName": "so.pharaoh/pharaoh",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "MCP proxy for Pharaoh — maps codebases into queryable knowledge graphs for AI agents. Enables Claude Code in headless environments (VPS, SSH, CI) via device flow auth.",
   "type": "module",
   "main": "dist/index.js",

package/skills/audit-tests/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: audit-tests
+prompt-name: audit-tests
 description: "Classify tests by real value: ceremony versus protection. Mutation score over line coverage — tests that can't detect mutations are theater. Identify tests that prove nothing, tests that duplicate coverage, and gaps where real protection is missing. Produce an actionable audit with keep, rewrite, and delete verdicts."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/brainstorm/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: brainstorm
+prompt-name: brainstorm
 description: "Explore intent, requirements, and design before implementation. Collaborative dialogue to turn ideas into specs. Ask clarifying questions one at a time, propose 2-3 approaches with trade-offs, get approval before writing any code. Prevents wasted work from unexamined assumptions."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/debt/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: debt
+prompt-name: find-tech-debt
 description: "Categorized technical debt report using Pharaoh knowledge graph. Four-step pro-tier workflow: dead code detection, duplicate logic discovery, undocumented complex functions via spec gaps, and volatile high-complexity module identification. Categorizes findings as DELETE, CONSOLIDATE, DOCUMENT, STABILIZE, or TEST — each with the specific function or file, effort estimate, and risk of ignoring."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/debug/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: debug
+prompt-name: systematic-debugging
 description: "Systematic 4-phase debugging methodology. Root cause investigation before any fixes. Read errors carefully, reproduce consistently, trace data flow, form hypotheses, test minimally. If 3+ fixes fail, question the architecture. No guessing, no quick patches, no symptom fixes."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/execute/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: execute
+prompt-name: execute-plan
 description: "Execute a written implementation plan with review checkpoints. Load plan, review critically, execute tasks sequentially with verification at each step. Stop and ask when blocked — never guess through ambiguity. Finish with branch completion workflow."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/explore/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: explore
+prompt-name: explore-module
 description: "Deep-dive into a single codebase module using Pharaoh knowledge graph. Four-step free-tier workflow: full structure with functions, exports, and complexity scores; blast radius of what depends on it; upstream and downstream dependency mapping; and related function discovery. Produces a module briefing with purpose, key functions, dependencies, risk areas, and external API surface."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/finish/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: finish
+prompt-name: finish-branch
 description: "Complete a development branch after implementation. Verify all tests pass, present structured options (merge locally, create PR, keep branch, or discard), execute the chosen workflow, and clean up worktrees. Never merge broken code or delete work without confirmation."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/health/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: health
+prompt-name: health-check
 description: "Full codebase health sweep using Pharaoh knowledge graph. Six-step pro-tier workflow: module map with metrics, dead code detection, test coverage gaps, duplicate logic, regression risk scoring, and spec drift analysis. Produces an A-F grade, top 5 risks, tech debt hotspots (high-complexity + low-coverage + high-volatility intersections), spec drift summary, and prioritized actions with effort estimates."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/investigate/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: investigate
+prompt-name: investigate-change
 description: "Full architectural context gathering before modifying a function, file, or module using Pharaoh knowledge graph. Four-step free-tier workflow: module structure, blast radius of downstream callers, related function discovery, and dependency mapping. Blocks code suggestions until all context is gathered. Produces an investigation report with structure, blast radius, related functions, dependency context, and risk assessment."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/onboard/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: onboard
+prompt-name: onboard-to-codebase
 description: "Quick codebase orientation using Pharaoh knowledge graph. Five-step workflow using only free-tier tools: full module map, deep-dive into the three largest modules, entry point discovery, critical path blast radius, and core data flow mapping. Produces an onboarding summary with module descriptions, entry points, data flow, and key functions to read first."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/orchestrate/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: orchestrate
+prompt-name: orchestrate-plan
 description: "Execute implementation plans by dispatching one subagent per task with two-stage review (spec compliance then code quality). Sequential task execution with quality gates. Controller stays in session, constructs focused context for each agent, never shares session history. Handles DONE/DONE_WITH_CONCERNS/NEEDS_CONTEXT/BLOCKED status protocol."
 version: 0.2.5
 homepage: https://pharaoh.so

package/skills/parallel/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: parallel
+prompt-name: parallel-agents
 description: "Dispatch 2+ independent subagent tasks that run concurrently. Each agent gets focused scope, clear goal, constraints, and expected output. No shared state between agents. Review and integrate results after all complete."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/pharaoh/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: pharaoh
+prompt-name: pharaoh-core
 description: "Codebase knowledge graph — gives AI agents full architectural awareness. Query architecture, dependencies, blast radius, module context, and function search instead of reading files one at a time. Code intelligence via MCP: understand any codebase in seconds."
 version: 0.3.0
 homepage: https://pharaoh.so

package/skills/plan/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: plan
+prompt-name: plan-with-pharaoh
 description: "Full-cycle architecture-aware planning: Pharaoh reconnaissance, structured plan writing with bite-sized TDD steps and zero placeholders, then deep adversarial review with wiring verification and interactive issue resolution. Replaces both writing-plans and plan-review."
 version: 0.3.0
 homepage: https://pharaoh.so

package/skills/pr/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: pr
+prompt-name: pre-pr-review
 description: "Pre-pull-request architectural review checklist using Pharaoh codebase knowledge graph. Covers module context, blast radius per touched module, hidden coupling between modules, duplicate logic detection, regression risk scoring, and vision spec alignment. Produces a structured review summary before opening a PR."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/refactor/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: refactor
+prompt-name: safe-refactor
 description: "Safe refactoring workflow using Pharaoh codebase knowledge graph. Six-step process: module context, blast radius of downstream callers, reachability verification, dependency mapping, naming conflict detection, and test coverage assessment. Produces a refactoring plan with every caller listed, test files identified, unreachable code flagged, and high-risk paths warned."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/review/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: review
+prompt-name: review-with-pharaoh
 description: "Architecture-aware pre-PR code review using Pharaoh codebase knowledge graph. Four-phase workflow: context gathering with module structure and blast radius, risk assessment with regression scoring and wiring checks, spec alignment against vision docs, and a final verdict of SHIP / SHIP WITH CHANGES / BLOCK. Auto-block rules for unreachable exports, circular dependencies, high regression risk, and spec violations."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/review-codex/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: review-codex
+prompt-name: cross-model-review
 description: "Cross-model security review. Dispatch code to a different AI model or subagent for independent second-opinion review. Evaluator applies AGREE, DISAGREE, or CONTEXT verdicts to each finding. Catches blind spots from single-model reasoning. Use for security-sensitive code, auth flows, data access, and architectural decisions."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/review-receive/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: review-receive
+prompt-name: receive-code-review
 description: "Receive code review feedback with technical rigor. No performative agreement — verify suggestions against codebase reality before implementing. Push back with evidence when feedback is wrong. Clarify all unclear items before implementing any. External feedback is suggestions to evaluate, not orders to follow."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/sessions/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: sessions
+prompt-name: session-decomposition
 description: "Decompose work into parallel, isolated sessions using git worktrees. Each session gets fresh context, a narrow scope, and produces atomic commits. Prevents context window pollution from large tasks. Coordinate across sessions without shared state."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/tdd/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: tdd
+prompt-name: test-driven-development
 description: "Test-driven development discipline. Write the failing test first, watch it fail, write minimal code to pass, refactor. No production code without a failing test. No exceptions without explicit permission. Covers red-green-refactor cycle, common rationalizations, and when to start over."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/verify/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: verify
+prompt-name: verification
 description: "Evidence before assertions. Run verification commands and confirm output before claiming work is complete, fixed, or passing. No 'should work now' — run the command, read the output, then claim the result. Covers tests, builds, linting, agent delegation, and requirement checklists."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/wiring/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: wiring
+prompt-name: validate-wiring
 description: "Wiring validation for a codebase module using Pharaoh knowledge graph. Four-step pro-tier workflow: entry point reachability, caller verification via blast radius, test coverage per function, and dead code detection. Categorizes functions as CONNECTED, UNREACHABLE, DEAD, or UNTESTED. Produces a PASS or FAIL verdict with specific issues listed. Iron law: zero callers on a non-entry-point export means the code is not wired."
 version: 0.2.0
 homepage: https://pharaoh.so

package/skills/worktree/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: worktree
+prompt-name: git-worktree
 description: "Set up isolated git worktrees for feature work. Smart directory selection with safety verification — checks for existing worktree directories, verifies gitignore, auto-detects project setup, and confirms clean test baseline before starting. Prevents accidentally committing worktree contents."
 version: 0.2.0
 homepage: https://pharaoh.so