Codebase Sweep

Orchestrate autonomous sweeps to identify cross-cutting issues across ForgePlan codebases.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/cspergel/forgedev --skill codebase-sweep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Codebase Sweep
Source: https://github.com/cspergel/forgedev/tree/main/skills/sweep
Command: npx skills add https://github.com/cspergel/forgedev --skill codebase-sweep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the detection of cross-cutting issues across a ForgePlan codebase by orchestrating autonomous sweep agents that surface findings, converge on risks, and route project-level notes for manual attention.

Core Features & Use Cases

  • Dispatches a tiered set of sweep agents to identify cross-node contract, architectural, and compliance findings.
  • Aggregates, deduplicates, and classifies findings by node, then writes a structured sweep report.
  • Automatically transitions from discovery to fix cycles, with optional manual attention for project-level findings and decisions.

Quick Start

Kick off an autonomous sweep to identify cross-cutting issues and generate a sweep report.

Frequently Asked Questions about Codebase Sweep

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

FAQPage Schema
How do I automate finding cross-cutting issues in a large codebase?

Automating codebase issue detection uses tiered sweep agents to identify contract, architectural, and compliance findings across multi-node projects. Agents autonomously scan the codebase, aggregating and deduplicating results into a structured report for review.

How does an autonomous sweep agent workflow operate on multi-node projects?

Autonomous sweep workflows dispatch tiered agents across dependency graphs to identify cross-node findings. The agents aggregate and classify issues by node, transitioning automatically from discovery to fix cycles while routing project-level risks for manual attention.

Can I use automated sweeps for both code fixes and project-level compliance findings?

Automated sweeps support both code fixes and compliance findings by classifying results by node and severity. Discovery cycles transition into automated fix-cycles, while project-level compliance risks and architectural decisions are routed for manual attention.

What is the best way to structure a codebase sweep report for manual attention?

Structuring a codebase sweep report requires aggregating and deduplicating findings by node, then classifying them by risk level. The sweep generates a structured report that routes project-level notes and decisions for manual attention.

Does Codebase Sweep require a ForgePlan project to run automated fix cycles?

Codebase Sweep requires a ForgePlan project to orchestrate autonomous sweeps across multi-node codebases. It leverages ForgePlan dependency graphs and phase-based workflows to transition from issue discovery to automated fix cycles.

Why use tiered agent orchestration instead of a single automated codebase sweep?

Tiered agent orchestration improves codebase sweeps by dispatching specialized agents to identify distinct contract, architectural, and compliance findings. This multi-agent approach prevents single-point bottlenecks and ensures comprehensive cross-node coverage.