monolean-minimal-change
Use when implementing or refactoring and you want the smallest change that works: question the need, reuse existing code, prefer stdlib, fix at the root. A decision ladder against over-engineering and new dependencies.
- License 许可
- MIT
- 所属仓库
- monoes/monomind
- 最近更新
- 2026-11-10
- Stars
- ★ 23
- Forks
- 2
01 前言 Front Matter
- name
- monolean-minimal-change
- tags
- [ "engineering", "monomind", "refactor" ]
- tools
- []
- source
- https://github.com/monoes/monomind
- license
- MIT
- description
- Use when implementing or refactoring and you want the smallest change that works: question the need, reuse existing code, prefer stdlib, fix at the root. A decision ladder against over-engineering and new dependencies.
- source_path
- .claude/skills/monolean
03 SKILL.md 正文
Monolean — minimal change
Lazy means efficient, not careless. The best code is the code never written. Understand the task and the code it touches first; then climb the ladder and stop at the first rung that holds.
The ladder
- Does this need to exist at all? Speculative need → skip it and say so in one line of your report.
- Already in this codebase? Reuse the helper, type or pattern that lives a few files over. Look before you write.
- Standard library does it? Use it.
- Native platform feature covers it? CSS over JS, a DB constraint over
app code,
<input type="date">over a picker library. - Already-installed dependency solves it? Use it. Never add a dependency for what a few lines can do.
- Can it be one line? One line.
- Only then: the minimum code that works.
Bug fixes
A report names a symptom. Before editing, find every caller of the function you are about to touch. One guard in the shared function is a smaller diff than a guard in every caller — and it fixes the sibling paths the ticket didn't mention.
Rules
- No abstraction with one implementation, no factory for one product, no config for a value that never changes, no scaffolding "for later".
- Deletion over addition. Boring over clever. Fewest files possible.
- The smallest change in the wrong place is not lean — it is a second bug.
- Two options the same size? Take the one correct on edge cases.
- Mark a deliberate shortcut with a comment naming its ceiling and upgrade
path:
// monolean: global lock, per-account locks if throughput matters.
Handoff
Report the change, then at most three short lines: what you skipped and when it would be worth adding.
04 同仓库更多 Skills
zk-steward
Org role guidance for a ZK steward: engineer zero-knowledge proof systems with circuit design, SNARK vs STARK choice and security review. This is zero-knowledge cryptography, not Zettelkasten note-taking.
writing-plans
Use when you have a spec or requirements for a multi-step coding task and must write an implementation plan before touching code. Produces bite-sized TDD tasks with exact file paths, code and commands for an engineer with zero context.
write-spec
Write a feature spec or PRD from a problem statement or feature idea. Use when turning a vague idea or user request into a structured document, scoping a feature with goals and non-goals, defining success metrics and acceptance criteria, or breaking a big ask into a phased spec.
write-query
Write optimized SQL for your dialect with best practices. Use when translating a natural-language data need into SQL, building a multi-CTE query with joins and aggregations, optimizing a query against a large partitioned table, or getting dialect-specific syntax for Snowflake, BigQuery, Postgres, etc.
workflow-automation
Org role guidance for workflow automation: build and maintain CI/CD definitions in GitHub Actions or equivalent: triggers, jobs, matrices, caching. Covers path filters, dependency caching, parallel jobs, timeouts and fail-fast ordering.
workflow-architect
Org role guidance for a workflow architect: map full workflow trees for systems, user journeys and agents, covering every branch and failure. Covers discovering workflows from code, handoff contracts, timeouts, recovery paths and observable state.