
engineering-principles
Principles for lean, verified agentic work.
- version
- 0.1.22
- GitHub stars
- 347
Install
/plugin install engineering-principles@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
Engineering Principles
Seventeen principles, one index. Match the situation to a row, then read that reference in full before applying it. Each reference is short.
| Principle | Apply when |
|---|---|
| laziness-protocol | Refactoring, sizing a diff, or tempted to add abstractions, layers, or signal threading. |
| model-the-domain | Stateful logic, repeated shape assumptions, or branching spread across files. |
| separate-before-serializing-shared-state | Multiple writers contend for one slot, cache, or merged config value. |
| boundary-discipline | Validation, error handling, parsing, framework adapters, or external data. |
| make-operations-idempotent | Activation, migration, install, retry, or hook paths that can run twice. |
| type-system-discipline | Types or signatures in a statically typed language. |
| subtract-before-you-add | Sequencing an addition, refactor, or rewrite. Remove dead weight first. |
| migrate-callers-then-delete-legacy-apis | Replacing an API or call path. Migrate callers and delete the old path together. |
| minimize-reader-load | Code that requires too many layers or too much hidden state to understand. |
| fix-root-causes | Debugging. Establish the failure and fix it where the behavior belongs. |
| sequence-verifiable-units | Multi-step work and commit or PR stacking. Verify each unit before the next. |
| verified-slice | Implementing one reviewable, reversible unit with evidence and commit authority. |
| prove-it-works | After completing a task, before declaring done. Check the real artifact. |
| premise-review | Any review of a plan, diff, or PR. The one review contract: decide whether the change should exist before checking whether it works. |
| guard-the-context-window | Context fills up: large outputs, long files, repeated reads, fan-out planning. |
| encode-lessons-in-structure | The same instruction gets written a second time, or a correction recurs. |
| build-the-lever | Repetition, error risk, or reproducibility justifies a tool beyond existing commands. |
Cite a principle only when it changed a concrete choice. A citation with no decision behind it means the reference was skipped.
Workflow skills reference principles by short name, for example "the prove-it-works principle". Resolve those names against this index.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/engineering-principles
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- engineering-workflowv0.1.27
- figure-it-outv0.1.10
- git-toolkitv0.1.15
- github-toolkitv0.1.33
- howv0.1.7
- interrogatev0.1.10
- jj-toolkitv0.1.8
- lua-toolkitv0.2.0
- mcp-builderv0.1.6
- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8