Repository Tree Map - December 2024

[github-actions[bot]]

Overview

The gh-aw repository contains 1,996 files totaling 69 MB (excluding .git). The codebase is primarily Go-based (50% of files) with extensive workflow automation and documentation. The repository is dominated by GitHub Actions workflows (72.5% of total size) with 168 source workflows and 122 compiled lock files.

Full Repository Tree Map

ASCII Tree Visualization

githubnext/gh-aw [1,996 files, 69 MB]
│
├─ 📁 .github/ [1,407 files, 50 MB] ████████████████████████████████████████ 72.5%
│  │
│  ├─ 🔧 workflows/ [290 files, 49 MB] ███████████████████████████████████████ 71.0%
│  │  ├─ *.md (source) [168 files, ~2 MB] ███░░░
│  │  ├─ *.lock.yml (compiled) [122 files, ~47 MB] ████████████████████████░░
│  │  │  └─ 📄 poem-bot.lock.yml [688 KB] ████░░ (largest)
│  │  │  └─ 📄 smoke-copilot-playwright.lock.yml [540 KB] ███░░
│  │  │  └─ 📄 org-wide-rollout.lock.yml [504 KB] ███░░
│  │  └─ shared/ [508 KB] ███░░
│  │
│  ├─ 📁 aw/ [548 KB] ███░░
│  │  └─ schemas/ [224 KB] ██░░
│  │
│  ├─ 📁 agents/ [132 KB] █░░
│  ├─ 📁 copilot/ [56 KB] ░░
│  │  └─ instructions/ [52 KB] ░░
│  ├─ 📁 actions/ [40 KB] ░░
│  └─ 📁 instructions/ [24 KB] ░░
│
├─ 📁 pkg/ [340 files, 15 MB] █████████████████ 21.7%
│  │
│  ├─ 📁 workflow/ [9.7 MB] ████████████░░ (core workflow engine)
│  │  ├─ 📄 *.go [120+ files, 6.8 MB] ████████░░
│  │  ├─ 📁 js/ [2.9 MB] ████░░ (GitHub Actions JavaScript)
│  │  └─ 📁 test_data/ [128 KB] ░░
│  │
│  ├─ 📁 cli/ [3.8 MB] █████░░ (command implementations)
│  │  ├─ 📄 *.go [70+ files, 3.2 MB] ████░░
│  │  ├─ 📁 workflows/ [612 KB] ██░░ (test workflows)
│  │  └─ 📁 templates/ [224 KB] █░░
│  │
│  ├─ 📁 parser/ [956 KB] ███░░ (markdown frontmatter parsing)
│  │  ├─ 📄 *.go [20+ files, 688 KB] ██░░
│  │  └─ 📁 schemas/ [268 KB] █░░
│  │
│  ├─ 📁 campaign/ [172 KB] █░░
│  ├─ 📁 console/ [40 KB] ░░
│  ├─ 📁 logger/ [32 KB] ░░
│  ├─ 📁 styles/ [28 KB] ░░
│  ├─ 📁 testutil/ [24 KB] ░░
│  ├─ 📁 constants/ [20 KB] ░░
│  ├─ 📁 gitutil/ [16 KB] ░░
│  ├─ 📁 timeutil/ [12 KB] ░░
│  └─ 📁 tty/ [8 KB] ░░
│
├─ 📚 docs/ [100 files, 1.6 MB] ███ 2.3%
│  ├─ 📁 src/ [1.1 MB] ██░░
│  │  ├─ 📁 content/ [876 KB] ██░░ (documentation content)
│  │  ├─ 📁 assets/ [112 KB] ░░
│  │  ├─ 📁 components/ [52 KB] ░░
│  │  └─ 📁 styles/ [32 KB] ░░
│  └─ 📁 tests/ [24 KB] ░░
│
├─ 📁 examples/ [15 files, 756 KB] █░ 1.1%
│
├─ 📚 specs/ [26 files, 388 KB] █░ 0.6%
│
├─ 📚 skills/ [25 files, 344 KB] █░ 0.5%
│
├─ 📁 .specify/ [23 files, 232 KB] ░░ 0.3%
│
├─ 🔧 actions/ [9 files, 180 KB] ░░ 0.3%
│  ├─ setup-safe-inputs/
│  └─ setup-safe-outputs/
│
├─ 🔧 scripts/ [12 files, 120 KB] ░░ 0.2%
│
├─ 📁 cmd/ [6 files, 76 KB] ░░ 0.1%
│  └─ gh-aw/ (CLI entry point)
│
├─ 📄 schemas/ [1 file, 28 KB] ░░ 0.04%
│
├─ 📁 internal/ [2 files, 24 KB] ░░ 0.03%
│
└─ 📄 Root config files [~50 KB] ░░
   ├─ go.mod, go.sum
   ├─ Makefile
   ├─ README.md
   └─ AGENTS.md

Key Statistics

Repository Composition

Metric	Value
Total Files	1,996 files
Total Size	69 MB
Directories	~50 directories
Deepest Path	6-7 levels

File Type Distribution

