Repository Tree Map - January 4, 2026

[github-actions[bot]]

Overview

This repository tree map provides a comprehensive visualization of the githubnext/gh-aw repository structure. The repository contains 2,264 files totaling 33 MB, with the codebase primarily consisting of Go source files (1,144) and extensive documentation/workflows (507 markdown files).

The largest components are the pkg/ directory (41% of total size) containing the core Go packages, and .github/workflows/ (32%) housing 177 markdown workflow definitions and 125 compiled lock files. The codebase demonstrates excellent test coverage with 746 test files.

Full Repository Tree Map

Repository Tree Map

githubnext/gh-aw [2,264 files, 33 MB]
│
├─ 📦 pkg/ [1,333 files, 13.7 MB] ████████████████████████████████████████░░ 41%
│  │
│  ├─ 🔧 workflow/ [702 files, 7.3 MB] ██████████████████████░░ 22%
│  │  └─ Core workflow compilation, validation, and execution logic
│  │     • 678 Go source files
│  │     • Safe outputs, repo-memory, MCP integration
│  │     • Engine handlers (Copilot, Claude, Codex)
│  │
│  ├─ 💻 cli/ [440 files, 4.3 MB] █████████████░░ 13%
│  │  └─ CLI commands and interface implementation
│  │     • 318 Go source files, 316 command handlers
│  │     • 624 KB of test workflows in workflows/
│  │
│  ├─ 📖 parser/ [64 files, 1.0 MB] ███░░ 3%
│  │  └─ YAML/Markdown frontmatter parsing
│  │     • JSON schemas for validation
│  │
│  ├─ 🎨 console/ [66 files, 424 KB] █░░ 1%
│  │  └─ Console output formatting and rendering
│  │     • 44 golden test files for visual regression
│  │
│  └─ 📋 campaign/ [23 files, 216 KB] ░░ 0.6%
│     └─ Campaign management and orchestration
│
├─ ⚙️  .github/ [353 files, 11.7 MB] ███████████████████████████████████░░ 35%
│  │
│  ├─ 🔄 workflows/ [323 files, 10.8 MB] ████████████████████████████████░░ 32%
│  │  ├─ 177 Markdown workflow definitions (.md)
│  │  ├─ 125 Compiled workflow files (.lock.yml)
│  │  └─ 548 KB in shared/ directory (21 files)
│  │
│  ├─ 📁 aw/ [9 files, 600 KB] ██░░ 1.8%
│  │  └─ Agentic workflow schemas and configurations
│  │
│  └─ 🤖 agents/ [9 files, 136 KB] ░░ 0.4%
│     └─ Agent configurations and templates
│
├─ 🎬 actions/ [292 files, 3.2 MB] █████████░░ 9%
│  │
│  └─ setup/ [287 files, 3.2 MB]
│     ├─ js/ [270 files, 3.0 MB] █████████░░ 9%
│     │  └─ JavaScript action implementations (.cjs)
│     │     • 259 CommonJS modules
│     │     • 128 KB test suite
│     │
│     ├─ sh/ [12 files, 72 KB] ░░ 0.2%
│     │  └─ Shell script helpers
│     │
│     └─ md/ [5 files, 24 KB]
│        └─ Action documentation
│
├─ 📚 docs/ [124 files, 2.2 MB] ██████░░ 6%
│  │
│  ├─ src/ [88 files, 1.6 MB] █████░░ 4.8%
│  │  ├─ content/docs/ [68 files, 840 KB] ███░░ 2.5%
│  │  │  └─ Astro Starlight documentation
│  │  │
│  │  ├─ assets/ [5 files, 576 KB] ██░░ 1.7%
│  │  │  └─ Playground snapshots (464 KB)
│  │  │
│  │  └─ components/ [12 files, 116 KB] ░░ 0.3%
│  │     └─ UI components for docs
│  │
│  ├─ scripts/ [4 files, 52 KB]
│  ├─ tests/ [5 files, 28 KB]
│  └─ workflows/ [2 files, 24 KB]
│
├─ 📝 specs/ [40 files, 760 KB] ██░░ 2%
│  └─ Technical specifications and design docs
│     • 36 spec files, 2 subdirectories (agents/, mods/)
│     • artifacts.md (152 KB) - largest spec
│
├─ 🧠 skills/ [25 files, 344 KB] █░░ 1%
│  └─ AI agent skills and knowledge modules
│     • developer.md, console-rendering.md, github-mcp-server.md
│     • 25 specialized skill directories
│
├─ 📦 cmd/ [8 files, 100 KB] ░░ 0.3%
│  ├─ gh-aw/ [7 files] - Main CLI entry point
│  └─ awmg/ [1 file] - Agent management utility
│
├─ 💡 examples/ [15 files, 76 KB] ░░ 0.2%
│  └─ Example workflows and configurations
│
├─ 🛠️  scripts/ [12 files, 120 KB] ░░ 0.3%
│  └─ Build and development scripts
│
└─ 📋 Root files [25 files, ~1.5 MB]
   ├─ go.sum (112 KB) - Go dependencies
   ├─ CHANGELOG.md (112 KB) - Release history
   ├─ docs/package-lock.json (352 KB) - npm dependencies
   └─ Core project files (README, LICENSE, etc.)

