codebase-intel

Answer repository structure and change-impact questions using deterministic graph data.

165|20|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/wednesday-solutions/ai-agent-skills --skill codebase-intel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-intel
Source: https://github.com/wednesday-solutions/ai-agent-skills/tree/main/skills/codebase-intel
Command: npx skills add https://github.com/wednesday-solutions/ai-agent-skills --skill codebase-intel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevent AI agents from making junior-level mistakes by answering code-structure questions and impact/risk checks using deterministic, precomputed repository intelligence rather than ad-hoc guessing.

Core Features & Use Cases

  • Codebase Discovery & Q&A: Summaries, architecture overviews, circular/dead code findings, and git history attribution for “what does X do?” and “where is Y implemented?” questions.
  • Risk & Blast-Radius Guardrails: File risk scoring (0–100) and dependency-based blast radius analysis to guide safe edits and force explicit approval for high-risk changes.
  • Graph Maintenance & Gap Filling: Detects unmapped/low-coverage areas in the structural graph, checks node metadata for gaps, fills edges only above a confidence threshold, and refreshes analysis incrementally.
  • Source-based Context: Uses graph.db for structural facts and MASTER.md for architectural context, reducing token waste from rereading raw code.

Quick Start

Ask your agent: “Use codebase-intel to summarize <file_path>, report its risk score, then show the blast radius for the change before I edit anything.”

Frequently Asked Questions about codebase-intel

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

FAQPage Schema
How do I check the blast radius of a code change before editing?

Blast radius analysis maps the dependency graph to identify every file affected by a proposed code change. This impact analysis calculates a risk score from 0 to 100 and halts execution for scores above 80 to prevent unsafe modifications.

What is dependency graph based impact analysis for codebases?

Dependency graph impact analysis uses precomputed structural data to answer repository questions deterministically rather than guessing. It evaluates code dependencies to provide architecture discovery, dead code detection, and circular dependency audits across multiple languages.

How do I find dead code and circular dependencies in my repository?

Finding dead code and circular dependencies relies on querying a precomputed structural graph database of your repository. This graph intelligence maps file relationships, enabling automated detection of unused modules and dependency loops without rereading raw source code.

Can I use code intelligence tools to trace git history for architecture discovery?

Code intelligence tools trace git history attribution by mapping commit data onto the structural dependency graph. This contextualizes architectural evolution, answering where specific implementations reside and how components interact across the codebase.

Do I need a precomputed graph database to perform risk scoring on my codebase?

Risk scoring requires a precomputed graph database lookup combined with a MASTER.md context file. These inputs provide the deterministic structural facts and architectural context needed to calculate file risk scores and evaluate blast radius accurately.

What are the limitations of using structural graphs for change impact analysis?

Structural graph limitations include potential unmapped or low-coverage areas within the codebase that require gap filling. The analysis only adds edges above a confidence threshold and must be refreshed incrementally to maintain accurate dependency mappings.