After rapid documentation expansion (Genie role, Zero-Touch Constraint, AI Experience Engineering), Jonathan asked for consistency and slop detection review.
- Zero-Touch Constraint: Concrete, measurable, drives real behavior change
- Genie Protocol: Specific implementation with clear triggers and actions
- Confidence Calibration: Actionable framework ("I'm 85% confident...")
- AI Experience Engineering: Forward-thinking professional positioning with substance
- Generic "continuous improvement" language without concrete mechanisms
- Duplicate meta-goal statements across multiple files
- Vague "research through practice" without specific examples
- Inconsistent role terminology across documents
- Extended role definitions repeated in ROLES.md and PRINCIPLES.md
- Meta-goal nearly identical in multiple locations
- Physics of Work positioned inconsistently (book vs methodology vs framework)
- Standardize terminology across all collaboration documents
- Consolidate duplicate content - establish single authoritative sources
- Add concrete examples to replace generic improvement language
- Create clear document hierarchy - universal → project-specific → implementation
The Zero-Touch Constraint works as intended - rapid iteration revealed documentation debt that needs systematic cleanup. The constraint forces focus on communication precision over content volume.
Anti-Slop Principle: Every sentence should pass the test "If I removed this, would our actual working relationship change?" If no, it's slop.
- Clean up role definition duplication
- Establish PRINCIPLES.md as universal source for shared concepts
- Make project-specific docs reference rather than duplicate universal content
Session reflection on maintaining documentation quality under rapid iteration