Repository Tree Map - December 2025

[github-actions[bot]]

The gh-aw repository contains 1,761 files totaling 55 MB, with a rich ecosystem of Go code, workflow definitions, documentation, and automation. The majority of the repository's size (71%) comes from compiled workflow .lock.yml files in .github/workflows/, with the core Go codebase in pkg/ representing 25% of the total size.

The repository demonstrates a well-organized modular structure with distinct separation between CLI commands (pkg/cli/), workflow compilation (pkg/workflow/), parsing logic (pkg/parser/), and supporting utilities. The presence of 158 markdown workflow definitions and 112 compiled lock files highlights the project's focus on agentic workflow automation.

📊 Repository Statistics

Overview

Metric	Value
Total Files	1,761
Total Size	55 MB
Max Directory Depth	6 levels
Average File Depth	3.3 levels
Primary Languages	Go, Markdown, JavaScript (CJS), YAML

Size Distribution by Extension

Extension	File Count	Total Size	% of Repo
.yml	131	37 MB	67.3%
.go	860	9.1 MB	16.5%
.md	440	3.7 MB	6.7%
.cjs	210	2.5 MB	4.5%
.json	35	960 KB	1.7%
.sh	22	148 KB	0.3%
.ts	9	52 KB	0.1%

Largest Files

File	Size
.github/workflows/poem-bot.lock.yml	632 KB
.github/workflows/smoke-copilot-no-firewall.lock.yml	484 KB
.github/workflows/smoke-copilot-playwright.lock.yml	468 KB
.github/workflows/daily-performance-summary.lock.yml	468 KB
.github/workflows/smoke-copilot.lock.yml	464 KB
.github/workflows/smoke-copilot-safe-inputs.lock.yml	452 KB
.github/workflows/speckit-dispatcher.lock.yml	444 KB
.github/workflows/q.lock.yml	432 KB
.github/workflows/pr-nitpick-reviewer.lock.yml	432 KB
.github/workflows/daily-issues-report.lock.yml	404 KB

🌲 ASCII Tree Map Visualization

gh-aw Repository Structure
═══════════════════════════════════════════════════════════════════

📦 / [1,761 files, 55 MB]
│
├─ 📁 .github/ [310 files, 39 MB] ████████████████████████████████████████ 71%
│  │
│  ├─ 📁 workflows/ [270 files, 39 MB] ████████████████████████████████████████ 71%
│  │  ├─ 📄 *.md [158 files] - Workflow definitions
│  │  └─ 🔧 *.lock.yml [112 files, 38 MB] - Compiled workflows
│  │
│  ├─ 📁 aw/ [8 files, 104 KB] ▓░
│  ├─ 📁 agents/ [18 files, 72 KB] ▓░
│  ├─ 📁 copilot/ [4 files, 56 KB] ▒░
│  └─ 📁 actions/ [10 files, 40 KB] ▒░
│
├─ 📁 pkg/ [1,226 files, 14 MB] █████████████████████████░░ 25%
│  │
│  ├─ 📁 workflow/ [552 files, 8.7 MB] ████████████████░░ 16%
│  │  ├─ 📁 js/ [216 files, 2.7 MB] █████░░ - GitHub Actions runtime
│  │  ├─ 📁 schemas/ [3 files, 256 KB] ░ - JSON validation schemas
│  │  ├─ 📁 test_data/ [6 files, 132 KB] ░
│  │  ├─ 📁 prompts/ [8 files, 36 KB] ░
│  │  └─ 📁 sh/ [8 files, 44 KB] ░
│  │
│  ├─ 📁 cli/ [228 files, 3.3 MB] ██████░░ 6%
│  │  ├─ 📁 workflows/ [95 files, 548 KB] █░ - CLI workflow implementations
│  │  ├─ 📁 templates/ [8 files, 208 KB] ░
│  │  └─ 📁 fileutil/ [2 files, 16 KB] ░
│  │
│  ├─ 📁 parser/ [42 files, 816 KB] █▒░ 1.5%
│  │  └─ 📁 schemas/ [3 files, 256 KB] ░
│  │
│  ├─ 📁 console/ [14 files, 124 KB] ░ - Terminal output formatting
│  ├─ 📁 gateway/ [7 files, 80 KB] ░ - Gateway utilities
│  ├─ 📁 logger/ [6 files, 48 KB] ░ - Debug logging system
│  ├─ 📁 constants/ [2 files, 32 KB] ░
│  ├─ 📁 styles/ [2 files, 24 KB] ░
│  ├─ 📁 gitutil/ [2 files, 20 KB] ░
│  ├─ 📁 testutil/ [2 files, 12 KB] ░
│  ├─ 📁 timeutil/ [2 files, 12 KB] ░
│  └─ 📁 tty/ [1 file, 8 KB] ░
│
├─ 📁 docs/ [88 files, 1.3 MB] ██▒░ 2.4%
│  └─ 📁 src/ [80 files, 916 KB] █▓░ - Astro Starlight documentation
│
├─ 📁 skills/ [25 files, 344 KB] ▓░ 0.6%
│  └─ 📁 developer/ [6 files, 64 KB] ░ - Development guidelines
│
├─ 📁 .specify/ [18 files, 232 KB] ▒░ 0.4%
│  ├─ 📁 commands/ [8 files, 92 KB] ░
│  └─ 📁 scripts/ [8 files, 68 KB] ░
│
├─ 📁 specs/ [18 files, 220 KB] ▒░ 0.4%
│
├─ 📁 scripts/ [11 files, 112 KB] ▒░ 0.2%
│
├─ 📁 .changeset/ [25 files, 100 KB] ▒░ 0.2%
│
├─ 📁 cmd/ [5 files, 64 KB] ▒░ 0.1%
│  └─ 📁 gh-aw/ [4 files, 60 KB] ▒░ - CLI entry point
│
├─ 📁 schemas/ [1 file, 24 KB] ░
│
├─ 📁 examples/ [3 files, 20 KB] ░
│
├─ 📁 .vscode/ [4 files, 20 KB] ░
│
├─ 📁 .devcontainer/ [2 files, 12 KB] ░
│
└─ 📄 Root files [22 files, 72 KB] ░
   ├─ 🔧 go.mod, go.sum - Go module configuration
   ├─ 🔧 Makefile - Build automation
   ├─ 📚 *.md - Documentation (README, CONTRIBUTING, etc.)
   └─ 🔧 install-gh-aw.sh - Installation script

