Skip to content

Split ACTION_REPO_STANDARDS.md by flavor + audit labels.json #265

@jdfalk

Description

@jdfalk

Tracked from bootstrap-repo skill design (2026-04-24). Originally planned as a parallel subagent task but the subagent harness in this session is gated from Bash. Filing as a follow-up.

Deliverables

1. Split standards by flavor

Split ACTION_REPO_STANDARDS.md into three flavor-specific docs under docs/standards/:

  • action-repo.md — current action standards, lightly reorganized
  • library-repo.md — Go/Rust/Python/TS libraries; remove action-specific files; add "Public API surface" / CHANGELOG section
  • service-repo.md — deployable services; add Dockerfile + Deployment section + recommend publish-docker.yml
  • README.md — index, "Choosing a flavor" guide

Each flavor doc structure:

  1. Required Files
  2. Recommended Files
  3. Repository Settings — delegate to bootstrap-repo skill
  4. Branch Protection — delegate to bootstrap-repo skill
  5. Labels — cite labels.json

2. Audit labels.json

Current labels.json has 242 entries, all grey (ededed), mostly empty descriptions. Audit against live label sets in non-archived jdfalk/* repos via gh api repos/:owner/:repo/labels --paginate.

Output docs/label-audit-YYYY-MM-DD.md:

  1. Counts: canonical, total unique, missing-from-canonical, unused-canonical
  2. Labels in live repos but missing from canonical (table)
  3. Canonical labels not used anywhere (table; flag removal candidates)
  4. Color/description proposals — group by prefix (tech:, priority:, size:, type:, area:, status:); propose coherent color palette per group + 1-line descriptions
  5. Recommended next steps — labels.json changes in a follow-up PR (audit is read-only)

3. Update pointers

AGENTS.md and CLAUDE.md: additive references to docs/standards/ and .claude/skills/bootstrap-repo/.

Constraints

  • Audit is read-only — do NOT modify labels.json in this PR
  • Keep ACTION_REPO_STANDARDS.md until flavor docs are reviewed; deprecation banner once split is merged
  • Skip archived repos; tolerate rate-limit/404 with notes

Why deferred

Mechanical work (read 50+ repos, transform JSON, write markdown) — Haiku/Sonnet appropriate, but the subagent harness in the originating session blocks Bash. Run as a fresh session or scheduled remote agent.

Cross-references: bootstrap-repo skill PR (forthcoming), issue #264 (secrets automation).

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions