Engineering Excellence

Simple solutions that scale: documented so the next agent does not over-build or repeat work.

Always on for every chat that plans or changes code. See reference/engineering-always-on.md and hub docs/always-on-skills.md.

All artifacts go under .heyeddi/docs/: never repo root.

When to use

• Every chat that proposes an implementation plan or edits code
• After a feature ships: capture how it works
• Before adding abstractions: check reuse catalog
• Refactor / architecture review: KISS, YAGNI, SOLID
• User asks: "don't over-engineer", "document the system", "engineering notes"

Subagents (default)

See reference/subagents.md. Delegate audit_engineering.py, check_engineering_plan.py, and doc init to Task shell. Main chat interprets findings and updates living docs.