═══════════════════════════════════════════════════════════════════

Legend:
  █ = 5% of repository size
  ▓ = 2.5% of repository size
  ▒ = 1% of repository size
  ░ = < 1% of repository size

  📦 = Root
  📁 = Directory
  📄 = File
  🔧 = Configuration
  📚 = Documentation
  🧪 = Tests

🎯 Key Insights

Architecture Highlights

1. Workflow-Centric Design (71% of repository)

The .github/workflows/ directory dominates the repository size with 39 MB, containing:

• 158 markdown workflow definitions - Human-readable agentic workflows
• 112 compiled .lock.yml files - Generated GitHub Actions workflows
• Average compiled workflow size: ~350 KB
• Largest workflow: poem-bot.lock.yml at 632 KB

2. Modular Go Codebase (25% of repository)

The pkg/ directory showcases clean architectural separation:

• workflow/ (8.7 MB, 552 files) - Core workflow compilation engine
  • Heavy JavaScript integration (216 .cjs files) for GitHub Actions runtime
  • JSON schema validation (256 KB of schemas)
  • Built-in prompts and shell utilities
• cli/ (3.3 MB, 228 files) - Command-line interface layer
  • 95 workflow-related commands
  • Template system for code generation
• parser/ (816 KB, 42 files) - Markdown frontmatter parsing
• Supporting utilities - Console rendering, logging, Git integration

3. Documentation & Developer Experience (2.4%)

• Astro Starlight-based documentation in docs/src/
• 25 skill files (344 KB) providing specialized development knowledge
• 18 spec files (220 KB) for feature specifications
• Comprehensive root documentation (README, CONTRIBUTING, DEVGUIDE)

4. Language Distribution

Go:         860 files (48.8%)  → Core implementation
Markdown:   440 files (25.0%)  → Workflows + docs
JavaScript: 210 files (11.9%)  → Actions runtime
YAML:       131 files (7.4%)   → Compiled workflows
JSON:        35 files (2.0%)   → Config + schemas
Shell:       22 files (1.2%)   → Build scripts

5. Build & Automation Infrastructure

• Makefile with comprehensive build targets
• .specify/ directory (232 KB) with custom commands and scripts
• .changeset/ for versioning and release management
• Install script (install-gh-aw.sh) for easy distribution

Repository Health Metrics

Metric	Value	Assessment
Code Organization	8 main packages	✅ Excellent modularity
Documentation Coverage	440 MD files	✅ Well-documented
Test Infrastructure	test_data, testutil	✅ Testing support
Developer Tools	Skills, specs, scripts	✅ Rich DX
Build System	Makefile + deps	✅ Automated
Directory Depth	Max 6, Avg 3.3	✅ Reasonable complexity

Growth Patterns

Largest growth areas:

1. Compiled workflows - 112 files totaling 38 MB (dominant)
2. JavaScript runtime - 216 CJS files for GitHub Actions integration
3. Go codebase - 860 files across 8 major packages
4. Workflow definitions - 158 markdown files for agentic automation

Optimization opportunities:

• Compiled .lock.yml files are large (avg 350 KB) but necessary for deployment
• Consider workflow deduplication if patterns emerge
• JavaScript bundle size could potentially be optimized

📈 File Type Analysis

Top 20 File Extensions by Count

Extension	Count	Purpose
.go	860	Go source code (core implementation)
.md	440	Markdown (workflows + documentation)
.cjs	210	CommonJS modules (GitHub Actions runtime)
.yml	131	YAML (compiled workflow files)
.json	35	JSON (configuration + schemas)
.sh	22	Shell scripts (automation)
.ts	9	TypeScript (type definitions)
.astro	8	Astro components (documentation site)
.txt	7	Text files (misc data)
.mdx	6	MDX (documentation with JSX)
.js	6	JavaScript (build scripts)
.mjs	4	ES modules (modern JS)
.svg	3	SVG images
.py	3	Python scripts
.gitignore	3	Git ignore configs
.mod	2	Go module files
.gitattributes	2	Git attributes
.yaml	1	YAML alternative extension
.webp	1	WebP image
.sum	1	Go checksum file

Programming Language Breakdown

Go (Primary Language)

• 860 files across 8 major packages
• 9.1 MB of source code
• Average file size: ~11 KB
• Well-distributed across pkg/ subdirectories

JavaScript/TypeScript (Actions Runtime)

• 210 CJS files (2.5 MB) - GitHub Actions integration
• 9 TypeScript files (52 KB) - Type definitions
• 6 JavaScript files - Build tooling
• Heavy focus on CommonJS for Node.js compatibility

Documentation

• 440 Markdown files (3.7 MB)
• 8 Astro components for documentation site
• 6 MDX files for interactive docs
• Average markdown file: ~8.4 KB

Configuration & Build

• 131 YAML files (37 MB) - Mostly compiled workflows
• 35 JSON files (960 KB) - Schemas and config
• 22 Shell scripts (148 KB) - Automation

---

Generated: December 8, 2025
Repository: githubnext/gh-aw
Commit: Current HEAD

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.