Objective

Integrate github/gh-aw to improve local inspection and maintenance of workflow and action inputs before/after runs.

Current Limitation

Action workflows are currently observed only through GitHub-side context in several scenarios, which reduces confidence in local reproducibility and slows review of workflow wiring changes.

Proposed Work

• Evaluate and adopt github/gh-aw as part of the dev-tools action-inspection flow.
• Add usage docs and examples that show how gh-aw can inspect workflows/actions used in this repo.
• Integrate this usage into contributor docs for faster validation of action inputs and metadata.
• Ensure the flow is safe for CI review without requiring external mutable state.

Scope

• In-scope: documentation, local verification workflow command examples, and optional lightweight helper scripts.
• Out-of-scope: replacing existing CI orchestration primitives in this milestone.

Non-goals

• Do not add invasive changes to runtime command behavior that are unrelated to workflow inspection.
• Do not introduce a new CI dependency stack unless justified by measurable validation coverage.

Acceptance Criteria

Delivery Criteria

• github/gh-aw usage is documented for inspecting workflows and action references in dev-tools.
• A repeatable local runbook exists for at least one action-related review use case.
• The recommendation includes expected output or interpretation notes.

Architectural / Isolation Criteria

• MUST: The affected command/controller layer MUST act only as an orchestrator.
• MUST: The solution MUST avoid tight coupling between core behavior and CLI or framework-specific I/O.
• MUST: Responsibilities MUST be separated across input resolution, domain logic, processing or transformation, and output rendering when the change is non-trivial.