engineering-principles
Apply named principles to coding or review decisions, such as fix root causes or explain the number. Read only relevant files; use AGENTS.md for repository rules, prove-it-works or vet-measurement for verification procedures.
Cynnamoroll · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Cynnamoroll/factory-stack --skill engineering-principlesAbout this skill
name: engineering-principles description: "Apply named principles to coding or review decisions, such as fix root causes or explain the number. Read only relevant files; use AGENTS.md for repository rules, prove-it-works or vet-measurement for verification procedures." license: MIT compatibility: droid user-invocable: false allowed-tools:
- Read
- Grep
- Glob
Engineering principles
Read each applied principle's whole file, then name the decision it changed in your reply. Load only relevant principles and cite only those read this session.
Core
- laziness-protocol.md. Refactoring, sizing a diff, or tempted to add a layer. Bias to deletion and the smallest change.
- foundational-thinking.md. Before writing logic. Core types and data structures first, scaffold before features.
- redesign-from-first-principles.md. A new requirement meets an existing design. Redesign as if it had been there from the start.
- attack-the-premise.md. Two fixes that share one premise failed the same gate. Test the premise before a third fix.
- subtract-before-you-add.md. Sequencing an addition or rewrite. Remove dead weight first.
- minimize-reader-load.md. Code is hard to trace. Count layers and hidden state, then cut them.
- outcome-oriented-execution.md. A planned rewrite or migration with phase boundaries. Converge on the target, skip throwaway compatibility code.
- experience-first.md. Product, UX, or scope tradeoffs. Choose the user's experience over implementation convenience.
- exhaust-the-design-space.md. A novel interaction or architecture with no precedent. Compare 2 or 3 prototypes before committing.
- build-the-lever.md. Any non-trivial work. Build the script, codemod, or check that does or proves it.
Architecture
- model-the-domain.md. Stateful logic, heavy branching, or a shape assumption repeated across files. Encode the domain in a structure.
- boundary-discipline.md. Validation, error handling, or framework adapters. Guard at boundaries, trust internal types.
- type-system-discipline.md. Designing types or a signature. Make illegal states unrepresentable.
- make-operations-idempotent.md. Commands or loops that run amid crashes and retries. Converge to one end state.
- migrate-callers-then-delete-legacy-apis.md. A new internal API while old callers exist. Migrate and delete in one wave.
- separate-before-serializing-shared-state.md. Concurrent writers might share a file, branch, or key. Remove the sharing first.
Verification
- prove-it-works.md. Before declaring done. Check the real artifact, not a proxy. The procedure is the prove-it-works skill.
- fix-root-causes.md. Debugging. Fix the first place the system went wrong.
- sequence-verifiable-units.md. Multi-step work and commit order. Each unit ends in a check.
- test-behavior-not-implementation.md. Writing or keeping a test. Assert what users of the code can observe.
- explain-the-number.md. Before trusting or reporting a measured number. Name the limiter. The procedure is the vet-measurement skill.
Delegation
- guard-the-context-window.md. Context is filling up. Send bulk reads to
explorerTasks and keep summaries. - never-block-on-the-human.md. Tempted to ask "should I do X?" on reversible work. Do it and report.
Meta
- encode-lessons-in-structure.md. The same instruction comes up a second time. Make it a check, not more text. The procedure is
/add-guardrail.
Done when
Every principle named in the reply was read in full this session, and each one is tied to a specific decision it changed.