Skip to content

Add weekly-repo-map workflow#243

Merged
dsyme merged 2 commits intomainfrom
daily-repo-goals/weekly-repo-map-2026-03-07-bf4a525831185ade
Mar 7, 2026
Merged

Add weekly-repo-map workflow#243
dsyme merged 2 commits intomainfrom
daily-repo-goals/weekly-repo-map-2026-03-07-bf4a525831185ade

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Mar 7, 2026

Summary

Adds a new Weekly Repository Map workflow that generates an ASCII tree map visualization of the repository's file structure and size distribution, posting the result as a GitHub issue each week.


Phase 1 — Consistency Check

✅ All workflows/*.md files have matching docs/*.md files
✅ All docs/*.md files are listed in README.md
✅ No typos or style inconsistencies found

No Phase 1 changes needed.


Phase 2 — New Workflow: Weekly Repository Map

Source

Adapted from repo-tree-map.md in Peli's Agent Factory.

Merge Rate

Not documented in the blog series (this workflow was not covered). Selected for its simplicity, language-agnostic nature, and clear practical value.

Why It's Valuable

Maintainers sometimes lose track of how a repository's structure has grown — which directories are getting large, what file types dominate, and where the bulk of the code lives. A weekly ASCII tree map gives a quick, lightweight snapshot that's useful for:

  • Spotting unexpectedly large directories or files
  • Understanding the project's structural balance (source vs. tests vs. docs)
  • Tracking structural drift over time (though this version doesn't persist history)

It requires no language-specific tools — just standard find and du bash commands — making it applicable to any repository.

Generalization Plan

  • Removed imports: [shared/reporting.md] (gh-aw specific shared import)
  • Changed create-discussion (requires a "dev" discussion category) → create-issue (works in all repos)
  • Replaced gh-aw-specific example paths (pkg/, cmd/) with generic paths (src/, docs/, tests/)
  • Kept all core analysis logic (bash commands for structure analysis) unchanged

Files Changed

  • workflows/weekly-repo-map.md — New workflow
  • docs/weekly-repo-map.md — Documentation page
  • README.md — Added entry under "Research, Status & Planning Workflows"

Generated by Daily Repo Goal Achiever ·

Adds a new weekly workflow that generates an ASCII tree map
visualization of the repository's file structure and size distribution.

The workflow:
- Runs every Monday via schedule, or on-demand via workflow_dispatch
- Uses standard bash tools (find, du) for language-agnostic analysis
- Generates proportional size bars and file counts in a visual tree
- Creates a GitHub issue with the tree map, key statistics, and file type breakdown
- Closes the previous week's issue automatically

Adapted from repo-tree-map.md in Peli's Agent Factory (gh-aw).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@dsyme dsyme marked this pull request as ready for review March 7, 2026 17:50
@dsyme dsyme merged commit c776001 into main Mar 7, 2026
1 check passed
@dsyme dsyme deleted the daily-repo-goals/weekly-repo-map-2026-03-07-bf4a525831185ade branch March 7, 2026 18:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant