fission-ai__openspec/openspec/changes/add-complexity-guidelines/proposal.md

Add Complexity Management Guidelines

Why

OpenSpec currently lacks guidance on managing complexity, leading to over-engineered solutions when simple ones suffice.

What Changes

• Add "Start Simple" section to openspec/README.md with default minimalism rules
• Add complexity triggers to help identify when complexity is justified
• Enhance AI assistant instructions in CLAUDE.md to bias toward simplicity

Impact

• Affected specs: None (documentation only)
• Affected code: openspec/README.md, CLAUDE.md