Skip to content

fix(specs): correct repo-health family count in triage-mode.md - #1075

Open
zheflow wants to merge 1 commit into
apache:mainfrom
zheflow:fix-931-repo-health-count
Open

fix(specs): correct repo-health family count in triage-mode.md#1075
zheflow wants to merge 1 commit into
apache:mainfrom
zheflow:fix-931-repo-health-count

Conversation

@zheflow

@zheflow zheflow commented Aug 7, 2026

Copy link
Copy Markdown

Summary

triage-mode.md called repo-health a "five-skill family" while repo-health-family.md says six. The sixth skill, dependency-license-audit, shipped without this spec being updated. Per the maintainer's direction on the issue (Option 1: six read-only audits is the correct count), this PR updates the count to six and adds the missing skill to the list.

Type of change

  • Other: spec documentation (tools/spec-loop/specs/)

Test plan

  • uv run --project tools/spec-validator spec-validate tools/spec-loop/specs/ — OK, no violations
  • prek run --all-files — all 23 hooks pass

RFC-AI-0004 compliance

No runtime behaviour or state-changing workflow is changed — spec prose only.

Linked issues

Closes #931

Notes for reviewers (optional)

Scoped to the prose fix only. The other half of Option 1 — re-keying audit-finding-fix off family: repo-health — is left for a follow-up once the target key is decided (it also feeds the three-way-discrepancy example in spec-gap-staleness.md, which a re-key would invalidate).

Generative AI disclosure

Prepared with Claude Code (Fable 5). The commit carries a Generated-by: trailer and no AI Co-Authored-By: trailer.

Why: triage-mode.md said "five-skill family" while repo-health-family.md
says the family is six skills deep. The sixth skill,
dependency-license-audit, shipped without this spec being updated. The
spec-loop plan beat reads Known gaps to choose the next work item, so
the two specs disagreeing about a countable fact can send the loop at
finished work. Per the maintainer's direction on the issue (Option 1),
six read-only audits is the correct count; re-keying audit-finding-fix
off family:repo-health is left for a follow-up once the target key is
decided.

Closes apache#931

Generated-by: Claude Code (Fable 5)
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.

Correct the repo-health family skill count in triage-mode.md

1 participant