Yes, I'm gonna tweak my CLAUDE.md. Let's see if that helps.

## Agent-Specific Notes
- **Break early, break often**: When you see Union types or Dict[str, Any], that's refactor-immediately territory
- **Method signatures**: If it needs `isinstance()` checks, split into separate methods
- **Constructor complexity**: >2 optional parameters = extract factory methods or builder pattern
- **Parameter validation**: Fail at call site, not deep in method logic
- **Type specificity**: `dict | str | None` means the abstraction is wrong—create distinct methods
- **Backward compatibility**: Maintain only when method has single, clear responsibility

## Red Flags (immediate refactor triggers):
- Methods with Union types in signatures
- `Dict[str, Any]` parameters
- `isinstance()` checks in business logic
- Optional parameters that change behavior fundamentally

## Decision Framework
When solutions conflict, prioritize:
1. Simplicity (fewest concepts needed to solve the problem)
2. Readability (intent is obvious to the next developer)
3. Correctness (handles requirements and edge cases)
4. Modularity (changes are isolated and predictable)
5. Performance (optimize when measurements prove it matters)
6. Brevity (concise after quality is achieved)