diff --git a/pkg/cli/compile_batch_operations.go b/pkg/cli/compile_batch_operations.go
index 66126aa532..3ec7954caa 100644
--- a/pkg/cli/compile_batch_operations.go
+++ b/pkg/cli/compile_batch_operations.go
@@ -1,4 +1,4 @@
-// Package cli provides batch operations for workflow compilation.
+// This file provides batch operations for workflow compilation.
 //
 // This file contains functions that perform batch operations on compiled workflows,
 // such as running linters, security scanners, and cleaning up orphaned files.
@@ -22,6 +22,7 @@
 //
 // These functions abstract batch operations, allowing the main compile
 // orchestrator to focus on coordination while these handle batch processing.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_campaign.go b/pkg/cli/compile_campaign.go
index 5edf8313f7..3c8ba255b9 100644
--- a/pkg/cli/compile_campaign.go
+++ b/pkg/cli/compile_campaign.go
@@ -1,4 +1,4 @@
-// Package cli provides campaign workflow compilation and validation.
+// This file provides campaign workflow compilation and validation.
 //
 // This file handles validation of campaign spec files and their referenced workflows.
 // Campaign workflows are special workflows that orchestrate multiple sub-workflows
@@ -24,6 +24,7 @@
 //   - Campaign spec files are syntactically valid
 //   - Referenced workflow files exist in the workflows directory
 //   - Campaign configuration is complete and correct
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_compiler_setup.go b/pkg/cli/compile_compiler_setup.go
index c6ad0cc157..6e710a8a9e 100644
--- a/pkg/cli/compile_compiler_setup.go
+++ b/pkg/cli/compile_compiler_setup.go
@@ -1,4 +1,4 @@
-// Package cli provides compiler initialization and configuration for workflow compilation.
+// This file provides compiler initialization and configuration for workflow compilation.
 //
 // This file contains functions that create and configure the workflow compiler
 // instance with various settings like validation, strict mode, trial mode, and
@@ -24,6 +24,7 @@
 //
 // These functions abstract compiler setup, allowing the main compile
 // orchestrator to focus on coordination while these handle configuration.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_helpers.go b/pkg/cli/compile_helpers.go
index 818daa7703..e9fe1065ac 100644
--- a/pkg/cli/compile_helpers.go
+++ b/pkg/cli/compile_helpers.go
@@ -1,4 +1,4 @@
-// Package cli provides helper functions for workflow compilation.
+// This file provides helper functions for workflow compilation.
 //
 // This file contains shared utilities used by the compile command to process workflow
 // files, manage compilation statistics, and handle campaign workflows. These helpers
@@ -31,6 +31,7 @@
 //
 // These functions abstract common compilation patterns, allowing the main compile
 // command to focus on CLI interaction while these helpers handle the mechanics.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_orchestration.go b/pkg/cli/compile_orchestration.go
index fc9940117e..55a08c8009 100644
--- a/pkg/cli/compile_orchestration.go
+++ b/pkg/cli/compile_orchestration.go
@@ -1,4 +1,4 @@
-// Package cli provides main orchestration logic for workflow compilation.
+// This file provides main orchestration logic for workflow compilation.
 //
 // This file contains the primary compilation orchestration functions that coordinate
 // the compilation of specific files or all files in a directory.
@@ -18,6 +18,7 @@
 //   - compileAllFilesInDirectory() - Compile all workflows in a directory
 //
 // These functions handle the complete compilation pipeline for their respective scenarios.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_output_formatter.go b/pkg/cli/compile_output_formatter.go
index 15559914db..ea24e90c60 100644
--- a/pkg/cli/compile_output_formatter.go
+++ b/pkg/cli/compile_output_formatter.go
@@ -1,4 +1,4 @@
-// Package cli provides output formatting functions for workflow compilation.
+// This file provides output formatting functions for workflow compilation.
 //
 // This file contains functions that format and display compilation results,
 // including summaries, statistics tables, and validation outputs.
@@ -19,6 +19,7 @@
 //
 // These functions abstract output formatting, allowing the main compile
 // orchestrator to focus on coordination while these handle presentation.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_post_processing.go b/pkg/cli/compile_post_processing.go
index 9f3932a92f..dd6f53df5c 100644
--- a/pkg/cli/compile_post_processing.go
+++ b/pkg/cli/compile_post_processing.go
@@ -1,4 +1,4 @@
-// Package cli provides post-processing operations for workflow compilation.
+// This file provides post-processing operations for workflow compilation.
 //
 // This file contains functions that perform post-compilation operations such as
 // generating Dependabot manifests, maintenance workflows, and validating campaigns.
@@ -25,6 +25,7 @@
 //
 // These functions abstract post-processing operations, allowing the main compile
 // orchestrator to focus on coordination while these handle generation and validation.
