Repository Tree Map - November 17, 2025

[github-actions[bot]]

🗺️ Repository Tree Map Visualization

This repository contains 1,308 files totaling 32 MB of code and documentation for the GitHub Agentic Workflows (gh-aw) CLI extension. The project is primarily written in Go (700 files) with markdown documentation (308 files) and JavaScript components (103 files) for GitHub Actions integration.

The largest components are the workflows directory (20 MB, 62.5% of repo) containing 118 agentic workflow definitions and their compiled outputs, followed by the Go packages (9.8 MB, 30.6%) implementing the core CLI functionality.

📊 ASCII Tree Map Visualization

gh-aw Repository Structure
══════════════════════════════════════════════════════════════════════
Total: 1,308 files | 32 MB | Max depth: 4 levels

githubnext/gh-aw/ [1,308 files, 32.0 MB]
│
├─ 📁 .github/ [270 files, 20.2 MB] ████████████████████████████░░░░░░ 63.1%
│  │
│  ├─ 📁 workflows/ [201 files, 20.0 MB] ████████████████████████████░░ 62.5%
│  │  ├─ 📄 *.lock.yml [83 files, 18.8 MB] ██████████████████████░░ Compiled workflows
│  │  ├─ 📄 *.md [118 files, 1.2 MB] ████░░░░ Workflow definitions
│  │  ├─ 📁 shared/ [40 files] ██░░ Shared components
│  │  │  ├─ 📁 mcp/ [24 files] █░ MCP server configs
│  │  │  └─ 📄 *.md [16 files] █░ Reusable snippets
│  │  └─ 📁 tests/ [4 files] ░ Test workflows
│  │
│  ├─ 📁 instructions/ [17 files, 224 KB] █░░░ Development guides
│  ├─ 📁 agents/ [8 files, 92 KB] ░░░ Custom agent configs
│  ├─ 📁 copilot/ [7 files, 56 KB] ░░░ Copilot instructions
│  └─ 📁 actions/ [4 files, 40 KB] ░░░ Custom actions

├─ 📁 pkg/ [694 files, 9.8 MB] ███████████░░░░░░░░░░░░░░░░░░░░░░░░░░ 30.6%
│  │
│  ├─ 📁 workflow/ [323 files, 6.4 MB] ████████████████████░░░░ 20.0%
│  │  ├─ 🔧 *.go [217 files, 5.2 MB] ████████████████░░ Core compiler
│  │  ├─ 📁 js/ [103 files, 1.1 MB] ████░░ JavaScript modules
│  │  │  ├─ 📄 *.cjs [55 files] ██░ CommonJS scripts
│  │  │  └─ 🧪 *.test.cjs [48 files] ██░ JS unit tests
│  │  └─ 📁 schemas/ [3 files, 29 KB] ░ JSON schemas
│  │
│  ├─ 📁 cli/ [276 files, 2.6 MB] ████████░░░░░░░░ 8.1%
│  │  ├─ 🔧 *.go [138 files, 1.8 MB] ██████░ CLI commands
│  │  └─ 🧪 *_test.go [138 files, 0.8 MB] ███░ Go tests
│  │
│  ├─ 📁 parser/ [55 files, 668 KB] ██░░░░ 2.1%
│  │  ├─ 🔧 *.go [52 files] ██░ Frontmatter parsing
│  │  └─ 📁 schemas/ [3 files] ░ Schema definitions
│  │
│  ├─ 📁 console/ [24 files, 108 KB] ░░░ 0.3%
│  └─ 📁 logger/ [8 files, 36 KB] ░░ 0.1%

