khaneliman avatar

engineering-principles

Principles for lean, verified agentic work.

version
0.1.22
GitHub stars
347

Install

/plugin install engineering-principles@khanelinix-ai-tools

Run it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.

Contents

Discovered from source

Skills 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.

PrincipleApply when
laziness-protocolRefactoring, sizing a diff, or tempted to add abstractions, layers, or signal threading.
model-the-domainStateful logic, repeated shape assumptions, or branching spread across files.
separate-before-serializing-shared-stateMultiple writers contend for one slot, cache, or merged config value.
boundary-disciplineValidation, error handling, parsing, framework adapters, or external data.
make-operations-idempotentActivation, migration, install, retry, or hook paths that can run twice.
type-system-disciplineTypes or signatures in a statically typed language.
subtract-before-you-addSequencing an addition, refactor, or rewrite. Remove dead weight first.
migrate-callers-then-delete-legacy-apisReplacing an API or call path. Migrate callers and delete the old path together.
minimize-reader-loadCode that requires too many layers or too much hidden state to understand.
fix-root-causesDebugging. Establish the failure and fix it where the behavior belongs.
sequence-verifiable-unitsMulti-step work and commit or PR stacking. Verify each unit before the next.
verified-sliceImplementing one reviewable, reversible unit with evidence and commit authority.
prove-it-worksAfter completing a task, before declaring done. Check the real artifact.
premise-reviewAny 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-windowContext fills up: large outputs, long files, repeated reads, fan-out planning.
encode-lessons-in-structureThe same instruction gets written a second time, or a correction recurs.
build-the-leverRepetition, 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