# Proportional Engineering

> Always-on behavioral guidance to make the smallest maintainable change that satisfies the acceptance criteria, avoiding speculative extras, over-engineering, and disproportionate effort.

- **Type:** Skill
- **Install:** `agentstack add skill-narek-khachikyan-skillranger-core-proportional-engineering`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Narek-Khachikyan](https://agentstack.voostack.com/s/narek-khachikyan)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Narek-Khachikyan](https://github.com/Narek-Khachikyan)
- **Source:** https://github.com/Narek-Khachikyan/SkillRanger/tree/main/registry/skills/core.proportional-engineering
- **Website:** https://skillranger.netlify.app/

## Install

```sh
agentstack add skill-narek-khachikyan-skillranger-core-proportional-engineering
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Proportional Engineering

Use this skill on every SkillRanger-prepared task, regardless of domain, routing mode, or strictness: its rules shape how the work is scoped, planned, and delivered. Do not use it as a task procedure, a substitute for a selected domain skill's workflow, or a reason to skip acceptance criteria.

## Ownership Boundary

- This skill is always-on guidance; it never owns a deliverable, a verification gate, or a run lifecycle decision.
- The selected primary skill and its companions define the task workflow; this skill constrains how much of that workflow to do.
- SkillRanger routing hard vetoes, composition limits, and context budgets remain the enforcement layer; this skill is advisory and cannot override them.

## Decision Rules

- **KISS**: prefer the simplest design that satisfies the acceptance criteria and the project's existing conventions.
- **YAGNI**: do not build speculative generality, configurability, or infrastructure the acceptance criteria do not ask for.
- **Pareto**: spend effort on the change's highest-leverage parts first; stop when the criteria pass and the change is maintainable.
- **Verification proportionality**: run the verification steps the acceptance criteria and the selected verification skills require; do not add a wider evidence matrix on your own initiative.
- **Security proportionality**: apply the security practices that match the change's risk; never weaken safeguards for speed.
- **Scope Expansion Gate**: before adding work beyond the acceptance criteria, state the expansion explicitly, name the extra requirement it serves, and confirm it is actually required; otherwise skip it.
- **Router-row carve-out**: when composing the final change, keep unrelated incidental edits (formatting, refactors, doc touches) out unless the task requires them.
- **Nomination proportionality**: when multiple skill candidates could serve the same role, prefer the smallest coherent selection that covers the requirements; extra skills are not a quality signal.

## Workflow

1. Read the acceptance criteria and the selected skills' mandatory content first.
2. Identify the minimal set of files and behaviors the criteria touch.
3. Plan the smallest change that satisfies the criteria with the project's existing conventions.
4. Implement that plan; resist speculative extras as they surface.
5. Run the verification steps the selected skills require, no more and no less.
6. Review the diff for scope creep before finishing.

## Validation

- Every change in the final diff maps to an acceptance criterion or a named explicit requirement.
- The change is the smallest maintainable one: no dead code, no speculative abstractions, no incidental edits.
- The verification evidence matches exactly what the selected skills and criteria require.

## Output Contract

- Deliver the change with a scope summary: what was done, what was deliberately not done, and why.
- Call out any expansion that went through the Scope Expansion Gate.
- List the verification steps run and their outcomes.

## References

- No packaged references are required for this always-on guidance skill.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Narek-Khachikyan](https://github.com/Narek-Khachikyan)
- **Source:** [Narek-Khachikyan/SkillRanger](https://github.com/Narek-Khachikyan/SkillRanger)
- **License:** MIT
- **Homepage:** https://skillranger.netlify.app/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-narek-khachikyan-skillranger-core-proportional-engineering
- Seller: https://agentstack.voostack.com/s/narek-khachikyan
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.