Repository Tree Map - November 24, 2025

[github-actions[bot]]

📊 GitHub Agentic Workflows Repository Tree Map

This repository contains 1,447 files totaling 39 MB, organized across a maximum depth of 6 directory levels. The codebase is primarily Go-based (746 files) with extensive workflow definitions (141 markdown workflows, 102 compiled YAML files) and comprehensive documentation.

The largest components are the .github/workflows directory (26 MB, mostly compiled workflow files) and the pkg directory (11 MB of Go source code). The repository demonstrates a well-organized structure with clear separation between workflow definitions, core packages, documentation, and tooling.

📁 Full ASCII Tree Map Visualization

gh-aw Repository Tree Map
═════════════════════════════════════════════════════════════════

Repository Root [1,447 files, 39 MB]
│
├─ 📁 .github/ [371 files, 26 MB] ████████████████████████████████████████████░░░░░░ 67%
│  │
│  ├─ 📄 workflows/ [243 files, 26 MB] ████████████████████████████████████████████░░░░ 66%
│  │  ├─ *.lock.yml [102 files, ~25 MB] ██████████████████████████████████████████░░░░
│  │  │  └─ Largest: poem-bot.lock.yml (428 KB)
│  │  │              cloclo.lock.yml (356 KB)
│  │  │              q.lock.yml (348 KB)
│  │  │
│  │  └─ *.md [141 files, ~1 MB] ████░░
│  │     └─ Total: 25,030 lines of workflow definitions
│  │
│  ├─ 📚 instructions/ [18 files, 244 KB] ███░░
│  │  └─ Development guidelines and patterns
│  │
│  ├─ 🔧 agents/ [~10 files, 112 KB] ██░░
│  │  └─ Custom agent configurations
│  │
│  ├─ 📄 copilot/ [~5 files, 56 KB] █░░
│  │  └─ Copilot-specific instructions
│  │
│  └─ 🔧 actions/ [~4 files, 40 KB] █░░
│     └─ Custom GitHub Actions
│
├─ 📁 pkg/ [996 files, 11 MB] ████████████████████░░░░░░░░░░ 28%
│  │
│  ├─ 📄 workflow/ [611 files, 7.0 MB] ██████████████████░░ 18%
│  │  ├─ *.go [471 files, ~5.5 MB] ██████████████░░
│  │  │  └─ Workflow compilation & engine logic
│  │  │
│  │  ├─ *.cjs [68 files, ~800 KB] ███░░
│  │  │  └─ JavaScript workflow components
│  │  │
│  │  └─ *.test.cjs [72 files, ~700 KB] ██░░
│  │     └─ JavaScript test suites
│  │
│  ├─ 📄 cli/ [210 files, 2.9 MB] ███████░░ 7%
│  │  └─ *.go [210 files] ███████░░
│  │     └─ CLI commands & MCP servers
│  │
│  ├─ 📄 parser/ [36 files, 708 KB] ██░░ 2%
│  │  └─ *.go [36 files] ██░░
│  │     └─ Frontmatter & YAML parsing
│  │
│  ├─ 📄 console/ [~15 files, 108 KB] █░░
│  │  └─ Console rendering utilities
│  │
│  ├─ 📄 logger/ [~8 files, 36 KB] ░░
│  │  └─ Debug logging system
│  │
│  └─ 📄 constants/ [~5 files, 32 KB] ░░
│     └─ Shared constants
│
├─ 📁 docs/ [59 files, 1.1 MB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3%
│  │
│  └─ 📚 src/ [~55 files, 744 KB] ██░░
│     ├─ *.md [~40 files] ██░░
│     ├─ *.mdx [~10 files] ░░
│     └─ *.astro [~8 files] ░░
│        └─ Astro Starlight documentation
│
├─ 📁 specs/ [~12 files, 184 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ <1%
│  └─ 📄 Technical specifications
│
├─ 📁 scripts/ [~8 files, 104 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ <1%
│  └─ 🔧 Build & utility scripts
│
├─ 📁 cmd/ [~6 files, 64 KB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ <1%
│  │
│  └─ 📁 gh-aw/ [~6 files, 60 KB] ░░
│     └─ CLI entry point
│
├─ 📁 schemas/ [~4 files, ~20 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ <1%
│  └─ 🔧 JSON schema definitions
│
└─ 📄 Root Files [~10 files, ~50 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░ <1%
   ├─ Makefile
   ├─ go.mod, go.sum
   ├─ README.md, CHANGELOG.md
   └─ License & docs

📈 Detailed Statistics

Repository Overview

Metric	Value
Total Files	1,447 files
Total Size	39 MB
Max Depth	6 directory levels
Primary Language	Go (51.6% of files)
Secondary Language	Markdown (23.8% of files)

File Type Distribution

Extension	Count	Percentage	Purpose
.go	746	51.6%	Go source code
.md	345	23.8%	Documentation & workflows
.cjs	140	9.7%	JavaScript modules (68 source + 72 tests)
.yml	117	8.1%	Compiled workflows & configs
.json	32	2.2%	Configuration files
.sh	11	0.8%	Shell scripts
.ts	9	0.6%	TypeScript definitions
.astro	8	0.6%	Astro documentation
Other	39	2.7%	Various support files

Code Distribution by Package

Package	Go Files	Purpose
pkg/workflow/	471	Workflow compilation & engine logic
pkg/cli/	210	CLI commands & MCP servers
pkg/parser/	36	Frontmatter & YAML parsing
Other pkg/	22	Console, logger, constants
Total	739	Core Go codebase

JavaScript Components

Type	Count	Size	Purpose
Source files	68	~800 KB	Workflow JavaScript components
Test files	72	~700 KB	JavaScript test suites
Total	140	~1.5 MB	JavaScript ecosystem

Largest Files (Top 10)

File	Size	Type
.github/workflows/poem-bot.lock.yml	428 KB	Compiled workflow
.github/workflows/cloclo.lock.yml	356 KB	Compiled workflow
.github/workflows/q.lock.yml	348 KB	Compiled workflow
.github/workflows/copilot-session-insights.lock.yml	340 KB	Compiled workflow
.github/workflows/unbloat-docs.lock.yml	332 KB	Compiled workflow
.github/workflows/pr-nitpick-reviewer.lock.yml	332 KB	Compiled workflow
.github/workflows/technical-doc-writer.lock.yml	328 KB	Compiled workflow
.github/workflows/python-data-charts.lock.yml	324 KB	Compiled workflow
.github/workflows/daily-news.lock.yml	324 KB	Compiled workflow
.github/workflows/craft.lock.yml	320 KB	Compiled workflow

Largest Directories

Directory	Size	File Count	Percentage
.github/workflows/	26 MB	243	66.7%
pkg/workflow/	7.0 MB	611	17.9%
pkg/cli/	2.9 MB	210	7.4%
docs/	1.1 MB	59	2.8%
pkg/parser/	708 KB	36	1.8%

Workflow Statistics

Metric	Value
Workflow Definitions (.md)	141 files
Compiled Workflows (.lock.yml)	102 files
Total Workflow Lines	25,030 lines
Workflow Directory Size	26 MB
Average Workflow Size	~250 KB (compiled)

Documentation Assets

Category	Count	Location
Main Documentation	59 files	docs/src/
Developer Instructions	18 files	.github/instructions/
Agent Configurations	~10 files	.github/agents/
Copilot Instructions	~5 files	.github/copilot/
Specifications	~12 files	specs/

🎯 Key Insights

Repository Characteristics

1. Workflow-Heavy Repository: With 66.7% of repository size dedicated to compiled workflows, this is clearly a repository focused on GitHub Actions automation and agentic workflow orchestration.

2. Go-First Architecture: 51.6% of files are Go source code, with a well-organized package structure separating workflow compilation (pkg/workflow/), CLI functionality (pkg/cli/), and parsing logic (pkg/parser/).

3. Comprehensive Testing: 72 JavaScript test files (*.test.cjs) demonstrate strong test coverage for the JavaScript components, complementing the Go test suite.

4. Rich Documentation: 59 documentation files using Astro Starlight framework, plus 18 developer instruction files and numerous agent configurations, show commitment to developer experience.

5. JavaScript Integration: 140 CommonJS files provide JavaScript-based workflow components that integrate with the Go compiler, creating a hybrid execution environment.

Notable Patterns

• Workflow Compilation: Each .md workflow file compiles to a .lock.yml file, with the compiled versions being significantly larger (averaging 250 KB vs source markdown).

• Modular Package Design: The pkg/ directory is well-organized with clear separation of concerns: workflow/ for compilation, cli/ for commands, parser/ for frontmatter processing.

• Multi-Language Strategy: Go for core tooling and compilation, JavaScript for runtime workflow components, creating a powerful hybrid system.

• Documentation-as-Code: Extensive instruction files in .github/instructions/ provide AI agents with context-specific guidance for different parts of the codebase.

---

Generated: November 24, 2025
Repository: githubnext/gh-aw
Analysis Tool: Repository Tree Map Generator

AI generated by Repository Tree Map Generator