Repository Tree Map - November 4, 2025

[github-actions[bot]]

This tree map provides a visual overview of the githubnext/gh-aw repository structure, showing file distribution, directory sizes, and key metrics.

📊 Quick Stats

The repository contains 1,082 files totaling 26 MB (excluding .git). The codebase is primarily Go-based with extensive GitHub Actions workflows and comprehensive documentation.

Key Metrics:

• Primary Language: Go (569 files - 52.6%)
• Documentation: Markdown (273 files - 25.2%)
• Workflows: YAML (86 files - 7.9%)
• JavaScript/CJS: 78 files (7.2%)
• Test Coverage: 387 Go test files + 44 other test files

Complete Repository Structure

🗺️ Visual Tree Map

githubnext/gh-aw [1,082 files, 26 MB]
│
├─ 📁 .github/ [220 files, 16 MB] ████████████████████████████████████████████████████████████████ 61.5%
│  │
│  ├─ 📁 workflows/ [163 files, 16 MB] ██████████████████████████████████████████████████████████ 61.5%
│  │  ├─ 📄 poem-bot.lock.yml [376 KB] ████████░
│  │  ├─ 📄 q.lock.yml [312 KB] ███████░
│  │  ├─ 📄 unbloat-docs.lock.yml [288 KB] ███████░
│  │  ├─ 📄 craft.lock.yml [288 KB] ███████░
│  │  ├─ 📄 technical-doc-writer.lock.yml [284 KB] ██████░
│  │  ├─ 📄 tidy.lock.yml [280 KB] ██████░
│  │  ├─ 📄 changeset.lock.yml [276 KB] ██████░
│  │  ├─ 📄 daily-test-improver.lock.yml [268 KB] ██████░
│  │  ├─ 📄 daily-perf-improver.lock.yml [268 KB] ██████░
│  │  └─ 📁 shared/ [15 files] - Shared workflow components
│  │
│  ├─ 📁 instructions/ [14 files, 156 KB] ███░
│  │  ├─ 📄 github-agentic-workflows.instructions.md
│  │  ├─ 📄 documentation.instructions.md
│  │  ├─ 📄 github-script.instructions.md
│  │  ├─ 📄 copilot-cli.instructions.md
│  │  └─ ... (workflow development guides)
│  │
│  ├─ 📁 agents/ [7 files, 76 KB] ██░
│  │  └─ Custom agent configurations
│  │
│  ├─ 📁 copilot/ [5 files, 56 KB] █░
│  │  └─ Copilot-specific instructions
│  │
│  └─ 📁 actions/ [16 files, 40 KB] █░
│     └─ Custom GitHub Actions
│
├─ 📁 pkg/ [761 files, 8.5 MB] ████████████████████████████████░ 32.7%
│  │
│  ├─ 📁 workflow/ [477 files, 5.6 MB] █████████████████████░ 21.5%
│  │  ├─ 📁 js/ [84 files] - JavaScript compilation targets
│  │  │  ├─ 📄 parse_copilot_log.cjs
│  │  │  ├─ 📄 validate_errors.cjs
│  │  │  ├─ 📄 create_agent_task.cjs
│  │  │  └─ ... (workflow runtime scripts)
│  │  ├─ 📁 sh/ [13 files] - Shell script utilities
│  │  ├─ 📁 test_data/ [5 files] - Test fixtures
│  │  ├─ 📁 data/ [4 files] - Workflow data
│  │  └─ 📄 *.go [377 files] - Workflow compiler & engine logic
│  │
│  ├─ 📁 cli/ [215 files, 2.2 MB] ████████░ 8.5%
│  │  ├─ 📁 workflows/ [66 files] - CLI workflow handlers
│  │  ├─ 📁 templates/ [4 files] - Output templates
│  │  └─ 📄 *.go [149 files] - CLI implementation
│  │
│  ├─ 📁 parser/ [22 files, 572 KB] ██░ 2.2%
│  │  └─ Markdown frontmatter parsing
│  │
│  ├─ 📁 console/ [10 files, 100 KB] ░ 0.4%
│  │  └─ Console output formatting
│  │
│  ├─ 📁 logger/ [4 files, 36 KB] ░ 0.1%
│  │  └─ Debug logging system
│  │
│  └─ 📁 constants/ [3 files, 24 KB] ░ 0.1%
│     └─ Global constants
│
├─ 📁 docs/ [54 files, 888 KB] ███░ 3.4%
│  ├─ 📁 src/ [46 files, 572 KB] - Astro Starlight documentation
│  ├─ 📄 package.json, tsconfig.json
│  └─ Documentation source files
│
├─ 📁 cmd/ [3 files, 44 KB] ░ 0.2%
│  └─ 📁 gh-aw/ [3 files] - CLI entry point
│
├─ 📁 scripts/ [7 files, 68 KB] ░ 0.3%
│  └─ Build and development scripts
│
├─ 📁 specs/ [6 files, 76 KB] ░ 0.3%
│  └─ Specification documents
│
├─ 📁 schemas/ [1 file, 16 KB] ░ 0.1%
│  └─ 📄 agent-output.json - JSON schema
│
└─ 🔧 Root config [24 files, ~100 KB] ░ 0.4%
   ├─ 📄 go.mod, go.sum - Go dependencies
   ├─ 📄 Makefile - Build automation
   ├─ 📄 .golangci.yml - Linter config
   ├─ 📄 .poutine.yml - Security scanner config
   ├─ 📄 README.md, CHANGELOG.md - Project docs
   └─ ... (various config files)