+
 package cli
 
 import (
diff --git a/pkg/cli/compile_workflow_processor.go b/pkg/cli/compile_workflow_processor.go
index 08562dfb74..db4465b425 100644
--- a/pkg/cli/compile_workflow_processor.go
+++ b/pkg/cli/compile_workflow_processor.go
@@ -1,4 +1,4 @@
-// Package cli provides workflow file processing functions for compilation.
+// This file provides workflow file processing functions for compilation.
 //
 // This file contains functions that process individual workflow files and
 // campaign specs, handling both regular workflows and campaign orchestrators.
@@ -20,6 +20,7 @@
 //
 // These functions abstract per-file processing, allowing the main compile
 // orchestrator to focus on coordination while these handle file processing.
+
 package cli
 
 import (
diff --git a/pkg/cli/gateway_logs.go b/pkg/cli/gateway_logs.go
index 469cacc1c3..a32e3f3c3c 100644
--- a/pkg/cli/gateway_logs.go
+++ b/pkg/cli/gateway_logs.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (gateway_logs.go) contains functions for parsing and analyzing
 // MCP gateway logs from gateway.jsonl files.
 //
@@ -7,6 +7,7 @@
 //   - Extracting server and tool usage metrics
 //   - Aggregating gateway statistics
 //   - Rendering gateway metrics tables
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_command.go b/pkg/cli/logs_command.go
index 555d822c91..72db5705c7 100644
--- a/pkg/cli/logs_command.go
+++ b/pkg/cli/logs_command.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_command.go) contains the CLI command definition for the logs command.
 //
 // Key responsibilities:
@@ -6,6 +6,7 @@
 //   - Parsing command-line arguments and flags
 //   - Validating inputs (workflow names, dates, engine parameters)
 //   - Delegating execution to the orchestrator (DownloadWorkflowLogs)
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_display.go b/pkg/cli/logs_display.go
index dea3727d2f..73fc77c259 100644
--- a/pkg/cli/logs_display.go
+++ b/pkg/cli/logs_display.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_display.go) contains functions for displaying workflow logs information
 // to the console, including summary tables and metrics.
 //
@@ -6,6 +6,7 @@
 //   - Rendering workflow logs overview tables
 //   - Formatting metrics for display (duration, tokens, cost)
 //   - Aggregating totals across multiple runs
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_download.go b/pkg/cli/logs_download.go
index 422cc5ee4d..597bc60782 100644
--- a/pkg/cli/logs_download.go
+++ b/pkg/cli/logs_download.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_download.go) contains functions for downloading and extracting
 // GitHub Actions workflow artifacts and logs.
 //
@@ -7,6 +7,7 @@
 //   - Extracting and organizing zip archives
 //   - Flattening single-file artifact directories
 //   - Managing local file system operations
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_github_api.go b/pkg/cli/logs_github_api.go
index 2712ab967b..e98c42397b 100644
--- a/pkg/cli/logs_github_api.go
+++ b/pkg/cli/logs_github_api.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_github_api.go) contains functions for interacting with the GitHub API
 // to fetch workflow runs, job statuses, and job details.
 //
@@ -6,6 +6,7 @@
 //   - Listing workflow runs with pagination
 //   - Fetching job statuses and details for workflow runs
 //   - Handling GitHub CLI authentication and error responses
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_metrics.go b/pkg/cli/logs_metrics.go
index 877fdfaa4c..a3176080fa 100644
--- a/pkg/cli/logs_metrics.go
+++ b/pkg/cli/logs_metrics.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_metrics.go) contains functions for extracting and analyzing
 // metrics from workflow execution logs.
 //
@@ -8,6 +8,7 @@
 //   - Detecting MCP (Model Context Protocol) server failures
 //   - Aggregating metrics across multiple log files
 //   - Processing structured output from agent execution
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_orchestrator.go b/pkg/cli/logs_orchestrator.go
index 0f6a96dd99..a957509b64 100644
--- a/pkg/cli/logs_orchestrator.go
+++ b/pkg/cli/logs_orchestrator.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_orchestrator.go) contains the main orchestration logic for downloading
 // and processing workflow logs from GitHub Actions.
 //
@@ -8,6 +8,7 @@
 //   - Concurrent downloading of artifacts from multiple runs
 //   - Applying filters (engine, firewall, staged, campaign, etc.)
 //   - Building and rendering output (console, JSON, tool graphs)
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_parsing_core.go b/pkg/cli/logs_parsing_core.go
index 0f6b5117db..7ca5d4e317 100644
--- a/pkg/cli/logs_parsing_core.go
+++ b/pkg/cli/logs_parsing_core.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_core.go) contains core log parsing functions
 // for locating and extracting engine configuration from workflow logs.
 //
@@ -6,6 +6,7 @@
 //   - Parsing aw_info.json to extract engine configuration
 //   - Locating agent log files and output artifacts
 //   - Supporting multiple artifact layouts (before/after flattening)
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_parsing_engines.go b/pkg/cli/logs_parsing_engines.go
index 391642bbf7..bd8d332316 100644
--- a/pkg/cli/logs_parsing_engines.go
+++ b/pkg/cli/logs_parsing_engines.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_engines.go) contains engine-specific log parsing
 // functionality for various AI engines (Claude, Copilot, Codex, Custom).
 //
