engineering-standards

Applies portable engineering judgment principles for rigor, delivery, and escalation decisions.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/tedeuxx/tadeumendonca-skills --skill engineering-standards-tedeuxx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineering-standards
Source: https://github.com/tedeuxx/tadeumendonca-skills/tree/main/skills/engineering-standards
Command: npx skills add https://github.com/tedeuxx/tadeumendonca-skills --skill engineering-standards-tedeuxx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams and AI agents lack a shared, portable set of judgment standards for deciding how much rigor a change deserves, what counts as delivered work, and when to escalate decisions to a human. This Skill encodes those preferences so they apply in any project, independent of a specific agent loop or tooling configuration. ## Core Features & Use Cases - Two-tier rigor model: Distinguishes a non-negotiable quality floor (regression coverage, observability, security-by-design) from risk-calibrated judgment that scales with blast radius. - Twelve working principles: Covers plan-first design, thin vertical slices, surgical changes with tracked debt, and dive-deep investigation discipline. - Delivery vs hygiene accounting: Defines delivered work as user-visible change and requires reporting product slices against hygiene slices each session. - Escalation standard: Specifies a five-clause test and a terse, options-based form for raising decision pendencies versus action pendencies to a human. - Use Case: An agent working in an unfamiliar repository uses these principles to decide whether a refactor needs human sign-off, whether a green CI check is trustworthy evidence, and how to escalate a scope trade-off. ## Quick Start Ask the agent to apply the engineering standards to decide how much rigor a proposed change deserves and whether it should be escalated.

Frequently Asked Questions about engineering-standards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide how much rigor a code change deserves?

Match process weight to blast radius: irreversible, live, or high-coupling changes get maximum rigor with a human in the loop, while cheap-to-revert isolated changes get product speed. The non-negotiable floor of tests, observability, and security posture always applies regardless of risk.

What counts as delivered work versus hygiene work?

A slice is delivered when a reader can do, see, or read something different; everything else, including comments, tests, and process rules, is hygiene. Hygiene is picked up only when it blocks a product slice or in one deliberate bounded batch, and sessions should report product slices against hygiene slices.

When should an AI agent escalate a decision to a human?

Escalate only when a filed work item is being worked, a dispatched subagent hits a trade of time, cost, or scope, and the issue rises through the protocol. The escalation must be terse, carry at most four options for decisions, and carry no options for pure action pendencies.

How do I verify a CI check or test actually works?

Deliberately break the subject the check watches, confirm it goes red, then restore and confirm it goes green again. A check that has only ever passed has been observed passing, not calibrated, and its green result is weak evidence.

Does this Skill depend on a specific agent harness or tooling?

No, the standards are deliberately portable and contain no references to specific personas, hooks, or decision records of any particular loop. Content tied to specific machinery lives in a separate companion skill called agents-configuration.