gitnexus-plan

Generates implementation-ready engineering plans from GitNexus graph intelligence, PDG analysis, and source verification.

1|Updated Jul 27, 2023
One-click install
npx skills add https://github.com/AlexTheGuitarGuy/.dotfiles --skill gitnexus-plan-alextheguitarguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gitnexus-plan
Source: https://github.com/AlexTheGuitarGuy/.dotfiles/tree/main/claude/.claude/skills/gitnexus-plan
Command: npx skills add https://github.com/AlexTheGuitarGuy/.dotfiles --skill gitnexus-plan-alextheguitarguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Planning a non-trivial code change requires understanding execution flows, blast radius, and statement-level dependencies across a repository, which is slow and error-prone when done by hand. This Skill automates that investigation and produces a 13-section implementation-ready plan document that a follow-up implementation agent can execute without re-investigating the repository. ## Core Features & Use Cases - Graph-guided investigation: Uses GitNexus query, context, impact, and trace tools plus statement-level Program Dependence Graph slices to locate the symbols, callers, and tests a change touches. - Verified, provenance-pinned plans: Every cited claim is source-verified and pinned to a commit plus a versioned dirty-tree evidence digest, with claims tagged as verified, graph, inferred, or assumed. - Machine-readable context pack: Section 11 of each plan is a structured implementation context pack consumed by executor agents, and a Deepen mode strengthens existing plans in place through a descriptor-anchored safe reader/writer. - Use Case: Run "/gitnexus-plan Add retry support to the ingestion pipeline" to receive a dated plan under docs/plans/ with proposed changes, test scenarios, risks, and verification commands. ## Quick Start Ask the agent to run gitnexus-plan for your task, for example: create an implementation plan for fixing the stale warm-cache invalidation bug in exportedTypeMap.

Frequently Asked Questions about gitnexus-plan

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

FAQPage Schema
How do I generate an implementation plan for a code change?▼

Invoke /gitnexus-plan followed by a task description, such as "/gitnexus-plan Add retry support to the ingestion pipeline". The skill classifies the task, investigates the repository through GitNexus and source reads, and writes a dated plan document under docs/plans/.

What is GitNexus and does this skill require it?▼

GitNexus is a repository knowledge-graph index that answers where code lives and what is connected. The skill works best with an index, but falls back to targeted grep and read exploration with findings labelled source-derived when GitNexus is unavailable.

Can gitnexus-plan modify my source code?▼

No, the skill is planning-only by contract. The only repository file it writes is the plan document under docs/plans/, and the only other permitted state change is an index refresh via analyze --index-only, which touches only the .gitnexus store.

How do I strengthen or update an existing plan?▼

Use Deepen mode with "/gitnexus-plan deepen docs/plans/<plan>.md". It re-runs freshness checks, re-verifies claims against current source, reconciles any landed execution commits, and rewrites the same file through a digest-checked safe writer.

What happens when the GitNexus index is stale?▼

Full-plan categories default to strict freshness and refresh a stale index once with analyze --index-only before relying on the graph. Compact categories accept the stale graph with source verification weighted higher, and staleness is disclosed in the plan header.

What are the limitations of the PDG analysis?▼

The pdg_query tool is intra-procedural, so cross-function flow comes from explain taint analysis or inter-procedural impact reach. If the PDG layer is unavailable, the plan states so and skips statement-level claims rather than fabricating edges.