docs(rules): codify prefer-DIY-over-heavy-dependency principle#334
Merged
Conversation
Distilled from replacing CrystalRCM.app (a mounted, unaudited macOS GUI binary) with a ~215-line auditable script in nintendo-switch-cfw: before depending on a heavy single-purpose tool, evaluate whether the underlying operation is simple/documented enough to own directly and verify against an authoritative source. Not a mandate to always DIY, but the evaluation itself should always happen. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018vWn8iSZWh7Yd3KRsPXeJm
github-actions
Bot
added
documentation
Contributor
|
| Status | Count |
|---|---|
| 🔍 Total | 170 |
| ✅ Successful | 160 |
| ⏳ Timeouts | 0 |
| 🔀 Redirected | 0 |
| 👻 Excluded | 9 |
| ❓ Unknown | 0 |
| 🚫 Errors | 1 |
Errors per input
Errors in exact_dot_claude/docs/prds/daily-catchup.PRD.md
- [404] https://docs.anthropic.com/claude-code/commands | Failed: Network error: Not Found
Full Github Actions output
Please fix the broken links before merging.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
rules/prefer-diy-over-heavy-dependency.md: before depending on a heavy single-purpose tool (GUI app, bundled runtime, non-cross-platform binary), always evaluate a transparent DIY reimplementation — not a mandate to always DIY, but the evaluation itself is never optional. Includes green/red-light checklists, a verify-against-authoritative-source discipline for anything DIY'd, and a worked example.CLAUDE.md's Core section, same pattern as the existing skill-catalog-check pointer.Distilled from this session's nintendo-switch-cfw work: replaced
CrystalRCM.app(a mounted, unaudited macOS GUI binary) with a ~215-line auditableuv runscript, cross-verified byte-for-byte against two independent open-source reference implementations before being trusted.Test plan
chezmoi apply -v ~/.claudedeployed and diffed clean against source🤖 Generated with Claude Code
https://claude.ai/code/session_018vWn8iSZWh7Yd3KRsPXeJm