Skip to content

Octo 11470#369

Merged
OlteanuRares merged 17 commits into
mainfrom
OCTO-11470
Apr 30, 2026
Merged

Octo 11470#369
OlteanuRares merged 17 commits into
mainfrom
OCTO-11470

Conversation

@OlteanuRares
Copy link
Copy Markdown
Contributor

@OlteanuRares OlteanuRares commented Apr 28, 2026

Add Claude Code compliance skills, CI workflows, and spec documentation

What's included

12 Claude Code skills** (.claude/skills/):

  • analyze-{scc,vtt,dfxp}-docs — generate spec summaries from public sources
  • check-{scc,vtt,dfxp}-compliance — deep validation with 235+ rules and 621 control codes
  • suggest-{scc,vtt,dfxp}-fixes — analyze compliance reports, generate targeted code fixes
  • run-all-compliance — run all 3 checks in sequence
  • check-last-pr — PR-level compliance review with regression detection

6 GitHub Actions workflows** (.github/workflows/):

  • Per-format compliance checks (SCC, VTT, DFXP) — manual trigger, artifact upload, optional Slack notification
  • Combined all-checks workflow with summary table
  • PR compliance check — triggers on pull_request and workflow_dispatch, comments on PR
  • Bi-annual spec refresh reminder via Slack

Spec documentation** (ai_artifacts/specs/):

  • Spec summaries, master checklists, and web source references for all 3 formats
  • Baseline compliance reports (ai_artifacts/compliance_checks/)

@OlteanuRares OlteanuRares requested a review from a team as a code owner April 28, 2026 20:24
@OlteanuRares
Copy link
Copy Markdown
Contributor Author

OlteanuRares commented Apr 28, 2026

Note:
analyze-*-docs skills are agent-driven (use WebFetch/WebSearch) and must be run locally.
All other skills can run locally or via GitHub Actions.

Copy link
Copy Markdown
Collaborator

@lorandvarga lorandvarga left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make sure we don't commit proprietary information.

    scripts never produce; now grep metrics from report markdown directly
  - Fix DFXP extraction bugs: wrong ERE alternation, incorrect value from
    shared footer line, broken shell precedence in fallback
  - Pin archive/github-actions-slack to commit SHA for supply-chain safety
  - Replace grep -oP (Perl-only) with portable grep -oE
  - Sanitize pr_summary.txt ingestion with allowlist-only key extraction
  - Fix Python version inconsistency (3.x -> 3.11) in all_compliance_checks
  - Fix incorrect RU4 suggestion: 94a7 is correct per CEA-608 odd parity
  - Normalize skill filenames (SKILL.md -> skill.md) + update all references
  - Restore docs/conf.py version to 2.2.21 (merge regression)
  - Update skills README with security section and report clarifications
lorandvarga
lorandvarga previously approved these changes Apr 30, 2026
    reports warn when classes/functions have been renamed or moved
  - Add gotchas #10 (SHA-pinning + permissions), #11 (Slack crash
    guard), #12 (fork PR write failures)
  - Expand gotcha #4 with attacker-controlled context value guidance
  - Add SCRIPT_CRASHED guard to Slack success notifications in SCC,
    VTT, and DFXP workflows (gotcha #11)
  - Add continue-on-error to PR comment step for fork safety (gotcha #12)
  - Fix IMPL regex in suggest-dfxp-fixes and suggest-scc-fixes to use
    unified pattern IMPL-(?:[A-Z]+-)?\d{3} (gotcha #7)
  - Add pre-flight and post-run gotcha instructions to all suggest-*
    and analyze-* skills
  - Fix set -e exit capture in run-all-compliance (gotcha #5)
  - Fix source attribution in analyze-scc-docs (gotcha #2)
  - Add frontmatter to run-all-compliance skill
  - Update README with security notes and expanded gotchas summary
@OlteanuRares OlteanuRares merged commit 6512093 into main Apr 30, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants