Skip to content

YNU-864: Harness rule cleanup#151

Merged
ihsraham merged 1 commit intodocs/reorg-for-v1from
chore/ynu-864-harness-cleanup
May 8, 2026
Merged

YNU-864: Harness rule cleanup#151
ihsraham merged 1 commit intodocs/reorg-for-v1from
chore/ynu-864-harness-cleanup

Conversation

@ihsraham
Copy link
Copy Markdown
Collaborator

@ihsraham ihsraham commented May 8, 2026

Summary

Follow-up to #150 that tightens the docs language harness before it is promoted from advisory to blocking.

What changed

  • Disabled quadrant-specific rules by default in the root Vale config so per-folder overlays opt in explicitly.
  • Narrowed the AISlop harness token to verbal context, so noun usage like "language harness" does not trigger.
  • Dropped the broad NeedBasedLabels catch-all and kept the explicit internal-label examples.
  • Replaced the aggregate BuildPageShape rule with four distinct heading-specific error-level rules.
  • Added directional LearnCrossLink and ProtocolCrossLink rules, both disabled by default until overlays activate them.
  • Removed the non-directional CrossLink.yml rule.

Context

The original harness skeleton landed in #150. This cleanup follows the language harness PRD at ynu-864-yellow-docs-v1-review/05-language-harness-prd.md, especially sections 5, 6, 7, 9, and 11.

Validation

  • Installed and used Vale 3.14.1 locally.
  • vale ls-config 2>&1 | grep -i "BuildPageShape" shows four distinct rule names: BuildPageShapeTLDR, BuildPageShapeStepByStep, BuildPageShapeVerify, and BuildPageShapeNextSteps.
  • vale --minAlertLevel=error templates returns 0 findings.
  • vale --minAlertLevel=error docs | tail -20 still shows the existing 71 docs findings from YNU-864: Add language harness skeleton #150-era advisory mode; this PR does not change docs content.
  • Parsed every Yellow rule file with PyYAML in a temporary venv.
  • npm run build 2>&1 | tail -10 succeeds with the same existing 0.5.x broken-link/anchor warning tail.
  • git diff --check passes.
  • Signed commit verified locally with the repo's 1Password SSH signing key.

Tightens six pre-promotion issues in the language harness from #150:

- Disable NoMetaphor/SpecVoice/NoNarrative/cross-link/BuildPageShape rules by default; overlays opt in.

- Narrow AISlop.harness to verbal context so the noun usage stops triggering.

- Drop NeedBasedLabels catch-all; keep explicit token list.

- Split BuildPageShape into four heading-specific error-level rules.

- Add LearnCrossLink and ProtocolCrossLink rule files (disabled by default; activated per-overlay).

- Remove non-directional CrossLink.yml.
@ihsraham ihsraham requested a review from dpatsora as a code owner May 8, 2026 06:33
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 8, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 98fa6b18-d519-4a6c-ae89-d3bc3b91e22b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/ynu-864-harness-cleanup

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ihsraham ihsraham merged commit 6b04e2c into docs/reorg-for-v1 May 8, 2026
4 checks passed
@ihsraham ihsraham deleted the chore/ynu-864-harness-cleanup branch May 8, 2026 06:38
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.

1 participant