Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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-principles

About 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 explorer Tasks 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.