manage-codebase-rebuild

Generate codebase documentation by scanning source files and running parallel generator agents.

511|63|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/catlog22/Maestro-Flow --skill manage-codebase-rebuild
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manage-codebase-rebuild
Source: https://github.com/catlog22/Maestro-Flow/tree/main/.codex/skills/manage-codebase-rebuild
Command: npx skills add https://github.com/catlog22/Maestro-Flow --skill manage-codebase-rebuild

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious, error-prone process of producing a comprehensive, up-to-date codebase documentation set by scanning source files, mapping features and requirements, and generating human-readable docs and indexes.

Core Features & Use Cases

  • Parallel CSV Wave Execution: Spawns multiple concurrent doc generator agents to analyze different documentation dimensions (components, features, requirements, tech registry, feature maps).
  • Append-only Discovery Board: Shares findings via discoveries.ndjson so agents can deduplicate and reuse context across the wave.
  • Single-step Full Rebuild: Prepares tasks.csv, runs agents, assembles doc-index.json, and optionally auto-commits results for a complete .workflow/codebase/ replacement.

Quick Start

Run manage-codebase-rebuild with appropriate flags to generate a full .workflow/codebase/ documentation set using parallel doc generator agents.

Frequently Asked Questions about manage-codebase-rebuild

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

FAQPage Schema
How do I automatically generate documentation for an entire codebase?

You can automatically generate codebase documentation by scanning source files and orchestrating parallel doc generator agents to produce components, features, requirements, and ADR artifacts into a .workflow/codebase directory.

How does multi-agent orchestration work for codebase documentation generation?

Multi-agent orchestration for codebase documentation works by spawning concurrent agents via a CSV wave to analyze different dimensions, sharing findings through an append-only discovery board so agents deduplicate and reuse context.

What's the best way to rebuild outdated project documentation across multiple source directories?

The best way to rebuild outdated project documentation is running a single-step full rebuild that prepares a task list, runs parallel agents over source directories like src and lib, and assembles a comprehensive doc index.

Can I resume codebase documentation generation if the process fails partway through?

Yes, you can resume codebase documentation generation by using supported execution flags, allowing the parallel agent workflow to continue from where it left off without regenerating completed artifacts.

Does the codebase documentation generator require a specific project structure?

The codebase documentation generator requires a project with a .workflow directory and source code locations such as src, lib, app, or packages to scan and map features into the documentation set.

What are the limitations of using parallel agents for full documentation rebuilds?

A limitation of parallel agent documentation rebuilds is the dependency on the .workflow directory structure; without it or recognizable source code folders, the multi-agent orchestration cannot map or generate the required artifacts.