▊Skill Index

maestro-flow/

manage-codebase-refresh

community[command]

Refresh codebase docs from recent changes

$/plugin install maestro-flow

details

<purpose> Incrementally refresh .workflow/codebase/ documentation based on changes since the last rebuild or refresh. Detects which files have changed (via git diff), identifies which codebase docs are affected, selectively re-runs mapper agents on those areas only, and updates timestamps. Much faster than a full rebuild for ongoing maintenance. </purpose>

<required_reading> @~/.maestro/workflows/codebase-refresh.md </required_reading>

<context> $ARGUMENTS -- optional flags.

Flags:

  • --since <date> -- Override change detection window (ISO date or relative like "3d")
  • --deep -- Force deeper re-scan even for files with minor changes

State files:

  • .workflow/ -- must be initialized
  • .workflow/codebase/ -- must contain existing docs (from prior rebuild)
  • .workflow/codebase/doc-index.json -- documentation index with timestamps
  • .workflow/state.json -- contains codebase_last_rebuilt timestamp </context>
<execution> Follow '~/.maestro/workflows/codebase-refresh.md' completely. </execution>

<error_codes>

CodeMeaning
E001.workflow/ not initialized
E002No codebase/ docs exist, use codebase-rebuild instead
W001No changes detected since last refresh
</error_codes>

<success_criteria>

  • Changed files detected via git diff since last refresh
  • Affected documentation entries identified from doc-index.json
  • Only affected docs refreshed (selective mapper re-run)
  • doc-index.json timestamps updated per affected entry
  • state.json updated with codebase_last_refreshed timestamp
  • Next step routing: /manage-status or /spec-load to use updated docs </success_criteria>

technical

github
catlog22/maestro-flow
stars
340
license
unspecified
contributors
1
last commit
2026-05-25T02:58:12Z
file
.claude/commands/manage-codebase-refresh.md

related