---

Key Statistics

File Type Distribution

Extension	Count	Purpose
.go	1,144	Go source files (50.5% of all files)
.md	507	Markdown docs & workflows (22.4%)
.cjs	259	CommonJS action modules (11.4%)
.yml	150	YAML configurations (6.6%)
.golden	44	Visual regression test snapshots
.json	43	JSON schemas & configs
.sh	30	Shell scripts
Other	77	Various formats (ts, js, py, etc.)

Test Coverage

• 746 test files (*_test.go) - 65% of Go files have tests
• 44 golden files - Visual regression testing for console output
• 128 KB of JavaScript test files in actions/

Largest Files

File	Size	Description
docs/package-lock.json	352 KB	npm dependency lock file
pkg/parser/schemas/main_workflow_schema.json	240 KB	Workflow JSON schema
.github/aw/schemas/agentic-workflow.json	240 KB	Agentic workflow schema
docs/src/assets/playground-snapshots/*.json	236 KB	Playground examples
specs/artifacts.md	152 KB	Artifacts specification
actions/setup/js/collect_ndjson_output.test.cjs	128 KB	Action test suite
go.sum	112 KB	Go module checksums
CHANGELOG.md	112 KB	Release history

Workflow Statistics

• 177 markdown workflows (.md) - Source workflow definitions
• 125 lock files (.lock.yml) - Compiled GitHub Actions workflows
• 71% compilation ratio - Most workflows compiled to lock files
• Largest workflows:
  • copilot-session-insights.lock.yml (116 KB)
  • daily-copilot-token-report.lock.yml (108 KB)
  • daily-news.lock.yml (104 KB)

Directory Hierarchy

Depth Distribution:

• Maximum depth: 6 levels
• Most files at depth 2-4
• Well-organized flat structure in major packages

Size Distribution by Component:

pkg/                  ████████████████████ 41%
.github/workflows/    ████████████████ 32%
pkg/workflow/         ███████████ 22%
pkg/cli/              ███████ 13%
actions/setup/js/     █████ 9%
docs/                 ███ 6%
pkg/parser/           ██ 3%
specs/                █ 2%
Other                 ██ 4%

---

Repository Health Metrics

Code Organization

• ✅ Excellent modularization - Clear separation between packages
• ✅ Comprehensive testing - 746 test files, golden snapshots
• ✅ Rich documentation - 507 markdown files, Astro docs site
• ✅ Active workflows - 177 workflow definitions for automation

Development Patterns

• Go-first architecture - 1,144 Go files as core implementation
• Action-based extensions - 259 CommonJS modules for GitHub Actions
• Schema-driven validation - JSON schemas for workflow definitions
• Visual regression testing - 44 golden files ensure UI consistency

Repository Footprint

• Compact size - 33 MB total (excluding .git)
• Efficient test suite - 746 test files add minimal overhead
• Well-balanced - No single component dominates excessively
• Documentation-rich - 22.4% markdown files indicate strong docs culture

---

Notable Patterns

Multi-Language Approach

• Go (50%) - Core CLI and compilation engine
• JavaScript (11%) - GitHub Actions integration
• Markdown (22%) - Workflows and documentation
• YAML (7%) - Configuration and schemas

Testing Strategy

• Unit tests co-located with source (*_test.go)
• Integration tests for workflows
• Visual regression tests (golden files)
• JavaScript action test coverage

Documentation Structure

• Astro Starlight - Modern documentation site (docs/src/)
• Diátaxis framework - Organized docs content
• Inline specs - Technical specs in specs/ directory
• Skills library - AI agent knowledge modules (skills/)

---

Visualization Notes

Bar lengths represent relative size proportions within the repository:

• █ = Full block (high proportion)
• ▓ = Dark block
• ▒ = Medium block
• ░ = Light block

Percentages show share of total repository size (excluding .git directory).

References:

• Workflow Run §20695204864

AI generated by Repository Tree Map Generator