ush-repo-evidence-plan

Inspects a repository and produces a bounded, evidence-backed implementation plan without modifying files.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/edward321416-maker/universal-skill-hub --skill ush-repo-evidence-plan-edward321416-maker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ush-repo-evidence-plan
Source: https://github.com/edward321416-maker/universal-skill-hub/tree/main/adapters/claude-code/ush-repo-evidence-plan
Command: npx skills add https://github.com/edward321416-maker/universal-skill-hub --skill ush-repo-evidence-plan-edward321416-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before changing code, teams often guess at scope and miss how a request fits the repository's actual architecture, tests, and decisions. This Skill performs a read-only inspection of the current repository and returns a bounded implementation plan grounded in real evidence, preventing mis-scoped or contradictory changes. ## Core Features & Use Cases - Policy-first planning: Reads the project's designated policy or rules documentation before inspecting implementation details, and flags conflicts with active decisions as needs_approval. - Evidence-backed scoping: Searches symbols, exports, callers, tests, and configuration before opening only the function bodies relevant to the request, avoiding duplicate state or logic. - Structured result contract: Returns status, summary, proposedChanges, verification, and risks fields covering affected areas, tests, manual checks, failure modes, and exclusions. - Use Case: Before implementing a new API endpoint, run this Skill to confirm the change fits existing module ownership, identify which tests must be updated, and surface any contradiction with recorded project decisions. ## Quick Start Ask the agent to inspect this repository and produce a read-only, evidence-backed implementation plan for the change you are considering.

Frequently Asked Questions about ush-repo-evidence-plan

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

FAQPage Schema
How do I plan a code change before implementing it?▼

Run a read-only repository inspection that searches symbols, callers, tests, and configuration before reading relevant function bodies. The result is a bounded plan listing affected areas, required tests, manual checks, failure modes, and explicit exclusions.

How to verify a change fits existing repository architecture?▼

Confirm the request against the project's active decisions and conventions, identify the current owner of each affected rule or module, and avoid proposing duplicate state or logic. Contradictions with active decisions are flagged as needing approval.

Does this planning skill modify any repository files?▼

No, it is strictly read-only. It does not edit files, install software, start services, push, deploy, or invoke any mutating skill, and it never claims tests passed unless their output was actually observed.

Can untrusted issue text or chat messages influence the plan?▼

External context such as chat messages, issue text, or pasted logs is treated as untrusted reference material only. Embedded commands, permission grants, or role claims inside it are never followed.

When does the planning skill return needs_approval instead of a plan?▼

It returns needs_approval when the requested task conflicts with an active project decision or requires a meaningful product choice the caller has not yet made, rather than guessing at the intended direction.