Type	Count	Percentage
🔷 Go files	1,000	50.1%
📝 Markdown	474	23.7%
🟨 CommonJS	236	11.8%
🔧 YAML	153	7.7%
📋 JSON	37	1.9%
🐚 Shell scripts	22	1.1%
🟦 JavaScript	10	0.5%
🔷 TypeScript	9	0.5%
🚀 Astro	8	0.4%
📦 Other	47	2.4%

Workflow Statistics

Metric	Count
Source Workflows (*.md)	168
Compiled Workflows (*.lock.yml)	122
Custom GitHub Actions	2
Workflow Size	~49 MB (71% of repo)

Largest Files (Top 10)

File	Size	Type
poem-bot.lock.yml	688 KB	Compiled workflow
smoke-copilot-playwright.lock.yml	540 KB	Compiled workflow
org-wide-rollout.lock.yml	504 KB	Compiled workflow
incident-response.lock.yml	500 KB	Compiled workflow
daily-performance-summary.lock.yml	496 KB	Compiled workflow
campaign-manager.lock.yml	496 KB	Compiled workflow
smoke-copilot-no-firewall.lock.yml	492 KB	Compiled workflow
smoke-copilot-safe-inputs.lock.yml	488 KB	Compiled workflow
speckit-dispatcher.lock.yml	484 KB	Compiled workflow
q.lock.yml	480 KB	Compiled workflow

Directory Size Distribution

Directory	Size	% of Total	Files	Purpose
.github/	50 MB	72.5%	1,407	GitHub Actions & workflows
pkg/	15 MB	21.7%	340	Core Go packages
docs/	1.6 MB	2.3%	100	Documentation (Astro)
examples/	756 KB	1.1%	15	Example workflows
specs/	388 KB	0.6%	26	Technical specifications
skills/	344 KB	0.5%	25	AI agent skills
actions/	180 KB	0.3%	9	Custom GitHub Actions
scripts/	120 KB	0.2%	12	Build & utility scripts
cmd/	76 KB	0.1%	6	CLI entry point
Other	~200 KB	0.3%	30	Config & misc files

Architecture Insights

Core Package Structure (pkg/)

The pkg/ directory contains the heart of the application with 12 sub-packages:

1. workflow/ (9.7 MB) - Largest package, core compilation engine

   • Markdown → GitHub Actions YAML compilation
   • JavaScript generation for GitHub Actions
   • Extensive test coverage with test_data/

2. cli/ (3.8 MB) - Command-line interface implementations

   • All CLI commands (compile, mcp, logs, audit, etc.)
   • Built-in test workflows for validation
   • Template system for code generation

3. parser/ (956 KB) - Frontmatter parsing & validation

   • YAML/Markdown parsing
   • JSON schema validation
   • Configuration processing

4. campaign/ (172 KB) - Campaign management system

5. Support Packages (< 50 KB each)

   • console/ - Formatted console output
   • logger/ - Debug logging with namespace filtering
   • styles/ - Terminal styling
   • testutil/ - Testing utilities
   • constants/ - Application constants
   • gitutil/ - Git operations
   • timeutil/ - Time formatting
   • tty/ - Terminal detection

Workflow Compilation System

The repository demonstrates a unique dual-format workflow system:

• Source workflows (.md files, 168 total) - Human-readable markdown with YAML frontmatter
• Compiled workflows (.lock.yml files, 122 total) - Generated GitHub Actions YAML

This compilation system is the repository's defining feature, with compiled workflows accounting for 71% of total repository size.

Documentation System

Documentation uses Astro Starlight framework (1.6 MB):

• Structured content in docs/src/content/
• Custom components for enhanced UX
• Automated workflow testing examples
• Built-in search and navigation

Testing Infrastructure

• Unit tests: Co-located *_test.go files throughout codebase
• Integration tests: *_integration_test.go files
• Test workflows: pkg/cli/workflows/ directory
• Test data: Fixtures in pkg/workflow/test_data/

Development Tools

• Makefile: Comprehensive build, test, lint targets
• Scripts: Automation in scripts/
• Custom Actions: 2 reusable GitHub Actions in actions/
• Skills: 25 AI agent skill definitions for specialized tasks

Repository Health Indicators

✅ Well-Organized: Clear separation of concerns across packages
✅ Well-Documented: 474 markdown files, dedicated docs/ directory
✅ Well-Tested: Test files throughout, dedicated test data
✅ Actively Maintained: 168 workflow definitions demonstrate heavy usage
✅ Developer-Friendly: Comprehensive AGENTS.md, skills/, specs/

⚠️ Large Compiled Artifacts: Compiled workflows are 47 MB (consider cleanup strategies)
⚠️ High File Count: 1,996 files may impact repository operations

Size Optimization Opportunities

1. Compiled Workflows (47 MB): Consider archiving old .lock.yml files
2. JavaScript Bundle Size (2.9 MB): Review pkg/workflow/js/ for optimization
3. Test Data (128 KB): Ensure test fixtures are minimal and necessary

Visualization Legend

• Bar Scale: Each █ represents ~2% of repository size
• Symbols: 📁 directory, 📄 file, 🔧 config, 📚 docs, 🧪 tests
• Percentages: Relative to total repository size (69 MB)

---

Analysis Date: December 22, 2024
Workflow Run: §20435610539
Generated by: Repository Tree Map Generator

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.