Skip to content

fix: positive-frame all references for 100% joy-check compliance#635

Merged
notque merged 1 commit into
mainfrom
fix/joy-check-fleet-violations
May 10, 2026
Merged

fix: positive-frame all references for 100% joy-check compliance#635
notque merged 1 commit into
mainfrom
fix/joy-check-fleet-violations

Conversation

@notque
Copy link
Copy Markdown
Owner

@notque notque commented May 10, 2026

Summary

  • Fleet-wide joy-check sweep: 56 violations → 0 across 45 files
  • 22 mechanical fixes: Anti-Pattern headings → Common Failure Modes via expanded bulk_fix_instruction_joy.py
  • 28 editorial fixes: NEVER/Don't/Avoid/do NOT → positive action framing, substance preserved
  • 3 high-severity template fixes in skill-creator (these were violation generators — every scaffolded agent/skill inherited negative framing)
  • PHILOSOPHY.md added to validator allowlist (teaches patterns by example, not instructions)

Test plan

  • python3 scripts/validate_positive_instruction_docs.py returns count: 0
  • pytest scripts/tests/test_joy_check_instruction_mode.py — 179 tests pass
  • pytest scripts/tests/test_bulk_fix_instruction_joy.py — 3 tests pass
  • CI joy-check job passes
  • Spot-check: rewritten lines preserve original technical meaning

… compliance

Fleet-wide sweep: 56 violations → 0 across 45 files.

Mechanical fixes (22): Anti-Pattern headings → Common Failure Modes
  via expanded bulk_fix_instruction_joy.py SAFE_REWRITES dictionary.

Editorial fixes (28): NEVER/Don't/Avoid/do NOT → positive action framing.
  Each rewrite preserves technical substance, changes only framing direction.

Template fixes (high-severity violation generators):
  - agent-template.md: "Don't add features" → "Scope changes to what was requested"
  - preferred-patterns.md: NEVER/Do NOT in instructional prose → positive framing
  - skill-template.md: NEVER example in teaching table → positive alternative

Infrastructure:
  - PHILOSOPHY.md added to validator allowlist (teaches patterns by example)
  - bulk_fix_instruction_joy.py: 6 → 28 safe rewrite entries
  - test expectations updated for new rewrite values
@notque notque merged commit 326388f into main May 10, 2026
6 checks passed
@notque notque deleted the fix/joy-check-fleet-violations branch May 10, 2026 19:19
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