docs: add guidance on reading code and preferring simple solutions #14

Merged
addison merged 1 commit from exe-dev-bot/shelley-extras:docs/read-code-prefer-simple into main 2026-01-31 16:55:56 -05:00
Contributor

Learnings from spec review

Two mistakes from this session:

  1. Made claims about FK constraints without reading the code - User called me out. Added: "Read the code before making claims"

  2. Proposed complex UUID generation on import when simpler int→text conversion worked - Added: "Prefer simple solutions"

## Learnings from spec review Two mistakes from this session: 1. **Made claims about FK constraints without reading the code** - User called me out. Added: "Read the code before making claims" 2. **Proposed complex UUID generation on import when simpler int→text conversion worked** - Added: "Prefer simple solutions"
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
kwila/shelley-extras!14
No description provided.