coding-principles skillA
This file is byte-identical to the first copy the registry indexed, one of 5 copies on public GitHub. Same content hash, same audit grade.
coding-principles is agent-read markdown (skill) from shinpr/claude-code-workflows: Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features, refactoring code, or reviewing code quality..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Language-Agnostic Coding Principles ## Core Philosophy 1. **Maintainability over Speed**: Prioritize long-term code health over initial development velocity 2. **Simplicity First**: Choose the simplest solution that meets requirements (YAGNI principle) 3. **Design Convergence**: Deliver the current required outcome with the least new design surface. Selecting persistent state, public or cross-boundary contracts, behavioral modes, reusable abstractions, or component splits carries enough surface to justify the full convergence process first. 4. **Explicit over Implicit**: Make intentions clear through code structure and naming 5. **Delete over Comment**: Remove unused code instead of commenting it out ## Code Quality ### Continuous Improvement - Refactor related code inside the accepted outcome and governing boundaries when it reduces the change's risk or maintenance cost - Improve code structure incrementally - Keep the codebase lean and focused - Delete code proven obsolete by the requested change after checking its callers; report uncertain or out-of-scope cleanup separately ### Readability - Use meaningful, descriptive names drawn from the problem domain …
Read the whole file at its exact version.
How to install
mdr add shinpr/claude-code-workflows/coding-principles@git:20260922.7c4e3a7mdr add shinpr/claude-code-workflows/coding-principles@sha256:9c763aaf131c6e7aPin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_yvhxgv6pw6laejl6)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260922.7c4e3a7 latest | 2026-09-22 | 7c4e3a7 | 9,597 B | A | view · diff |
| git:20260809.6130272 | 2026-08-09 | 6130272 | 9,177 B | A | view · diff |
| git:20260806.d8a29d4 | 2026-08-06 | d8a29d4 | 9,242 B | A | view · diff |
| git:20260731.d086ac8 | 2026-07-31 | d086ac8 | 9,242 B | A | view · diff |
| git:20260728.e9e235b | 2026-07-28 | e9e235b | 9,206 B | A | view · diff |
| git:20260726.b3981e0 | 2026-07-26 | b3981e0 | 11,203 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9597 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
shinpr/claude-code-workflows · 684 stars · license MIT · pushed 2026-09-24 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yvhxgv6pw6laejl6 GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/claude-code-workflows/coding-principles GET https://markdownregistry.com/api/v1/blob/9c763aaf131c6e7aa84012a5acf4a04cb1485426d8a6df2d6a184eb0fc97af70
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from shinpr/claude-code-workflows
Every file in shinpr/claude-code-workflows