Repository Tree Map - December 2025

[github-actions[bot]]

This tree map provides a comprehensive visualization of the gh-aw repository structure, showing directory hierarchies, file distributions, and size metrics.

The repository contains 1,172 files totaling 29 MB, with the majority being Go source code (607 files) and extensive test coverage (412 test files, 67.7% coverage). The largest component is the .github/workflows directory at 18 MB, containing 110 source workflow files and 77 compiled .lock.yml files.

📊 Full Repository Tree Map

ASCII Tree Map Visualization

gh-aw Repository [1,172 files, 29 MB]
│
├─ 📁 .github/ [319 files, 18 MB] ████████████████████░░░░░░░░░░ 62.1%
│  │
│  ├─ 📁 workflows/ [187 files, 18 MB] ████████████████████░░░░░░░░░░ 62.1%
│  │  ├─ 📄 *.lock.yml [77 files, 16 MB] ██████████████████░░░░░░░░░░ 55.2%
│  │  └─ 📄 *.md [110 files, 2 MB] ████░░░░░░░░░░░░░░░░░░░░░░░░░░ 6.9%
│  │
│  ├─ 📁 instructions/ [15 files, 212 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.7%
│  │  ├─ 🔧 github-agentic-workflows.instructions.md [98 KB]
│  │  ├─ 🔧 developer.instructions.md [45 KB]
│  │  └─ 🔧 [13 other instruction files]
│  │
│  ├─ 📁 agents/ [7 files, 84 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.3%
│  │
│  ├─ 📁 copilot/ [5 files, 56 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.2%
│  │
│  └─ 📁 actions/ [4 files, 40 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.1%
│
├─ 📁 pkg/ [761 files, 8.9 MB] ███████████░░░░░░░░░░░░░░░░░░░ 30.7%
│  │
│  ├─ 📁 workflow/ [283 files, 5.8 MB] ███████████░░░░░░░░░░░░░░░░░░░ 20.0%
│  │  ├─ 🔧 compiler.go [1596 lines, 47 KB]
│  │  ├─ 🔧 permissions.go [905 lines, 32 KB]
│  │  ├─ 📁 js/ [85 files, 1.2 MB] ████░░░░░░░░░░░░░░░░░░░░░░░░░░ 4.1%
│  │  │  ├─ 📄 *.cjs [85 CommonJS modules]
│  │  │  ├─ 🧪 *.test.cjs [comprehensive test suite]
│  │  │  └─ 🔧 [embedded JavaScript for GitHub Actions]
│  │  └─ 🧪 *_test.go [195 test files]
│  │
│  ├─ 📁 cli/ [156 files, 2.3 MB] ███████░░░░░░░░░░░░░░░░░░░░░░░ 7.9%
│  │  ├─ 🔧 compile_command.go [458 lines]
│  │  ├─ 🔧 logs.go [workflow log analysis]
│  │  ├─ 🔧 audit_command.go [failure investigation]
│  │  ├─ 🔧 mcp_*.go [MCP server management]
│  │  └─ 🧪 *_test.go [97 test files]
│  │
│  ├─ 📁 parser/ [186 files, 616 KB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.1%
│  │  ├─ 📁 schemas/ [3 JSON schemas]
│  │  │  ├─ 🔧 main_workflow_schema.json
│  │  │  ├─ 🔧 included_file_schema.json
│  │  │  └─ 🔧 mcp_config_schema.json
│  │  └─ 🧪 *_test.go [78 test files]
│  │
│  ├─ 📁 console/ [44 files, 108 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.4%
│  │  ├─ 🔧 render.go [struct tag-based rendering]
│  │  └─ 🧪 *_test.go [18 test files]
│  │
│  ├─ 📁 logger/ [20 files, 36 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.1%
│  │
│  └─ 📁 constants/ [14 files, 24 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.1%
│
├─ 📁 docs/ [65 files, 1012 KB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3.5%
│  ├─ 📚 Astro Starlight documentation site
│  ├─ 📁 src/ [55 files, 692 KB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.4%
│  │  ├─ 📁 content/ [documentation pages]
│  │  └─ 📁 components/ [Astro components]
│  └─ 🔧 astro.config.mjs, package.json
│
├─ 📁 cmd/ [7 files, 48 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.2%
│  └─ 📁 gh-aw/ [7 files, 44 KB]
│     └─ 🔧 main.go [CLI entry point]
│
├─ 📁 scripts/ [7 files, 84 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.3%
│  ├─ 🔧 changeset.js [release automation]
│  └─ 🔧 *.sh [build scripts]
│
├─ 📁 specs/ [4 files, 136 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.5%
│  └─ 📄 *.md [specification documents]
│
└─ 📁 Root Files [9 files, 744 KB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.6%
   ├─ 📚 README.md, DEVGUIDE.md, CONTRIBUTING.md
   ├─ 📚 AGENTS.md [AI agent instructions]
   ├─ 🔧 go.mod, go.sum [Go dependencies]
   ├─ 🔧 Makefile [build automation]
   └─ 🔧 install-gh-aw.sh [standalone installer]

📈 Repository Statistics

File Distribution by Type

Extension	Count	Percentage	Purpose
.go	610	52.0%	Go source code
.md	288	24.6%	Documentation & workflows
.yml	92	7.9%	YAML configs & compiled workflows
.cjs	85	7.3%	CommonJS modules (GitHub Actions)
.json	28	2.4%	Configuration files
.sh	11	0.9%	Shell scripts
Other	58	4.9%	Various support files
Total	1,172	100%

Code Quality Metrics

• Test Coverage: 67.7% (412 test files out of 607 Go files)
• Lines of Code (Go): ~150,000+ lines
• Largest Go File: compiler.go (1,596 lines)
• Average Go File Size: ~8.5 KB
• Test-to-Code Ratio: 0.68 (strong test coverage)

Directory Size Breakdown

Directory	Size	Files	Percentage	Description
.github/workflows/	18 MB	187	62.1%	Agentic workflows (source + compiled)
pkg/workflow/	5.8 MB	283	20.0%	Core workflow compiler engine
pkg/cli/	2.3 MB	156	7.9%	CLI command implementations
docs/	1.0 MB	65	3.5%	Documentation site (Astro Starlight)
pkg/parser/	616 KB	186	2.1%	Frontmatter parsing & validation
Other	1.2 MB	295	4.4%	Supporting files & utilities
Total	29 MB	1,172	100%

🏆 Largest Files (Top 10)

File	Size	Type	Purpose
poem-bot.lock.yml	392 KB	Workflow	Compiled agentic workflow
q.lock.yml	320 KB	Workflow	Compiled agentic workflow
unbloat-docs.lock.yml	304 KB	Workflow	Documentation optimization
pr-nitpick-reviewer.lock.yml	296 KB	Workflow	PR review automation
technical-doc-writer.lock.yml	292 KB	Workflow	Documentation generation
craft.lock.yml	292 KB	Workflow	Compiled agentic workflow
tidy.lock.yml	288 KB	Workflow	Code cleanup automation
grumpy-reviewer.lock.yml	280 KB	Workflow	Critical code review
daily-test-improver.lock.yml	280 KB	Workflow	Test enhancement automation
daily-perf-improver.lock.yml	276 KB	Workflow	Performance optimization

Note: All top 10 largest files are compiled workflows (.lock.yml), demonstrating the complexity of the agentic workflow compilation process.

🔍 Key Insights

Repository Structure Highlights

1. Workflow-Heavy Repository

   • 62% of total size is compiled GitHub Actions workflows
   • 110 source workflows compile to 77 .lock.yml files
   • Average compiled workflow size: ~234 KB

2. Strong Testing Culture

   • 412 test files provide 67.7% coverage
   • Comprehensive test suites in all major packages
   • Integration tests alongside unit tests

3. JavaScript Integration

   • 85 CommonJS modules embedded in workflows
   • Extensive use of actions/github-script for GitHub API
   • JavaScript bundler for workflow compilation

4. Modular Architecture

   • Clear separation: CLI, Parser, Workflow Engine, Console
   • Small, focused files (average Go file: 246 lines)
   • Domain-specific validation distributed across packages

5. Documentation-Driven

   • 288 markdown files throughout repository
   • Dedicated docs/ site using Astro Starlight
   • Extensive inline documentation in instruction files

Development Patterns

• Go-First: 52% of files are Go source code
• Markdown-Rich: 24.6% markdown (docs + workflows)
• Test-Driven: 35% of Go files are tests
• Modular Design: Many small files vs few large files
• Embedded Resources: JavaScript and schemas embedded via //go:embed

Size Distribution

Workflows (62%) ████████████████████░░░░░░░░░░
Core Engine (20%) ████████░░░░░░░░░░░░░░░░░░░░░░
CLI Tools (8%)    ████░░░░░░░░░░░░░░░░░░░░░░░░░░
Docs (4%)         ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░
Other (6%)        ███░░░░░░░░░░░░░░░░░░░░░░░░░░░

🎯 Repository Purpose

GitHub Agentic Workflows (gh-aw) is a Go-based GitHub CLI extension that enables writing agentic workflows in natural language using markdown files with YAML frontmatter. These workflows compile to GitHub Actions and leverage AI coding agents (Copilot, Claude, Codex) for automated software development tasks.

Core Components:

• 🔧 Workflow Compiler: Transforms markdown + YAML → GitHub Actions YAML
• 🤖 AI Engine Support: Integrates with multiple AI coding agents
• 📡 MCP Integration: Model Context Protocol for tool extensibility
• 🔍 Log Analysis: Download and analyze workflow execution logs
• 🛡️ Security: Safe outputs, permission management, expression validation

---

Generated: December 10, 2025
Tool: Repository Tree Map Generator

AI generated by Repository Tree Map Generator

[pelikhan]

/q update treemap workflow to write the report as a markdown file in specs/filetree.md (create pull request)

[github-actions[bot]]

Agentic Q triggered by this discussion comment.

[github-actions[bot]]

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