Skip to content
Skills Library
Programming · Learning & explanation

engineering-principles

/engineering-principles

Apply the engineering principle that settles a coding or review decision, reading only the files that apply. Use when a choice needs a named principle such as fix root causes or explain the number; not for always-on repository rules (use AGENTS.md) and not to run a verification procedure (use prove-it-works or vet-measurement).

Licence
MIT
Last repository change
10.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
25
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Apply the engineering principle that settles a coding or review decision, reading only the files that apply. Use when a choice needs a named principle such as fix root causes or explain the number; not for always-on repository rules (use AGENTS.md) and not to run a verification procedure (use prove-it-works or vet-measurement).

Original author description

Apply the engineering principle that settles a coding or review decision, reading only the files that apply. Use when a choice needs a named principle such as fix root causes or explain the number; not for always-on repository rules (use AGENTS.md) and not to run a verification procedure (use prove-it-works or vet-measurement).

How it works

  1. Core
  2. Architecture
  3. Verification
  4. Delegation
  5. Meta
  6. Done when
Original SKILL.md headings · 48 lines, 460 words
SKILL.md preview
---
name: engineering-principles
description: "Apply the engineering principle that settles a coding or review decision, reading only the files that apply. Use when a choice needs a named principle such as fix root causes or explain the number; not for always-on repository rules (use AGENTS.md) and not to run a verification procedure (use prove-it-works or vet-measurement)."
license: MIT
compatibility: droid
user-invocable: false
allowed-tools:
  - Read
  - Grep
  - Glob
---

# Engineering principles

Each principle is one file beside this one. Read the whole file for any principle you apply, then name it in your reply with the choice it changed. Cite only principles you read this session. Do not load all of them.

## Core

- [laziness-protocol.md](laziness-protocol.md). Refactoring, sizing a diff, or tempted to add a layer. Bias to deletion and the smallest change.
- [foundational-thinking.md](foundational-thinking.md). Before writing logic. Core types and data structures first, scaffold before features.
- [redesign-from-first-principles.md](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](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](subtract-before-you-add.md). Sequencing an addition or rewrite. Remove dead weight first.
- [minimize-reader-load.md](minimize-reader-load.md). Code is hard to trace. Count layers and hidden state, then cut them.
- [outcome-oriented-execution.md](outcome-oriented-execution.md). A planned rewrite or migration with phase boundaries. Converge on the target, skip throwaway compatibility code.
- [experience-first.md](experience-first.md). Product, UX, or scope tradeoffs. Choose the user's experience over implementation convenience.
- [exhaust-the-design-space.md](exhaust-the-design-space.md). A novel interaction or architecture with no precedent. Compare 2 or 3 prototypes before committing.
- [build-the-lever.md](build-the-lever.md). Any non-trivial work. Build the script, codemod, or check that does or proves it.

## Architecture

- [model-the-domain.md](model-the-domain.md). Stateful logic, heavy branching, or a shape assumption repeated across files. Encode the domain in a structure.
- [boundary-discipline.md](boundary-discipline.md). Validation, error handling, or framework adapters. Guard at boundaries, trust internal types.
- [type-system-discipline.md](type-system-discipline.md). Designing types or a signature. Make illegal states unrepresentable.
- [make-operations-idempotent.md](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](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](separate-before-serializing-shared-state.md). Concurrent writers might share a file, branch, or key. Remove the sharing first.

## Verification

- [prove-it-works.md](prove-it-works.md). Before declaring done. Check the real artifact, not a proxy. The procedure is the [prove-it-works](../prove-it-works/SKILL.md) skill.
- [fix-root-causes.md](fix-root-causes.md). Debugging. Fix the first place the system went wrong.
- [sequence-verifiable-units.md](sequence-verifiable-units.md). Multi-step work and commit order. Each unit ends in a check.
- [test-behavior-not-implementation.md](test-behavior-not-implementation.md). Writing or keeping a test. Assert what users of the code can observe.
- [explain-the-number.md](explain-the-number.md). Before trusting or reporting a measured number. Name the limiter. The procedure is the [vet-measurement](../vet-measurement/SKILL.md) skill.

## Delegation

- [guard-the-context-window.md](guard-the-context-window.md). Context is filling up. Send bulk reads to `explorer` Tasks and keep summaries.
- [never-block-on-the-human.md](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](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.
Files in this package (25)
  • SKILL.md 4 KB
  • attack-the-premise.md 2 KB
  • boundary-discipline.md 2 KB
  • build-the-lever.md 2 KB
  • encode-lessons-in-structure.md 1 KB
  • exhaust-the-design-space.md 1 KB
  • experience-first.md 1 KB
  • explain-the-number.md 2 KB
  • fix-root-causes.md 2 KB
  • foundational-thinking.md 1 KB
  • guard-the-context-window.md 1 KB
  • laziness-protocol.md 1 KB
  • make-operations-idempotent.md 2 KB
  • migrate-callers-then-delete-legacy-apis.md 1 KB
  • minimize-reader-load.md 2 KB
  • model-the-domain.md 2 KB
  • never-block-on-the-human.md 1 KB
  • outcome-oriented-execution.md 1 KB
  • prove-it-works.md 1 KB
  • redesign-from-first-principles.md 1 KB
  • separate-before-serializing-shared-state.md 1 KB
  • sequence-verifiable-units.md 2 KB
  • subtract-before-you-add.md 1 KB
  • test-behavior-not-implementation.md 2 KB
  • type-system-discipline.md 1 KB

Versions

RepositoryScoreLicence
This page · Cynnamoroll/factory-stack90MIT
joeblackwaslike/agent-skills100MIT
wolfinApp/wolfin-senior100MIT
johantor/brain86Apache-2.0
voyager67/Agent-Workbench86MIT
ericwang200608-beep/LANYANT-Skills85MIT
jstarfilms/vibecode-protocol-suite85ISC

Database snapshot: 13.11.2026 · package version 9d8efa29227d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 86principle-fix-root-causes
    Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.
  • 86principle-fix-root-causes
    Apply when debugging or reaching for a try/except guard. Trace the symptom to its root cause; resist broad exception swallowing and nil-checks that silence crashes.
  • 86principle-fix-root-causes
    Apply when debugging. Trace each symptom back to the first place the system went wrong and fix it there. A guard is a fix only when the state it handles is legitimate. Use for /principle-fix-root-causes.
  • 86principle-fix-root-causes
    Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.
  • 86principle-fix-root-causes
    Apply when debugging. Trace each symptom to its root cause and fix it there; reproduce first, ask why until you reach it, resist nil-check guards that silence crashes.
  • 86principle-fix-root-causes
    Apply when debugging. Trace each symptom to the first place the system did something wrong and fix it there.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.