Repository Tree Map - December 2025

[github-actions[bot]]

This repository tree map provides a comprehensive visualization of the gh-aw codebase structure, showing file distribution, directory sizes, and organizational patterns.

The analysis reveals that the repository consists of 1,858 files totaling 61.9 MB, with the majority of content (72.6%) concentrated in GitHub workflows. The codebase is primarily Go-based (929 .go files) with extensive documentation (446 markdown files) and a significant JavaScript/CommonJS presence (236 files) for GitHub Actions integration.

📊 Repository Overview Statistics

Key Metrics

Metric	Value
Total Files	1,858 files
Repository Size	61.9 MB
Primary Language	Go (929 files, 50% of total)
Documentation	446 Markdown files (24%)
Workflows	163 markdown workflows + 116 compiled .lock.yml
Test Coverage	626 test files (67% of Go files)

File Type Distribution

Go source files:      929 (50.0%) ████████████████████████████████
Markdown files:       446 (24.0%) ███████████████
JavaScript/CommonJS:  236 (12.7%) ████████
YAML workflows:       138 (7.4%)  ████
JSON config:           36 (1.9%)  █
Shell scripts:         21 (1.1%)  ▓
TypeScript:             9 (0.5%)  ▒
Other types:           43 (2.3%)  █

🌳 ASCII Tree Map Visualization

