Repository Tree Map - October 11, 2025

[github-actions[bot]]

🗺️ GitHub Agentic Workflows Repository Tree Map

Generated: October 11, 2025
Total Files: 617 files
Total Size: 9.91 MB
Repository: githubnext/gh-aw

---

📊 Repository Statistics

Overall Metrics

• Total Files: 617
• Total Size: 9.91 MB (excluding .git, node_modules, vendor)
• Maximum Directory Depth: ~5-6 levels
• Primary Language: Go (346 files)
• Documentation: Markdown (184 files)

File Type Distribution

Extension	Count	Total Size	Avg Size
.go	346 files	~4.5 MB	13 KB
.md	184 files	~5.2 MB	29 KB
.cjs	50 files	~890 KB	18 KB
.yml	38 files	~260 KB	7 KB
.json	21 files	~120 KB	6 KB
.sh	12 files	~25 KB	2 KB
Other	16 files	~100 KB	-

---

🌲 ASCII Tree Map Visualization

gh-aw/ [617 files, 9.91 MB]
│
├─ 📁 .github/ [78 files, 4.92 MB] ████████████████████░░░░░░░░ 49.7%
│  ├─ 📁 workflows/ [68 files, 4.83 MB] ███████████████████░░
│  │  ├─ 📄 *.md (workflow definitions)
│  │  ├─ 📄 *.lock.yml (compiled workflows)
│  │  └─ 📁 shared/ [7 files, 47 KB]
│  │     └─ 🔧 Common workflow components
│  ├─ 📁 instructions/ [5 files, 56 KB]
│  │  └─ 📄 *.instructions.md (coding guidelines)
│  └─ 📁 prompts/ [5 files, 41 KB]
│     └─ 📄 AI agent prompts
│
├─ 📁 pkg/ [489 files, 4.51 MB] ██████████████████████░░░░░░ 45.5%
│  ├─ 📁 workflow/ [307 files, 3.03 MB] ██████████████░░
│  │  ├─ 📁 js/ [55 files, 871 KB] ████░░
│  │  │  ├─ 📄 *.cjs (GitHub Actions scripts)
│  │  │  └─ 🧪 *.test.cjs (unit tests)
│  │  ├─ 📁 test_data/ [5 files, 116 KB]
│  │  ├─ 📁 schemas/ [1 file, 95 KB]
│  │  ├─ 📁 sh/ [12 files, 8 KB]
│  │  └─ 🔧 *.go (workflow compilation engine)
│  ├─ 📁 cli/ [152 files, 1.03 MB] ██████░░
│  │  ├─ 📁 workflows/ [64 files, 174 KB]
│  │  │  └─ 🧪 Test workflow files
│  │  ├─ 📁 templates/ [3 files, 52 KB]
│  │  └─ 🔧 *.go (CLI commands)
│  ├─ 📁 parser/ [24 files, 424 KB] ██░░
│  │  ├─ 📁 schemas/ [3 files, 114 KB]
│  │  └─ 🔧 YAML frontmatter parsing
│  ├─ 📁 console/ [5 files, 30 KB] ░░
│  │  └─ 🔧 Terminal output formatting
│  └─ 📁 constants/ [1 file, 7 KB] ░░
│     └─ 🔧 Global constants
│
├─ 📚 docs/ [12 files, 0.35 MB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3.6%
│  ├─ 📁 src/ [2 files, 97 KB]
│  │  └─ 📁 assets/ [1 file, 96 KB]
│  │     └─ 🖼️  Logo and branding
│  ├─ 📁 public/ [1 file, 1 KB]
│  ├─ 📄 package.json
│  ├─ 📄 astro.config.mjs
│  └─ 🔧 Astro Starlight documentation
│
├─ 📁 cmd/ [3 files, 0.02 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.2%
│  └─ 📁 gh-aw/ [3 files, 24 KB]
│     └─ 🔧 CLI entry point (main.go)
│
├─ 📁 schemas/ [1 file, 0.01 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.1%
│  └─ 📄 JSON schema definitions
│
├─ 📁 scripts/ [1 file, 0.02 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.2%
│  └─ 📄 Utility scripts
│
├─ 📁 .changeset/ [6 files, 3 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.0%
│  └─ 📄 Release changesets
│
├─ 📁 .devcontainer/ [2 files, 2 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.0%
│  └─ 🔧 VS Code dev container config
│
├─ 📁 .vscode/ [4 files, 1 KB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.0%
│  └─ 🔧 Editor settings
│
└─ 📄 Root Files [21 files, 0.06 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0.6%
   ├─ 📚 AGENTS.md (6.4 KB) - AI coding guidelines
   ├─ 📚 DEVGUIDE.md (6.0 KB) - Development guide
   ├─ 📚 Makefile (6.8 KB) - Build automation
   ├─ 📚 README.md (3.6 KB) - Project overview
   ├─ 📚 TESTING.md (4.0 KB) - Test guidelines
   ├─ 📚 CONTRIBUTING.md (4.5 KB)
   ├─ 🔧 go.mod, go.sum (14 KB) - Go dependencies
   ├─ 🔧 .golangci.yml - Linter config
   ├─ 🔧 .prettierrc.json - Code formatter
   └─ 📜 LICENSE, CODE_OF_CONDUCT.md, etc.

---

📈 Size Distribution by Directory

Directory Breakdown (by total size):
┌────────────────────────────────────────────────────────────┐
│ .github/    4.92 MB  ████████████████████              49.7%│
│ pkg/        4.51 MB  ██████████████████                45.5%│
│ docs/       0.35 MB  █                                  3.6%│
│ root files  0.06 MB  ░                                  0.6%│
│ cmd/        0.02 MB  ░                                  0.2%│
│ scripts/    0.02 MB  ░                                  0.2%│
│ schemas/    0.01 MB  ░                                  0.1%│
│ other       0.01 MB  ░                                  0.1%│
└────────────────────────────────────────────────────────────┘

---

🎯 Key Repository Components

🔧 Core Engine (pkg/workflow/)

307 files | 3.03 MB | 62.9% of pkg/

The workflow compilation engine that converts markdown agentic workflows to GitHub Actions YAML:

• JavaScript Runtime (js/): 55 files with Actions scripts and validators
• Test Data (test_data/): Sample workflows for testing
• Schemas (schemas/): JSON schemas for validation
• Go Engine: 229 Go files implementing compilation logic

Notable Files:

• Error pattern validators and log parsers
• MCP server integration
• Multi-engine support (Copilot, Claude, Codex)
• Safe outputs processing

🖥️ CLI Interface (pkg/cli/)

152 files | 1.03 MB | 21.8% of pkg/

Command-line interface implementation:

• Test Workflows (workflows/): 64 workflow test files
• Templates (templates/): Workflow scaffolding
• Commands: Compile, logs, MCP management, audit

📝 Parser (pkg/parser/)

24 files | 424 KB | 8.9% of pkg/

YAML frontmatter and markdown parsing:

• JSON schema validation
• Frontmatter extraction
• Context expression validation

🎨 Console Output (pkg/console/)

5 files | 30 KB | 0.6% of pkg/

Formatted terminal output with color and styling

---

📁 Workflow Files (.github/workflows/)

68 files | 4.83 MB

The repository's own agentic workflows and CI/CD:

• Markdown Workflows (.md): Natural language workflow definitions
• Compiled Workflows (.lock.yml): Generated GitHub Actions YAML
• Shared Components (shared/): Reusable workflow fragments
• Examples: Issue triage, PR reviews, documentation, testing

Workflow Categories:

• 🤖 AI-powered automation (issue triage, PR reviews)
• 🧪 Testing and validation
• 📚 Documentation generation
• 🔄 CI/CD pipelines

---

📊 Code Quality Metrics

Go Code (pkg/)

• 489 Go files implementing the core engine
• Well-structured packages: workflow, cli, parser, console, constants
• Test coverage: Extensive test files alongside source code
• Schema-driven: JSON schemas embedded in binaries

JavaScript (pkg/workflow/js/)

• 50 CommonJS files for GitHub Actions integration
• Unit tests for critical validators
• Actions integrations: @actions/core, @actions/github
• Error handling: Pattern matching and log parsing

Documentation

• 184 Markdown files across the repository
• Astro Starlight documentation system in docs/
• Inline guides: AGENTS.md, DEVGUIDE.md, TESTING.md
• Workflow instructions: Detailed AI coding guidelines

---

🔍 Notable Patterns

1. Workflow-as-Code

The repository dogfoods its own technology with 68 workflow files demonstrating agentic workflow patterns.

2. Schema-Driven Development

JSON schemas in pkg/parser/schemas/ and pkg/workflow/schemas/ validate workflow frontmatter and ensure correctness.

3. Test-Driven Structure

Test files are co-located with source code, making it easy to understand component behavior.

4. Multi-Engine Architecture

Support for multiple AI engines (Copilot CLI, Claude Code, Codex) with engine-specific adapters.

5. Safety-First Design

Safe outputs system (safe-outputs) separates AI processing from GitHub API write operations.

---

🎯 Repository Health Indicators

✅ Well-Organized: Clear package structure with single responsibility
✅ Documented: Extensive markdown documentation and inline comments
✅ Tested: Test files throughout codebase
✅ Schema-Validated: JSON schemas ensure correctness
✅ CI/CD Ready: Makefile with comprehensive build/test/lint targets
✅ Developer-Friendly: DEVGUIDE.md, AGENTS.md, CONTRIBUTING.md

---

🚀 Quick Navigation

• Get Started: README.md
• Development Guide: DEVGUIDE.md
• AI Coding Guidelines: AGENTS.md
• Testing Guide: TESTING.md
• CLI Documentation: docs/
• Example Workflows: .github/workflows/

---

This tree map was generated automatically by an agentic workflow analyzing the repository structure.

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 month ago.