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:
- Required Files
- Recommended Files
- Repository Settings — delegate to bootstrap-repo skill
- Branch Protection — delegate to bootstrap-repo skill
- 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:
- Counts: canonical, total unique, missing-from-canonical, unused-canonical
- Labels in live repos but missing from canonical (table)
- Canonical labels not used anywhere (table; flag removal candidates)
- Color/description proposals — group by prefix (
tech:, priority:, size:, type:, area:, status:); propose coherent color palette per group + 1-line descriptions
- 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).
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.mdinto three flavor-specific docs underdocs/standards/:action-repo.md— current action standards, lightly reorganizedlibrary-repo.md— Go/Rust/Python/TS libraries; remove action-specific files; add "Public API surface" / CHANGELOG sectionservice-repo.md— deployable services; add Dockerfile + Deployment section + recommendpublish-docker.ymlREADME.md— index, "Choosing a flavor" guideEach flavor doc structure:
labels.json2. Audit
labels.jsonCurrent
labels.jsonhas 242 entries, all grey (ededed), mostly empty descriptions. Audit against live label sets in non-archivedjdfalk/*repos viagh api repos/:owner/:repo/labels --paginate.Output
docs/label-audit-YYYY-MM-DD.md:tech:,priority:,size:,type:,area:,status:); propose coherent color palette per group + 1-line descriptionslabels.jsonchanges in a follow-up PR (audit is read-only)3. Update pointers
AGENTS.mdandCLAUDE.md: additive references todocs/standards/and.claude/skills/bootstrap-repo/.Constraints
labels.jsonin this PRACTION_REPO_STANDARDS.mduntil flavor docs are reviewed; deprecation banner once split is mergedWhy 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).