githubnext/gh-aw [1,858 files, 61.9 MB]
│
├─ 📁 .github/ [322 files, 45 MB] ██████████████████████████████████████████████████████████████████████▓░ 72.6%
│  │
│  ├─ 📁 workflows/ [292 files, 44.5 MB] ████████████████████████████████████████████████████████████████████░
│  │  ├─ 📄 *.md (workflow sources)     [163 files] - Markdown workflow definitions
│  │  ├─ 📄 *.lock.yml (compiled)       [116 files] - Compiled workflow artifacts
│  │  └─ 📄 *.yml (standard workflows)   [13 files] - Traditional GitHub Actions
│  │
│  ├─ 📁 agents/ [120K, 18 files] ██░ - Agent configuration and instructions
│  ├─ 📁 aw/ [104K, 6 files] █░ - Agentic workflow utilities
│  ├─ 📁 copilot/ [56K, 4 files] █░ - Copilot integration configs
│  └─ 📁 actions/ [40K, 2 files] ▓░ - Custom GitHub Actions
│
├─ 📁 pkg/ [1,312 files, 14.0 MB] █████████████████████████▓░ 22.6%
│  │
│  ├─ 📁 workflow/ [846 files, 9.2 MB] ████████████████████████████████████████████████████████████░ 64.3%
│  │  ├─ 📁 js/ [236 files, 2.9 MB] ████████████████████▓░ - CommonJS for GitHub Actions runtime
│  │  ├─ 📁 test_data/ [6 files, 128K] ▓░ - Test fixtures and samples
│  │  ├─ 📁 schemas/ [2 files, 108K] ▓░ - Workflow validation schemas
│  │  ├─ 📁 sh/ [8 files, 44K] ▒░ - Shell script utilities
│  │  ├─ 📁 prompts/ [8 files, 36K] ▒░ - AI prompt templates
│  │  └─ 📄 *.go [586 files] - Workflow compilation engine
│  │
│  ├─ 📁 cli/ [369 files, 3.6 MB] █████████████████████████▓░ 25.7%
│  │  ├─ 📁 workflows/ [109 files, 588K] ████████████████░ - Test workflow definitions
│  │  ├─ 📁 templates/ [9 files, 224K] ██████░ - CLI command templates
│  │  └─ 📄 *.go [251 files] - Command implementations
│  │
│  ├─ 📁 parser/ [49 files, 892K] ██████▓░ 6.2%
│  │  ├─ 📁 schemas/ [3 files, 268K] ████████░ - Frontmatter parsing schemas
│  │  └─ 📄 *.go [46 files] - Markdown parsing logic
│  │
│  ├─ 📁 console/ [15 files, 124K] █░ 0.9% - Terminal output formatting
│  ├─ 📁 campaign/ [14 files, 116K] █░ - Campaign workflow orchestration
│  ├─ 📁 logger/ [8 files, 56K] ▓░ - Debug logging system
│  ├─ 📁 constants/ [2 files, 32K] ▒░ - Shared constants
│  ├─ 📁 styles/ [2 files, 24K] ▒░ - Output styling
│  ├─ 📁 gitutil/ [2 files, 20K] ▒░ - Git integration helpers
│  └─ 📁 other/ [33 files] - Utilities and helpers
│
├─ 📁 docs/ [92 files, 1.4 MB] ██▓░ 2.2%
│  │
│  ├─ 📁 src/ [82 files, 1008K] ████████████████████████████████████████████████████████████░
│  │  ├─ 📁 content/ [64 files, 804K] ████████████████████████████████████████████░
│  │  │  ├─ 📚 docs/ - Main documentation (Astro Starlight)
│  │  │  └─ 📚 guides/ - User guides and tutorials
│  │  ├─ 📁 assets/ [9 files, 112K] ███████░ - Images and static resources
│  │  ├─ 📁 components/ [5 files, 52K] ███░ - Astro UI components
│  │  └─ 📁 styles/ [2 files, 32K] ██░ - CSS styling
│  │
│  ├─ 📁 tests/ [6 files, 24K] █░ - Documentation tests
│  └─ 📁 public/ [2 files, 8K] ▒░ - Static assets
│
├─ 📁 skills/ [25 files, 344K] █░ 0.5%
│  ├─ 📚 developer [64K] - Core development guidelines
│  ├─ 📚 custom-agents [24K] - Agent file format specs
│  ├─ 📚 javascript-refactoring [20K] - JS refactoring guide
│  ├─ 📚 github-mcp-server [20K] - MCP server integration
│  └─ 📚 [21 other skills] [216K] - Specialized knowledge modules
│
├─ 📁 specs/ [20 files, 284K] █░ 0.4% - Specification documents
│
├─ 📁 actions/ [9 files, 180K] ▓░ 0.3%
│  ├─ 📁 setup-safe-outputs/ [4 files, 104K] - Safe output action
│  └─ 📁 setup-safe-inputs/ [3 files, 60K] - Safe input action
│
├─ 📁 scripts/ [11 files, 116K] ▓░ 0.2% - Build and utility scripts
│
├─ 📁 cmd/ [6 files, 68K] ▒░ 0.1%
│  └─ 📁 gh-aw/ [6 files] - CLI entry point and main package
│
├─ 📁 examples/ [5 files, 36K] ▒░ 0.1% - Sample workflow examples
│
├─ 📁 schemas/ [1 file, 28K] ▒░ 0.0% - Root-level schemas
│
├─ 📁 internal/ [2 files, 24K] ▒░ 0.0% - Internal utilities
│
└─ 📄 Root files [14 files, 48K] ▒░ 0.8%
   ├─ 🔧 go.mod, go.sum - Go module dependencies
   ├─ 🔧 Makefile - Build automation
   ├─ 📄 README.md - Project documentation
   ├─ 📄 AGENTS.md - AI agent instructions
   └─ 📄 [9 other docs] - Contributing, license, security, etc.

Legend

• █ Full block (10% of scale)
• ▓ Dark shade (7.5%)
• ▒ Medium shade (5%)
• ░ Light shade (2.5%)
• 📁 Directory
• 📄 File
• 🔧 Configuration
• 📚 Documentation
• 🧪 Test

🔝 Largest Files (Top 15)

These compiled workflow lock files contain bundled JavaScript and dependencies:

Size	File
696K	.github/workflows/poem-bot.lock.yml
528K	.github/workflows/smoke-copilot-no-firewall.lock.yml
500K	.github/workflows/smoke-copilot-playwright.lock.yml
492K	.github/workflows/daily-performance-summary.lock.yml
484K	.github/workflows/speckit-dispatcher.lock.yml
484K	.github/workflows/org-wide-rollout.lock.yml
480K	.github/workflows/smoke-copilot-safe-inputs.lock.yml
480K	.github/workflows/incident-response.lock.yml
480K	.github/workflows/daily-file-diet.lock.yml
476K	.github/workflows/q.lock.yml
472K	.github/workflows/pr-nitpick-reviewer.lock.yml
448K	.github/workflows/cloclo.lock.yml
444K	.github/workflows/unbloat-docs.lock.yml
440K	.github/workflows/intelligence.lock.yml
436K	.github/workflows/portfolio-analyst.lock.yml