@@ -6,6 +6,7 @@
 //   - Parsing log files using engine-specific parsers
 //   - Detecting and parsing GitHub Copilot agent logs
 //   - Falling back to generic parser when engine is unknown
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_parsing_firewall.go b/pkg/cli/logs_parsing_firewall.go
index b36b15fc4b..69f58913b6 100644
--- a/pkg/cli/logs_parsing_firewall.go
+++ b/pkg/cli/logs_parsing_firewall.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_firewall.go) contains functionality for parsing
 // and analyzing firewall logs from workflow runs.
 //
@@ -6,6 +6,7 @@
 //   - Locating firewall logs in various directory structures
 //   - Running JavaScript firewall log parser
 //   - Generating markdown summaries of firewall activity
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_parsing_javascript.go b/pkg/cli/logs_parsing_javascript.go
index 8f40937453..179ddd715d 100644
--- a/pkg/cli/logs_parsing_javascript.go
+++ b/pkg/cli/logs_parsing_javascript.go
@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_js.go) contains functionality for executing
 // JavaScript log parsers to generate markdown summaries.
 //
@@ -6,6 +6,7 @@
 //   - Running JavaScript log parser scripts
 //   - Mocking GitHub Actions environment for parsers
 //   - Generating markdown log summaries
+
 package cli
 
 import (
diff --git a/pkg/cli/logs_utils.go b/pkg/cli/logs_utils.go
index cf59494337..40fda15538 100644
--- a/pkg/cli/logs_utils.go
+++ b/pkg/cli/logs_utils.go
@@ -1,9 +1,10 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_utils.go) contains utility functions used by the logs command.
 //
 // Key responsibilities:
 //   - Discovering agentic workflow names from .lock.yml files
 //   - Utility functions for slice operations
