AI Developer Guide - Technical Decision Criteria and Anti-pattern Collection

Language-Specific References

For frontend-specific anti-patterns, debugging, and quality checks:

• React/TypeScript Frontend: references/frontend.md

Value-First Engineering [MANDATORY]

Explore broadly, then converge on the lowest-lifecycle-cost solution that delivers user value and leaves the system correct and maintainable.

• Resolve verified bugs, failing quality checks, and technical debt within confirmed scope or dependencies required for its outcome; report other findings separately.
• Introduce capabilities, infrastructure, abstractions, or speculative edge-case handling only when a current outcome, verified constraint, or evidence-backed material risk requires them.
• When resolving a known problem falls outside that boundary or materially changes behavior, architecture, or effort, obtain an explicit scope decision.

Technical Anti-patterns (Red Flag Patterns) [MANDATORY]

IMMEDIATELY stop and reconsider design when detecting the following patterns: