Skip to content

[refactoring] Extract daily-audit-base triple import stack into shared/daily-audit-base.md #26626

@github-actions

Description

@github-actions

Skill Overview

10 workflows currently import the exact same three components together: shared/daily-audit-discussion.md (parameterized with a title-prefix) + shared/reporting.md + shared/observability-otlp.md. This "daily audit stack" is the standard configuration for workflows that publish daily audit reports to GitHub Discussions with full telemetry.

A shared/daily-audit-base.md wrapper would bundle all three, reducing 3 imports to 1 while passing through the required title-prefix parameter.

Furthermore, 31 more workflows use daily-audit-discussion + reporting but lack OTLP observability. Migrating them to daily-audit-base.md would automatically add observability tracking to those workflows.

Current Usage

10 confirmed workflows use all three together:

  • daily-code-metrics.md
  • daily-compiler-quality.md
  • daily-firewall-report.md
  • daily-integrity-analysis.md
  • daily-issues-report.md
  • daily-observability-report.md
  • daily-performance-summary.md
  • daily-regulatory.md
  • daily-secrets-analysis.md
  • daily-team-evolution-insights.md

31 additional workflows use daily-audit-discussion + reporting (without OTLP) and could benefit:

  • audit-workflows.md, blog-auditor.md, copilot-pr-nlp-analysis.md, copilot-session-insights.md, copilot-token-audit.md, developer-docs-consolidator.md, docs-noob-tester.md, example-workflow-analyzer.md, github-mcp-structural-analysis.md, github-mcp-tools-report.md, go-fan.md, lockfile-stats.md, mcp-inspector.md, portfolio-analyst.md, prompt-clustering-analysis.md, repo-audit-analyzer.md, repository-quality-improver.md, safe-output-health.md, schema-consistency-checker.md, sergo.md, terminal-stylist.md, typist.md, weekly-issue-summary.md, and more.

Proposed Shared Component

File: .github/workflows/shared/daily-audit-base.md

---
# Daily Audit Base - Standard stack for daily audit workflows publishing to GitHub Discussions.
# Bundles: daily-audit-discussion + reporting guidelines + OTLP observability.
#
# Usage:
#   imports:
#     - uses: shared/daily-audit-base.md
#       with:
#         title-prefix: "[my-workflow] "
#         expires: "1d"      # optional, default: 3d

import-schema:
  title-prefix:
    type: string
    required: true
    description: "Title prefix for created discussions, e.g. '[daily-report] '"
  expires:
    type: string
    default: "3d"
    description: "How long to keep discussions before expiry"

imports:
  - uses: shared/daily-audit-discussion.md
    with:
      title-prefix: $\{\{ github.aw.import-inputs.title-prefix }}
      expires: $\{\{ github.aw.import-inputs.expires }}
  - shared/reporting.md
  - shared/observability-otlp.md
---

Usage Example (before):

imports:
  - uses: shared/daily-audit-discussion.md
    with:
      title-prefix: "[my-workflow] "
  - shared/reporting.md
  - shared/observability-otlp.md

Usage Example (after):

imports:
  - uses: shared/daily-audit-base.md
    with:
      title-prefix: "[my-workflow] "

Impact

  • Workflows affected (immediate): 10 workflows (3 imports → 1 import each)
  • Workflows affected (with migration): Up to 41 workflows (adding automatic OTLP to 31 that lack it)
  • Lines saved: 10 × 3 = 30 lines immediately; up to 41 × 2 = 82 more lines with full migration
  • Observability improvement: 31 daily-audit-discussion workflows gain OTLP telemetry automatically

Implementation Plan

  1. Create .github/workflows/shared/daily-audit-base.md with parameterized import-schema
  2. Test with daily-observability-report.md as pilot (simplest: only 3 imports + OTLP)
  3. Run make recompile to verify compiled output is identical
  4. Migrate the 10 confirmed triple-import workflows in a single PR
  5. Evaluate migrating the 31 additional daily-audit-discussion workflows for OTLP coverage
  6. Update workflow authoring documentation to recommend daily-audit-base.md as the default for daily audit workflows

Related Analysis

This recommendation comes from the Workflow Skill Extractor analysis run on 2026-04-16.

Quantitative Impact Summary:

Metric Value
Confirmed triple-import workflows 10
Additional workflows that could adopt 31
Import lines eliminated (immediate) 30
Observability gaps closed (full migration) 31
Complexity Medium (parameterized wrapper)

Generated by Workflow Skill Extractor · ● 5M ·

  • expires on Apr 18, 2026, 11:48 AM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions