[specs] Update layout specification - February 04, 2026

[github-actions]

Layout Specification Update

This PR updates scratchpad/layout.md with the latest patterns extracted from compiled workflow files.

What Changed

• Updated statistics: From 137 to 145 lock files analyzed
• Expanded Actions catalog: 30 unique GitHub Actions documented (up from 25)
• Enhanced artifact list: 18 artifact patterns cataloged (up from 17)
• Added Step IDs section: Comprehensive documentation of 30+ common step IDs
• Expanded job names: 24 common job patterns (up from 20)
• File paths section: 50+ file path patterns documented
• Environment variables: New comprehensive reference section
• Code patterns: Added Go constants and JavaScript patterns from source code
• Usage guidelines: Enhanced with naming conventions and best practices
• Pattern analysis: Added workflow structure and artifact flow diagrams
• Docker integration: Improved Docker-related actions documentation

Extraction Summary

• Lock files analyzed: 145
• Total action uses: 6,472
• Unique actions cataloged: 30
• Artifacts documented: 18
• Job patterns found: 24
• Step IDs listed: 30+
• File paths cataloged: 50+

Source Analysis

• ✅ Scanned all .lock.yml files in .github/workflows/
• ✅ Reviewed Go code in pkg/workflow/ and pkg/constants/
• ✅ Reviewed JavaScript code in actions/setup/js/
• ✅ Extracted patterns using yq, grep, and grep commands
• ✅ Documented real SHA values from actual workflows

Key Improvements

1. Comprehensive Step IDs: Added detailed documentation of all common step IDs used across workflows
2. Environment Variables: New section documenting standard variables, secrets, and workflow inputs
3. Code Patterns: Extracted actual Go constants and JavaScript patterns from source code
4. Enhanced Guidelines: Improved usage guidelines with specific naming conventions
5. Pattern Analysis: Added workflow structure diagrams and artifact flow patterns
6. Better Context: Each entry now includes more detailed context about usage

Changes Statistics

scratchpad/layout.md | 542 insertions(+), 210 deletions(-)
                     | 332 net additions

---

Auto-generated by Layout Specification Maintainer workflow

AI generated by Layout Specification Maintainer

• expires on Feb 6, 2026, 7:31 AM UTC