Skip to content

Commit aa39e6a

Browse files
docs: update layout specification for 2026-04-27 (#28675)
1 parent e2a8bf4 commit aa39e6a

1 file changed

Lines changed: 13 additions & 9 deletions

File tree

scratchpad/layout.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# GitHub Actions Workflow Layout Specification
22

33
> Auto-generated specification documenting patterns used in compiled `.lock.yml` files.
4-
> Last updated: 2026-04-20
4+
> Last updated: 2026-04-27
55
66
## Overview
77

88
This document catalogs all file paths, folder names, artifact names, and other patterns used across our compiled GitHub Actions workflows (`.lock.yml` files). It serves as a reference for developers working with the gh-aw codebase.
99

1010
**Statistics:**
11-
- **Lock files analyzed**: 197
11+
- **Lock files analyzed**: 204
1212
- **Unique GitHub Actions**: 25
1313
- **Artifact patterns**: 27
1414
- **Job name patterns**: 30
@@ -23,20 +23,20 @@ Common GitHub Actions used across compiled workflows:
2323
| `actions/checkout` | `de0fac2e...` | Checks out repository code | Used in almost all workflows for accessing repo content |
2424
| `actions/upload-artifact` | `043fb46d...` | Uploads build artifacts | Used for agent outputs, patches, prompts, logs, and safe-output data |
2525
| `actions/download-artifact` | `3e5f45b2...` | Downloads artifacts from previous jobs | Used in safe-output jobs and conclusion jobs |
26-
| `actions/setup-node` | `53b83947...` | Sets up Node.js environment | Used in workflows requiring npm/node |
26+
| `actions/setup-node` | `48b55a01...` | Sets up Node.js environment | Used in workflows requiring npm/node |
2727
| `actions/setup-python` | `a309ff8b...` | Sets up Python environment | Used for Python-based workflows and scripts |
2828
| `actions/setup-go` | `4a360112...` | Sets up Go environment | Used for Go-based builds and tests |
2929
| `actions/setup-java` | `be666c2f...` | Sets up Java environment | Used for Java-based workflows |
3030
| `actions/setup-dotnet` | `c2fa09f4...` | Sets up .NET environment | Used for .NET-based workflows |
3131
| `actions/github-script` | `373c709c...` | Runs GitHub API scripts | Used for GitHub API interactions and workflow logic |
32-
| `actions/cache` | `66822842...` | Caches dependencies | Used for caching npm, pip, go modules |
33-
| `actions/cache/restore` | `66822842...` | Restores cached dependencies | Explicit cache restore action |
34-
| `actions/cache/save` | `66822842...` | Saves dependencies to cache | Explicit cache save action |
32+
| `actions/cache` | `27d5ce7f...` | Caches dependencies | Used for caching npm, pip, go modules |
33+
| `actions/cache/restore` | `27d5ce7f...` | Restores cached dependencies | Explicit cache restore action |
34+
| `actions/cache/save` | `27d5ce7f...` | Saves dependencies to cache | Explicit cache save action |
3535
| `docker/setup-buildx-action` | `4d04d5d9...` | Sets up Docker Buildx | Used for multi-platform Docker builds |
3636
| `docker/build-push-action` | `bcafcacb...` | Builds and pushes Docker images | Used in release workflows |
3737
| `docker/login-action` | `4907a6dd...` | Logs in to Docker registry | Used before pushing Docker images |
3838
| `docker/metadata-action` | `030e8812...` | Extracts Docker metadata | Used for tagging Docker images |
39-
| `astral-sh/setup-uv` | `cec20831...`, `eac588ad...` | Sets up uv package manager | Used for Python package management |
39+
| `astral-sh/setup-uv` | `08807647...`, `eac588ad...` | Sets up uv package manager | Used for Python package management |
4040
| `anchore/sbom-action` | `e22c3899...` | Generates SBOM | Used for security and compliance |
4141
| `super-linter/super-linter` | `9e863354...` | Runs super-linter | Used for code quality checks |
4242
| `github/codeql-action/upload-sarif` | `0e9f5595...` | Uploads SARIF to GitHub Code Scanning | Used for security scanning results from threat detection |
@@ -73,6 +73,8 @@ Artifacts uploaded/downloaded between workflow jobs:
7373
| `code-scanning-sarif` | Detection/SARIF job | upload_code_scanning_sarif job | SARIF formatted code scanning results |
7474
| `runner-guard-results` | Runner guard job | Debug/analysis step | Runner security guard check results |
7575
| `sbom-artifacts` | SBOM job | Download step | Software Bill of Materials artifacts |
76+
| `skill-optimizer-results` | Skill optimizer job | Download step | Results from the skill optimizer run |
77+
| `spellcheck-results` | Spellcheck job | Download step | Spellcheck findings and summary data |
7678
| `super-linter-log` | Super-linter job | Debug step | Linter execution logs |
7779
| `${{ needs.activation.outputs.artifact_prefix }}agent` | Agent job | Downstream jobs | Dynamic-prefixed agent artifact (used in `workflow_call` context) |
7880
| `${{ needs.activation.outputs.artifact_prefix }}activation` | Activation job | Agent job | Dynamic-prefixed activation artifact (used in `workflow_call` context) |
@@ -104,6 +106,8 @@ Standard job names across compiled workflows:
104106
| `search_issues` | Issue search | Various | Searches GitHub issues based on criteria |
105107
| `post-issue` | Issue posting | Various | Posts new GitHub issues |
106108
| `release` | Release job | Build/test jobs | Creates GitHub releases |
109+
| `skill_optimizer` | Skill optimization | Various | Runs the skill optimizer to tune agent behavior |
110+
| `spellcheck` | Spell checking | Various | Runs cspell spell checking on repository content |
107111
| `super_linter` | Code linting | Various | Runs super-linter on codebase |
108112
| `ast_grep` | AST analysis | Various | Runs AST-based code analysis |
109113
| `apm` | APM bundle collection | Various | Collects Application Performance Monitoring data bundle |
@@ -578,8 +582,8 @@ This specification is automatically maintained by the **Layout Specification Mai
578582
4. Updates this document with findings
579583
5. Creates a PR with the changes
580584

581-
**Last extraction run**: 2026-04-20
582-
**Lock files analyzed**: 197
585+
**Last extraction run**: 2026-04-27
586+
**Lock files analyzed**: 204
583587
**Patterns documented**: 300+
584588

585589
---

0 commit comments

Comments
 (0)