Note: Lock files are large because they contain bundled JavaScript code and dependencies needed to run workflows independently.

🎯 Key Insights

Architecture Highlights

1. Workflow-Centric Design (72.6% of codebase)

The .github/ directory dominates the repository, reflecting gh-aw's core mission: converting natural language markdown workflows into executable GitHub Actions.

• 163 markdown workflow sources demonstrate extensive real-world usage
• 116 compiled .lock.yml files show the compilation output
• Average lock file size: ~400KB (bundled JS + dependencies)

2. Go-Powered Engine (22.6% of codebase)

The pkg/ directory contains the workflow compilation engine:

• pkg/workflow/: 64.3% of pkg - Core compilation logic + 236 CommonJS files
• pkg/cli/: 25.7% of pkg - Command implementations + test workflows
• pkg/parser/: 6.2% of pkg - Markdown frontmatter parsing
• High test coverage: 626 test files (67% of Go code)

3. Documentation-First Approach (2.2% + 24% markdown)

• Dedicated docs site using Astro Starlight
• 446 total markdown files across repository
• 25 specialized skill modules for AI agents
• 20 specification documents for standards

4. AI Agent Integration

• Skills directory: 25 specialized knowledge modules
• Custom agents: Configurations in .github/agents/
• Copilot integration: Templates and instructions
• MCP server support: Docker and remote configurations

5. JavaScript Runtime (236 files)

CommonJS files in pkg/workflow/js/ provide GitHub Actions runtime:

• Safe output handling
• Environment management
• Docker operations
• Tool execution

Growth Patterns

The repository shows clear specialization:

• Backend: Pure Go implementation (no external runtime dependencies)
• Frontend: JavaScript for GitHub Actions runtime environment
• Documentation: Comprehensive guides and AI-readable skills
• Testing: Strong test coverage with dedicated test workflows

Recommendations

1. Consider splitting large lock files: Some workflows exceed 600KB
2. Maintain test coverage: 67% ratio of tests to source is excellent
3. Skills are valuable: 25 specialized modules provide rich AI context
4. Documentation investment: 2.2% dedicated docs + extensive markdown

📈 Directory Size Comparison

Visual size comparison (each █ = ~1.5 MB):

.github/    (45.0 MB)  ██████████████████████████████
pkg/        (14.0 MB)  █████████▓░
docs/       ( 1.4 MB)  █░
skills/     ( 0.3 MB)  ▒
specs/      ( 0.3 MB)  ▒
actions/    ( 0.2 MB)  ▒
scripts/    ( 0.1 MB)  ░
cmd/        ( 0.1 MB)  ░
others      ( 0.5 MB)  ▒
                       └─────┴─────┴─────┴─────┴─────┴
                       0    10    20    30    40   50 MB

Directory Purpose Matrix

Directory	Purpose	Primary Content	File Count
.github/	Workflows & Actions	Compiled workflows, agents	322
pkg/	Core Engine	Go source, tests, JS runtime	1,312
docs/	Documentation Site	Astro Starlight content	92
skills/	AI Knowledge Base	Specialized instruction modules	25
specs/	Specifications	Technical specifications	20
actions/	Custom Actions	Safe I/O actions	9
scripts/	Build Tools	Automation scripts	11
cmd/	CLI Entry	Main package	6
examples/	Samples	Example workflows	5

---

Generated: December 15, 2025
Analysis Tool: gh-aw repository tree mapper
Total Files Analyzed: 1,858
Repository: githubnext/gh-aw

AI generated by Repository Tree Map Generator

[github-actions[bot]]

This discussion was automatically closed because it was created by an agentic workflow more than 3 days ago.