+
 package cli
 
 import (
diff --git a/pkg/cli/mcp_validation.go b/pkg/cli/mcp_validation.go
index 75f8040492..69549b1d3b 100644
--- a/pkg/cli/mcp_validation.go
+++ b/pkg/cli/mcp_validation.go
@@ -1,5 +1,6 @@
-// Package cli contains MCP (Model Context Protocol) validation functions.
+// This file contains MCP (Model Context Protocol) validation functions.
 // This file consolidates validation logic for MCP server configurations.
+
 package cli
 
 import (
diff --git a/pkg/workflow/agent_validation.go b/pkg/workflow/agent_validation.go
index 277425bc4a..9ae10d218d 100644
--- a/pkg/workflow/agent_validation.go
+++ b/pkg/workflow/agent_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides agent file and feature support validation.
+// This file provides agent file and feature support validation.
 //
 // # Agent Validation
 //
@@ -40,6 +40,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/bundler.go b/pkg/workflow/bundler.go
index 619925bacf..bfff75c9a8 100644
--- a/pkg/workflow/bundler.go
+++ b/pkg/workflow/bundler.go
@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundling for agentic workflows.
+// This file provides JavaScript bundling for agentic workflows.
 //
 // # JavaScript Bundler with Runtime Mode Support
 //
@@ -40,6 +40,7 @@
 //
 // These validations prevent runtime errors when JavaScript is executed in environments
 // without a module system.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/bundler_file_mode.go b/pkg/workflow/bundler_file_mode.go
index 09121e5202..d56de7d1e8 100644
--- a/pkg/workflow/bundler_file_mode.go
+++ b/pkg/workflow/bundler_file_mode.go
@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundling for agentic workflows.
+// This file provides JavaScript bundling for agentic workflows.
 //
 // # File Mode Bundler
 //
@@ -18,6 +18,7 @@
 //   - Maximizes reuse of helper modules within the same job
 //   - Makes debugging easier (files exist on disk during execution)
 //   - Reduces memory pressure from large bundled strings
+
 package workflow
 
 import (
diff --git a/pkg/workflow/bundler_runtime_validation.go b/pkg/workflow/bundler_runtime_validation.go
index 05c528a24b..838b427da8 100644
--- a/pkg/workflow/bundler_runtime_validation.go
+++ b/pkg/workflow/bundler_runtime_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript runtime mode validation for agentic workflows.
+// This file provides JavaScript runtime mode validation for agentic workflows.
 //
 // # Runtime Mode Validation
 //
@@ -37,6 +37,7 @@
 // For script content validation, see bundler_script_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/bundler_safety_validation.go b/pkg/workflow/bundler_safety_validation.go
index 95c1c9bca0..664ad42927 100644
--- a/pkg/workflow/bundler_safety_validation.go
+++ b/pkg/workflow/bundler_safety_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundler safety validation for agentic workflows.
+// This file provides JavaScript bundler safety validation for agentic workflows.
 //
 // # Bundle Safety Validation
 //
@@ -32,6 +32,7 @@
 // For script content validation, see bundler_script_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/bundler_script_validation.go b/pkg/workflow/bundler_script_validation.go
index 54980976f4..d60f17c583 100644
--- a/pkg/workflow/bundler_script_validation.go
+++ b/pkg/workflow/bundler_script_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript script content validation for agentic workflows.
+// This file provides JavaScript script content validation for agentic workflows.
 //
 // # Script Content Validation
 //
@@ -36,6 +36,7 @@
 // For runtime mode validation, see bundler_runtime_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/close_entity_helpers.go b/pkg/workflow/close_entity_helpers.go
index b132223496..dbf789fb22 100644
--- a/pkg/workflow/close_entity_helpers.go
+++ b/pkg/workflow/close_entity_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides helper functions for closing GitHub entities.
+// This file provides helper functions for closing GitHub entities.
 //
 // This file contains shared utilities for building close entity jobs (issues,
 // pull requests, discussions). These helpers extract common patterns used across
@@ -47,6 +47,7 @@
 // For create/update operations, see:
 //   - create_*.go files for entity creation logic
 //   - update_entity_helpers.go for entity update logic
+
 package workflow
 
 import (
diff --git a/pkg/workflow/compiler_filters_validation.go b/pkg/workflow/compiler_filters_validation.go
index f030df1159..7b54dd8a12 100644
--- a/pkg/workflow/compiler_filters_validation.go
+++ b/pkg/workflow/compiler_filters_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides validation for GitHub Actions event filter mutual exclusivity.
+// This file provides validation for GitHub Actions event filter mutual exclusivity.
 //
 // # Filter Validation
 //
@@ -29,6 +29,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/config_helpers.go b/pkg/workflow/config_helpers.go
index a3ae2be4d3..58950badae 100644
--- a/pkg/workflow/config_helpers.go
+++ b/pkg/workflow/config_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides helper functions for parsing safe output configurations.
+// This file provides helper functions for parsing safe output configurations.
 //
 // This file contains parsing utilities for extracting and validating configuration
 // values from safe output config maps. These helpers are used across safe output
@@ -32,6 +32,7 @@
 // Configuration Integer Parsing:
 //   - parseExpiresFromConfig() - Extract expiration time
 //   - parseRelativeTimeSpec() - Parse relative time specifications
+
 package workflow
 
 import (
diff --git a/pkg/workflow/copilot_engine.go b/pkg/workflow/copilot_engine.go
index b302666012..a0e9f40f69 100644
--- a/pkg/workflow/copilot_engine.go
+++ b/pkg/workflow/copilot_engine.go
@@ -1,4 +1,4 @@
-// Package workflow implements the GitHub Copilot CLI agentic engine.
+// This file implements the GitHub Copilot CLI agentic engine.
 //
 // The Copilot engine is organized into focused modules:
 //   - copilot_engine.go: Core engine interface and constructor
@@ -12,6 +12,7 @@
 //
 // This modular organization improves maintainability and makes it easier
 // to locate and modify specific functionality.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/copilot_engine_execution.go b/pkg/workflow/copilot_engine_execution.go
index a82ad623e5..10f60ed5b1 100644
--- a/pkg/workflow/copilot_engine_execution.go
+++ b/pkg/workflow/copilot_engine_execution.go
@@ -1,4 +1,4 @@
-// Package workflow provides Copilot engine execution logic.
+// This file provides Copilot engine execution logic.
 //
 // This file contains the GetExecutionSteps function which generates the complete
 // GitHub Actions workflow for executing GitHub Copilot CLI. This is the largest
@@ -18,6 +18,7 @@
 //
 // This function is intentionally kept in a separate file due to its size (~430 lines)
 // and complexity. Future refactoring may split it further if needed.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/copilot_engine_installation.go b/pkg/workflow/copilot_engine_installation.go
index 85654ca6dc..a923210368 100644
--- a/pkg/workflow/copilot_engine_installation.go
+++ b/pkg/workflow/copilot_engine_installation.go
@@ -1,4 +1,4 @@
-// Package workflow provides Copilot engine installation logic.
+// This file provides Copilot engine installation logic.
 //
 // This file contains functions for generating GitHub Actions steps to install
 // the GitHub Copilot CLI and related sandbox infrastructure (AWF or SRT).
@@ -13,6 +13,7 @@
 //   - Standard mode: Global installation using official installer script
 //   - SRT mode: Local npm installation for offline compatibility
 //   - AWF mode: Global installation + AWF binary
+
 package workflow
 
 import (
diff --git a/pkg/workflow/copilot_engine_tools.go b/pkg/workflow/copilot_engine_tools.go
index 3fefdfbb6a..a92f787b93 100644
--- a/pkg/workflow/copilot_engine_tools.go
+++ b/pkg/workflow/copilot_engine_tools.go
@@ -1,4 +1,4 @@
-// Package workflow provides Copilot engine tool permission and error pattern logic.
+// This file provides Copilot engine tool permission and error pattern logic.
 //
 // This file handles three key responsibilities:
 //
@@ -18,6 +18,7 @@
 //
 // These functions are grouped together because they all relate to tool configuration
 // and error handling in the Copilot engine.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/docker_validation.go b/pkg/workflow/docker_validation.go
index 0b112aa52a..4b5b0586c7 100644
--- a/pkg/workflow/docker_validation.go
+++ b/pkg/workflow/docker_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides Docker image validation for agentic workflows.
+// This file provides Docker image validation for agentic workflows.
 //
 // # Docker Image Validation
 //
@@ -28,6 +28,7 @@
 // For Docker image collection functions, see docker.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/engine_helpers.go b/pkg/workflow/engine_helpers.go
index e78a17fecf..609e06efd8 100644
--- a/pkg/workflow/engine_helpers.go
+++ b/pkg/workflow/engine_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides shared helper functions for AI engine implementations.
+// This file provides shared helper functions for AI engine implementations.
 //
 // This file contains utilities used across multiple AI engine files (copilot_engine.go,
 // claude_engine.go, codex_engine.go, custom_engine.go) to generate common workflow
@@ -28,6 +28,7 @@
 //
 // These functions encapsulate shared logic that would otherwise be duplicated across
 // engine files, maintaining DRY principles while keeping engine-specific code separate.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/engine_validation.go b/pkg/workflow/engine_validation.go
index 164cc60a48..3401cf89b1 100644
--- a/pkg/workflow/engine_validation.go
+++ b/pkg/workflow/engine_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides engine validation for agentic workflows.
+// This file provides engine validation for agentic workflows.
 //
 // # Engine Validation
 //
@@ -30,6 +30,7 @@
 // For engine configuration extraction, see engine.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/env_mirror.go b/pkg/workflow/env_mirror.go
index bcd135c3bc..7968de6785 100644
--- a/pkg/workflow/env_mirror.go
+++ b/pkg/workflow/env_mirror.go
@@ -1,4 +1,4 @@
-// Package workflow provides environment variable mirroring for agent containers.
+// This file provides environment variable mirroring for agent containers.
 //
 // This file contains logic for mirroring essential GitHub Actions runner environment
 // variables into the agent container. The Ubuntu runner image provides many environment
@@ -11,6 +11,7 @@
 // handling of missing variables.
 //
 // Reference: specs/ubuntulatest.md section "Environment Variables"
+
 package workflow
 
 import (
diff --git a/pkg/workflow/expression_patterns.go b/pkg/workflow/expression_patterns.go
index 44d3ae0619..10bb10467b 100644
--- a/pkg/workflow/expression_patterns.go
+++ b/pkg/workflow/expression_patterns.go
@@ -1,4 +1,4 @@
-// Package workflow provides centralized regex patterns for GitHub Actions expression matching.
+// This file provides centralized regex patterns for GitHub Actions expression matching.
 //
 // # Expression Patterns
 //
@@ -53,6 +53,7 @@
 //   - template_injection_validation.go
 //
 // Files are gradually being migrated to use these centralized patterns.
+
 package workflow
 
 import "regexp"
diff --git a/pkg/workflow/expression_patterns_test.go b/pkg/workflow/expression_patterns_test.go
index 84bb0ffc88..72ed286aaa 100644
--- a/pkg/workflow/expression_patterns_test.go
+++ b/pkg/workflow/expression_patterns_test.go
@@ -1,4 +1,5 @@
-// Package workflow provides tests for expression pattern matching.
+// This file provides tests for expression pattern matching.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/expression_validation.go b/pkg/workflow/expression_validation.go
index d02752025f..a339572c77 100644
--- a/pkg/workflow/expression_validation.go
+++ b/pkg/workflow/expression_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides GitHub Actions expression security validation.
+// This file provides GitHub Actions expression security validation.
 //
 // # Expression Safety Validation
 //
@@ -40,6 +40,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/features_validation.go b/pkg/workflow/features_validation.go
index 3b21d24307..38e9818f55 100644
--- a/pkg/workflow/features_validation.go
+++ b/pkg/workflow/features_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides validation for feature flags.
+// This file provides validation for feature flags.
 //
 // # Features Validation
 //
@@ -19,6 +19,7 @@
 //   - Adding new feature flags that require specific value formats
 //   - Feature flags need cross-validation with other workflow settings
 //   - Feature flag values need format or constraint checking
+
 package workflow
 
 import (
diff --git a/pkg/workflow/firewall_validation.go b/pkg/workflow/firewall_validation.go
index c912306f6b..3e784dc12f 100644
--- a/pkg/workflow/firewall_validation.go
+++ b/pkg/workflow/firewall_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides firewall validation functions for agentic workflow compilation.
+// This file provides firewall validation functions for agentic workflow compilation.
 //
 // This file contains domain-specific validation functions for firewall configuration:
 //   - ValidateLogLevel() - Validates firewall log-level values
@@ -6,6 +6,7 @@
 // These validation functions are organized in a dedicated file following the validation
 // architecture pattern where domain-specific validation belongs in domain validation files.
 // See validation.go for the complete validation architecture documentation.
+
 package workflow
 
 import "fmt"
diff --git a/pkg/workflow/git_helpers.go b/pkg/workflow/git_helpers.go
index df43312bf4..8ea2c9ea6c 100644
--- a/pkg/workflow/git_helpers.go
+++ b/pkg/workflow/git_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides Git repository utilities for workflow compilation.
+// This file provides Git repository utilities for workflow compilation.
 //
 // This file contains helper functions for interacting with Git repositories
 // to extract metadata such as tags and version information. These helpers are
@@ -26,6 +26,7 @@
 //   - Detect release contexts (tags vs. regular commits)
 //   - Extract version information for releases
 //   - Support conditional workflow behavior based on Git state
+
 package workflow
 
 import (
diff --git a/pkg/workflow/map_helpers.go b/pkg/workflow/map_helpers.go
index 85ef7a16b3..6850ae27e0 100644
--- a/pkg/workflow/map_helpers.go
+++ b/pkg/workflow/map_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides generic map and type conversion utilities.
+// This file provides generic map and type conversion utilities.
 //
 // This file contains low-level helper functions for working with map[string]any
 // structures and type conversions. These utilities are used throughout the workflow
@@ -24,6 +24,7 @@
 //
 // These utilities handle common type conversion and map manipulation patterns that
 // occur frequently during YAML-to-struct parsing and configuration processing.
+
 package workflow
 
 import "github.com/githubnext/gh-aw/pkg/logger"
diff --git a/pkg/workflow/mcp_config_validation.go b/pkg/workflow/mcp_config_validation.go
index ed37705c59..79e83dd52f 100644
--- a/pkg/workflow/mcp_config_validation.go
+++ b/pkg/workflow/mcp_config_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides MCP (Model Context Protocol) configuration validation.
+// This file provides MCP (Model Context Protocol) configuration validation.
 //
 // # MCP Configuration Validation
 //
@@ -41,6 +41,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/npm.go b/pkg/workflow/npm.go
index 8bd15e975b..7f184af2a4 100644
--- a/pkg/workflow/npm.go
+++ b/pkg/workflow/npm.go
@@ -1,4 +1,4 @@
-// Package workflow provides NPM package extraction utilities for agentic workflows.
+// This file provides NPM package extraction utilities for agentic workflows.
 //
 // # NPM Package Extraction
 //
@@ -13,6 +13,7 @@
 //
 // For package validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/npm_validation.go b/pkg/workflow/npm_validation.go
index fb4dcce920..8984774667 100644
--- a/pkg/workflow/npm_validation.go
+++ b/pkg/workflow/npm_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides NPM package validation for agentic workflows.
+// This file provides NPM package validation for agentic workflows.
 //
 // # NPM Package Validation
 //
@@ -28,6 +28,7 @@
 // For package extraction functions, see npm.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/package_extraction.go b/pkg/workflow/package_extraction.go
index 334b231cfd..ab1c40df3a 100644
--- a/pkg/workflow/package_extraction.go
+++ b/pkg/workflow/package_extraction.go
@@ -1,4 +1,4 @@
-// Package workflow provides generic package extraction utilities for agentic workflows.
+// This file provides generic package extraction utilities for agentic workflows.
 //
 // # Package Extraction Framework
 //
@@ -92,6 +92,7 @@
 //   - dependabot.go (go packages)
 //
 // For package validation, see validation.go.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/pip.go b/pkg/workflow/pip.go
index 7d58e04be7..68acb11e8a 100644
--- a/pkg/workflow/pip.go
+++ b/pkg/workflow/pip.go
@@ -1,4 +1,4 @@
-// Package workflow provides Python package extraction for agentic workflows.
+// This file provides Python package extraction for agentic workflows.
 //
 // # Python Package Extraction
 //
@@ -24,6 +24,7 @@
 // For package validation functions, see pip_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/pip_validation.go b/pkg/workflow/pip_validation.go
index 7aefb25d6c..e215087687 100644
--- a/pkg/workflow/pip_validation.go
+++ b/pkg/workflow/pip_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides Python package validation for agentic workflows.
+// This file provides Python package validation for agentic workflows.
 //
 // # Python Package Validation
 //
@@ -31,6 +31,7 @@
 // For package extraction functions, see pip.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/prompt_step_helper.go b/pkg/workflow/prompt_step_helper.go
index 1292ab0787..699a52fcf5 100644
--- a/pkg/workflow/prompt_step_helper.go
+++ b/pkg/workflow/prompt_step_helper.go
@@ -1,4 +1,4 @@
-// Package workflow provides helper functions for generating prompt workflow steps.
+// This file provides helper functions for generating prompt workflow steps.
 //
 // This file contains utilities for building GitHub Actions workflow steps that
 // append prompt text to prompt files used by AI engines. These helpers extract
@@ -66,6 +66,7 @@
 // For other prompt-related functionality, see:
 //   - *_engine.go files for engine-specific prompt generation
 //   - engine_helpers.go for shared engine utilities
+
 package workflow
 
 import (
diff --git a/pkg/workflow/repo_memory.go b/pkg/workflow/repo_memory.go
index 100dd7fedb..673cad42c1 100644
--- a/pkg/workflow/repo_memory.go
+++ b/pkg/workflow/repo_memory.go
@@ -1,4 +1,4 @@
-// Package workflow provides repository memory configuration and validation.
+// This file provides repository memory configuration and validation.
 //
 // This file handles:
 //   - Repo-memory configuration structures and defaults
@@ -14,6 +14,7 @@
 // These validation functions are co-located with repo-memory logic following the
 // principle that domain-specific validation belongs in domain files. See validation.go
 // for the validation architecture documentation.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/repository_features_validation.go b/pkg/workflow/repository_features_validation.go
index a8000c06a2..f3ab5a9cf4 100644
--- a/pkg/workflow/repository_features_validation.go
+++ b/pkg/workflow/repository_features_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides repository feature detection and validation.
+// This file provides repository feature detection and validation.
 //
 // # Repository Features Validation
 //
@@ -33,6 +33,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/runtime_validation.go b/pkg/workflow/runtime_validation.go
index 599088921f..99cd35f8fd 100644
--- a/pkg/workflow/runtime_validation.go
+++ b/pkg/workflow/runtime_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides runtime validation for packages, containers, and expressions.
+// This file provides runtime validation for packages, containers, and expressions.
 //
 // # Runtime Validation
 //
@@ -42,6 +42,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/safe_outputs_messages_test.go b/pkg/workflow/safe_outputs_messages_test.go
index 375f100b5c..d50ffd1403 100644
--- a/pkg/workflow/safe_outputs_messages_test.go
+++ b/pkg/workflow/safe_outputs_messages_test.go
@@ -1,6 +1,7 @@
-// Package workflow provides workflow compilation and safe-output configuration.
+// This file provides workflow compilation and safe-output configuration.
 // This file contains tests for the safe-outputs messages configuration feature,
 // which allows customizing footer and notification messages in safe-output jobs.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/sandbox.go b/pkg/workflow/sandbox.go
index 3e46e4a88e..bff58cf705 100644
--- a/pkg/workflow/sandbox.go
+++ b/pkg/workflow/sandbox.go
@@ -1,4 +1,4 @@
-// Package workflow provides sandbox configuration for agentic workflows.
+// This file provides sandbox configuration for agentic workflows.
 //
 // This file handles:
 //   - Sandbox type definitions (AWF, SRT)
@@ -10,6 +10,7 @@
 // Domain-specific validation functions for sandbox configuration are located in
 // sandbox_validation.go following the validation architecture pattern.
 // See validation.go for the validation architecture documentation.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/sandbox_validation.go b/pkg/workflow/sandbox_validation.go
index 9e128864cc..b755a76d5d 100644
--- a/pkg/workflow/sandbox_validation.go
+++ b/pkg/workflow/sandbox_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides sandbox validation functions for agentic workflow compilation.
+// This file provides sandbox validation functions for agentic workflow compilation.
 //
 // This file contains domain-specific validation functions for sandbox configuration:
 //   - validateMountsSyntax() - Validates container mount syntax
@@ -7,6 +7,7 @@
 // These validation functions are organized in a dedicated file following the validation
 // architecture pattern where domain-specific validation belongs in domain validation files.
 // See validation.go for the complete validation architecture documentation.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/schema_validation.go b/pkg/workflow/schema_validation.go
index 90d645da0a..aabe2d40f3 100644
--- a/pkg/workflow/schema_validation.go
+++ b/pkg/workflow/schema_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides GitHub Actions schema validation for compiled workflows.
+// This file provides GitHub Actions schema validation for compiled workflows.
 //
 // # GitHub Actions Schema Validation
 //
@@ -35,6 +35,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/script_registry.go b/pkg/workflow/script_registry.go
index 1e4972b112..d1ec68e6ad 100644
--- a/pkg/workflow/script_registry.go
+++ b/pkg/workflow/script_registry.go
@@ -1,4 +1,4 @@
-// Package workflow provides a ScriptRegistry for managing JavaScript script bundling.
+// This file provides a ScriptRegistry for managing JavaScript script bundling.
 //
 // # Script Registry Pattern
 //
@@ -50,6 +50,7 @@
 // the script was registered with. This catches configuration errors at compile time
 // rather than at runtime. If there's a mismatch, a warning is logged but the script
 // is still returned to avoid breaking workflows.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/scripts.go b/pkg/workflow/scripts.go
index 15a7194d58..c4aea5b1f5 100644
--- a/pkg/workflow/scripts.go
+++ b/pkg/workflow/scripts.go
@@ -1,4 +1,4 @@
-// Package workflow provides embedded JavaScript scripts for GitHub Actions workflows.
+// This file provides embedded JavaScript scripts for GitHub Actions workflows.
 //
 // # Script Registry Pattern
 //
@@ -6,6 +6,7 @@
 // has been removed. Scripts are now provided by the actions/setup action at runtime.
 //
 // See script_registry.go for the ScriptRegistry implementation.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/strict_mode_validation.go b/pkg/workflow/strict_mode_validation.go
index 95850f1b4c..07f103f844 100644
--- a/pkg/workflow/strict_mode_validation.go
+++ b/pkg/workflow/strict_mode_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides strict mode security validation for agentic workflows.
+// This file provides strict mode security validation for agentic workflows.
 //
 // # Strict Mode Validation
 //
@@ -36,6 +36,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/strings.go b/pkg/workflow/strings.go
index 28ba5c450d..1cf7a74362 100644
--- a/pkg/workflow/strings.go
+++ b/pkg/workflow/strings.go
@@ -1,4 +1,4 @@
-// Package workflow provides utilities for processing GitHub Agentic Workflows.
+// This file provides utilities for processing GitHub Agentic Workflows.
 //
 // # String Processing Patterns
 //
@@ -72,6 +72,7 @@
 //   - Input is already valid but needs format conversion
 //
 // See specs/string-sanitization-normalization.md for detailed guidance.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/template_injection_validation.go b/pkg/workflow/template_injection_validation.go
index 89d0a1daaf..27558b330e 100644
--- a/pkg/workflow/template_injection_validation.go
+++ b/pkg/workflow/template_injection_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides template injection vulnerability detection.
+// This file provides template injection vulnerability detection.
 //
 // # Template Injection Detection
 //
@@ -44,6 +44,7 @@
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md and
 // specs/template-injection-prevention.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/template_validation.go b/pkg/workflow/template_validation.go
index 9f5bae4c61..7016749bb5 100644
--- a/pkg/workflow/template_validation.go
+++ b/pkg/workflow/template_validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides template structure validation for agentic workflows.
+// This file provides template structure validation for agentic workflows.
 //
 // # Template Validation
 //
@@ -26,6 +26,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (
diff --git a/pkg/workflow/tools_parser.go b/pkg/workflow/tools_parser.go
index a39884f379..3f101baf6e 100644
--- a/pkg/workflow/tools_parser.go
+++ b/pkg/workflow/tools_parser.go
@@ -1,4 +1,4 @@
-// Package workflow provides tool configuration parsing for agentic workflows.
+// This file provides tool configuration parsing for agentic workflows.
 //
 // This file handles parsing of tool configurations from the frontmatter tools section.
 // It extracts and validates tool configurations for all supported tools, converting
@@ -47,6 +47,7 @@
 //  4. Return strongly-typed configuration struct
 //
 // This provides type safety while accommodating flexible YAML syntax.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/update_entity_helpers.go b/pkg/workflow/update_entity_helpers.go
index 8ba144ffb7..a0c1227f5e 100644
--- a/pkg/workflow/update_entity_helpers.go
+++ b/pkg/workflow/update_entity_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides helper functions for updating GitHub entities.
+// This file provides helper functions for updating GitHub entities.
 //
 // This file contains shared utilities for building update entity jobs (issues,
 // pull requests, discussions, releases). These helpers extract common patterns
@@ -58,6 +58,7 @@
 // For create/close operations, see:
 //   - create_*.go files for entity creation logic
 //   - close_entity_helpers.go for entity close logic
+
 package workflow
 
 import (
diff --git a/pkg/workflow/validation.go b/pkg/workflow/validation.go
index 11c5dee279..296bb3307e 100644
--- a/pkg/workflow/validation.go
+++ b/pkg/workflow/validation.go
@@ -1,4 +1,4 @@
-// Package workflow provides validation functions for agentic workflow compilation.
+// This file provides validation functions for agentic workflow compilation.
 //
 // # Validation Architecture
 //
@@ -44,4 +44,5 @@
 //   - Size limit validation: Expression sizes, file sizes
 //   - Feature detection: Repository capabilities
 //   - Security validation: Permission restrictions, expression safety
+
 package workflow
diff --git a/pkg/workflow/validation_helpers.go b/pkg/workflow/validation_helpers.go
index 63cf227b91..202d7771e7 100644
--- a/pkg/workflow/validation_helpers.go
+++ b/pkg/workflow/validation_helpers.go
@@ -1,4 +1,4 @@
-// Package workflow provides validation helper functions for agentic workflow compilation.
+// This file provides validation helper functions for agentic workflow compilation.
 //
 // This file contains reusable validation helpers for common validation patterns
 // such as integer range validation, string validation, and list membership checks.
@@ -31,6 +31,7 @@
 //   - Reduce cognitive overhead when writing new validators
 //
 // For the validation architecture overview, see validation.go.
+
 package workflow
 
 import (
diff --git a/pkg/workflow/yaml.go b/pkg/workflow/yaml.go
index b2647bf2a6..8186f7a084 100644
--- a/pkg/workflow/yaml.go
+++ b/pkg/workflow/yaml.go
@@ -1,4 +1,4 @@
-// Package workflow provides utilities for compiling agentic workflows into GitHub Actions YAML.
+// This file provides utilities for compiling agentic workflows into GitHub Actions YAML.
 //
 // This file contains YAML marshaling utilities with deterministic field ordering,
 // which is essential for GitHub Actions workflows to maintain readability and consistency.
@@ -80,6 +80,7 @@
 //
 // GitHub Actions best practices:
 // https://docs.github.com/en/actions/learn-github-actions/usage-limits-billing-and-administration
+
 package workflow
 
 import (