📈 File Type Distribution

Go Source Files       569 files (52.6%) ████████████████████████████████████████████████████░
Markdown              273 files (25.2%) █████████████████████████████░
YAML/YML               86 files (7.9%)  ████████░
CommonJS/JavaScript    73 files (6.7%)  ███████░
JSON                   28 files (2.6%)  ███░
Shell Scripts          11 files (1.0%)  █░
TypeScript              6 files (0.6%)  ░
Other                  36 files (3.3%)  ███░

🔬 Detailed Statistics

Top 10 Largest Files

File	Size	Type
.github/workflows/poem-bot.lock.yml	376 KB	Compiled workflow
.github/workflows/q.lock.yml	312 KB	Compiled workflow
.github/workflows/unbloat-docs.lock.yml	288 KB	Compiled workflow
.github/workflows/craft.lock.yml	288 KB	Compiled workflow
.github/workflows/technical-doc-writer.lock.yml	284 KB	Compiled workflow
.github/workflows/tidy.lock.yml	280 KB	Compiled workflow
.github/workflows/changeset.lock.yml	276 KB	Compiled workflow
.github/workflows/daily-test-improver.lock.yml	268 KB	Compiled workflow
.github/workflows/daily-perf-improver.lock.yml	268 KB	Compiled workflow
.github/workflows/copilot-session-insights.lock.yml	264 KB	Compiled workflow

Note: Most large files are compiled .lock.yml workflows generated from markdown sources.

Directory Size Distribution

Directory	Files	Size	Purpose
.github/workflows/	163	16 MB	Agentic workflows (markdown + compiled YAML)
pkg/workflow/	477	5.6 MB	Workflow compilation engine
pkg/cli/	215	2.2 MB	Command-line interface
docs/	54	888 KB	Astro Starlight documentation
pkg/parser/	22	572 KB	Markdown frontmatter parser
.github/instructions/	14	156 KB	Development guidelines
pkg/console/	10	100 KB	Console output formatting
.github/agents/	7	76 KB	Custom agent configs
specs/	6	76 KB	Specification documents
scripts/	7	68 KB	Build scripts

File Concentration Hotspots

Directories with the most files (indicating active development):

• pkg/workflow/ - 377 Go files (workflow engine core)
• pkg/cli/ - 149 Go files (CLI commands)
• .github/workflows/ - 148 workflow files (agentic workflows)
• pkg/workflow/js/ - 84 JavaScript files (runtime scripts)
• pkg/cli/workflows/ - 66 Go files (workflow management)

Test Coverage Overview

• Go Test Files: 387 files (68% of Go source files have tests)
• JavaScript Tests: 44 files
• Total Test Files: 431 files (39.8% of repository)

🏗️ Repository Architecture

Core Components

1. Workflow Compiler (pkg/workflow/)

• Converts markdown agentic workflows to GitHub Actions YAML
• Supports multiple AI engines (Copilot, Claude, Codex, Custom)
• MCP server integration and tool management
• Safe outputs processing

2. CLI Interface (pkg/cli/)

• compile - Workflow compilation
• logs - Workflow run analysis and cost tracking
• mcp - MCP server inspection and management
• audit - Workflow failure investigation

3. Documentation System (docs/)

• Astro Starlight-based documentation site
• Diátaxis framework (tutorials, how-tos, reference, explanation)
• Comprehensive API and CLI reference

4. GitHub Actions Workflows (.github/workflows/)

• 148+ agentic workflows demonstrating the system
• Markdown source files (.md) compile to .lock.yml
• Shared workflow components in shared/ directory

Configuration Files

• .golangci.yml - Go linter configuration
• .poutine.yml - Supply chain security scanner
• .github/zizmor.yml - Security vulnerability scanner
• .github/actionlint.yaml - GitHub Actions linter
• .prettierrc.json - Code formatting
• Makefile - Build automation and development tasks

🎯 Key Insights

1. Workflow-Centric Design: Over 60% of repository size is GitHub Actions workflows, showcasing extensive real-world usage examples.

2. Test-Driven Development: 431 test files (39.8% of total) indicate strong testing practices.

3. Comprehensive Documentation: 273 markdown files + dedicated docs site demonstrate commitment to user education.

4. Modular Architecture: Clear separation between workflow engine (pkg/workflow/), CLI (pkg/cli/), and utilities.

5. JavaScript Integration: 84 CommonJS files for GitHub Actions runtime scripts, showing polyglot approach.

6. Security Focus: Multiple security scanner configurations (poutine, zizmor, actionlint) built into the development workflow.

---

Generated: 2025-11-04 22:41 UTC
Repository: githubnext/gh-aw
Analysis Tool: gh-aw 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 1 week ago.