├─ 📚 docs/ [77 files, 1.1 MB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3.4%
│  ├─ 📁 src/content/docs/ [54 files, 704 KB] ██░░ Documentation
│  │  ├─ 📁 reference/ [16 files] █░ API reference
│  │  ├─ 📁 guides/ [7 files] ░ How-to guides
│  │  ├─ 📁 setup/ [5 files] ░ Setup instructions
│  │  └─ 📁 examples/ [11 files] ░ Usage examples
│  ├─ 📄 package-lock.json [1 file, 240 KB] █░ NPM dependencies
│  ├─ 🔧 astro.config.mjs [1 file, 5.5 KB] ░ Astro config
│  └─ 🧪 tests/ [3 files, 13 KB] ░ E2E tests

├─ 📁 specs/ [14 files, 172 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.5%
│  └─ 📄 *.md Technical specifications

├─ 📁 scripts/ [10 files, 104 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.3%
│  ├─ 📄 *.sh [5 files] Shell utilities
│  └─ 🔧 *.js [3 files] Node.js scripts

├─ 📁 cmd/gh-aw/ [4 files, 56 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.2%
│  └─ 🔧 main.go CLI entry point

└─ 📄 Root files [22 files, 148 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.5%
   ├─ 📄 CHANGELOG.md [58 KB] Release history
   ├─ 📄 Makefile [11 KB] Build automation
   ├─ 📄 AGENTS.md [10 KB] Agent documentation
   ├─ 🔧 go.mod, go.sum [17 KB] Go dependencies
   └─ 📚 *.md [52 KB] Project docs

📈 Detailed Statistics

Repository Metrics

File Type Distribution

Extension	Count	Percentage	Purpose
.go	694	53.1%	Core implementation
.md	308	23.5%	Documentation
.cjs	103	7.9%	JavaScript modules
.yml	98	7.5%	Compiled workflows & CI
.json	29	2.2%	Configuration
.sh	11	0.8%	Shell scripts
.ts	8	0.6%	TypeScript tests
.astro	8	0.6%	Documentation UI
Others	49	3.7%	Misc files

Largest Files (Top 15)

Size	File	Purpose
404 KB	.github/workflows/poem-bot.lock.yml	Compiled workflow
332 KB	.github/workflows/cloclo.lock.yml	Compiled workflow
324 KB	.github/workflows/q.lock.yml	Compiled workflow
308 KB	.github/workflows/unbloat-docs.lock.yml	Compiled workflow
300 KB	.github/workflows/pr-nitpick-reviewer.lock.yml	Compiled workflow
300 KB	.github/workflows/craft.lock.yml	Compiled workflow
296 KB	.github/workflows/tidy.lock.yml	Compiled workflow
296 KB	.github/workflows/technical-doc-writer.lock.yml	Compiled workflow
284 KB	.github/workflows/grumpy-reviewer.lock.yml	Compiled workflow
276 KB	.github/workflows/changeset.lock.yml	Compiled workflow
272 KB	.github/workflows/python-data-charts.lock.yml	Compiled workflow
272 KB	.github/workflows/mergefest.lock.yml	Compiled workflow
272 KB	.github/workflows/daily-news.lock.yml	Compiled workflow
272 KB	.github/workflows/copilot-session-insights.lock.yml	Compiled workflow
268 KB	.github/workflows/smoke-detector.lock.yml	Compiled workflow

Directory Size Breakdown

Directory	Size	Files	Percentage	Description
.github/workflows	20.0 MB	201	62.5%	Agentic workflows (118 .md + 83 .lock.yml)
pkg/workflow	6.4 MB	323	20.0%	Workflow compiler & JS modules
pkg/cli	2.6 MB	276	8.1%	CLI command implementations
docs	1.1 MB	77	3.4%	Astro-based documentation
pkg/parser	668 KB	55	2.1%	Frontmatter & YAML parsing
.github/instructions	224 KB	17	0.7%	Development guidelines
specs	172 KB	14	0.5%	Technical specifications
.github/agents	92 KB	8	0.3%	Custom agent definitions
pkg/console	108 KB	24	0.3%	Console rendering utilities
scripts	104 KB	10	0.3%	Build & utility scripts

Code Composition

Go Codebase (pkg/ directory):

• 694 Go files (53.1% of all files)
• 9.8 MB of Go source code
• 323 files in workflow compiler (largest package)
• 276 files in CLI commands
• 50% test coverage (347 test files)

JavaScript/TypeScript:

• 103 CommonJS modules for GitHub Actions
• 48 test files for JS unit tests
• 8 TypeScript files for documentation tests

Documentation:

• 308 Markdown files total
• 118 workflow definitions (.github/workflows/*.md)
• 77 documentation pages (Astro Starlight)
• 17 instruction files for developers

Configuration:

• 83 compiled workflows (.lock.yml)
• 29 JSON files (schemas, configs, package manifests)
• 11 shell scripts for automation

🎯 Key Observations

Repository Structure Insights

1. Workflow-Centric Design 🎭

The .github/workflows/ directory dominates the repository at 62.5% of total size. This reflects the project's core mission: enabling agentic workflows through markdown definitions that compile to GitHub Actions YAML.

• 118 workflow definitions in markdown format
• 83 compiled workflows (*.lock.yml) averaging 240 KB each
• 40 shared components for reusability
• 24 MCP server configurations for tool integration

2. Comprehensive Go Implementation 🔧

The pkg/ directory contains a well-organized Go codebase with clear separation of concerns:

• Compiler (pkg/workflow/): 323 files, 6.4 MB - Transforms markdown to GitHub Actions YAML
• CLI (pkg/cli/): 276 files, 2.6 MB - Command implementations (compile, logs, audit, mcp)
• Parser (pkg/parser/): 55 files, 668 KB - Frontmatter and YAML processing
• Utilities: Console rendering, logging, constants

3. JavaScript Integration 📜

103 CommonJS modules provide GitHub Actions runtime functionality:

• Safe output processing (create issues, PRs, discussions)
• Log parsing for AI engines (Copilot, Claude, Codex)
• Content sanitization and validation
• 48 test files ensure reliability

4. Documentation Excellence 📚

Multi-layered documentation strategy:

• User docs: 77 Astro Starlight pages with guides, references, examples
• Developer guides: 17 instruction files in .github/instructions/
• Workflow examples: 118 real-world agentic workflow definitions
• Technical specs: 14 specification documents

5. Test Coverage 🧪

Strong testing discipline across the codebase:

• 347 Go test files (50% of Go files are tests)
• 48 JavaScript test files (47% of JS files are tests)
• E2E tests for documentation with Playwright
• Integration tests for CLI commands

6. Development Tooling 🛠️

Rich automation and developer experience:

• Makefile with 11 KB of build targets
• 10 shell scripts for utilities
• 3 Node.js scripts for changesets and versioning
• Custom GitHub actions for CI/CD

🔍 File Density Analysis

Files per Directory (High-Activity Areas)

Directory	File Count	Avg Size	Activity Level
.github/workflows/	173	119 KB	🔥🔥🔥 Very High
.github/workflows/shared/mcp/	24	12 KB	🔥🔥 High
.github/instructions/	17	13 KB	🔥🔥 High
docs/src/content/docs/reference/	16	44 KB	🔥🔥 High
.github/workflows/shared/	16	14 KB	🔥 Medium
specs/	14	12 KB	🔥 Medium
scripts/	10	10 KB	🔥 Medium
.github/agents/	8	12 KB	🔥 Medium
docs/src/components/	8	4 KB	🔥 Medium

File Density Insights

High-Density Directories (>15 files):

• .github/workflows/ is the most active area with 173 files
• Workflow shared components have 40 files for reusability
• Documentation reference has 16 files covering all CLI commands

Focused Modules (5-10 files):

• Agent configurations, Copilot instructions, test workflows
• Component directories maintain clean boundaries

Single-Purpose Packages:

• cmd/gh-aw/ has just 4 files for the CLI entry point
• Root directory has 22 configuration and documentation files

---

Generated: November 17, 2025
Repository: githubnext/gh-aw
Commit: Latest HEAD
Tool: Repository Tree Map Generator v1.0

AI generated by Repository Tree Map Generator