Skip to content

docs: Add polyrhythm support specification#25

Merged
adewale merged 2 commits intomainfrom
claude/add-5-8-time-support-4NOvG
Dec 30, 2025
Merged

docs: Add polyrhythm support specification#25
adewale merged 2 commits intomainfrom
claude/add-5-8-time-support-4NOvG

Conversation

@adewale
Copy link
Copy Markdown
Owner

@adewale adewale commented Dec 30, 2025

Defines the plan for adding odd step counts (3, 5, 6, 7, etc.) to enable
true polyrhythmic patterns. Key points:

  • Expand STEP_COUNT_OPTIONS from 9 to 24 options
  • Fix swing behavior to use pattern-local step position
  • Update validation whitelists in worker
  • LCM-based pattern length already works for arbitrary counts

This unlocks polyrhythms like 5:8, 3:4, and 7:8 used in techno, IDM,
and Afrobeat production.

Defines the plan for adding odd step counts (3, 5, 6, 7, etc.) to enable
true polyrhythmic patterns. Key points:

- Expand STEP_COUNT_OPTIONS from 9 to 24 options
- Fix swing behavior to use pattern-local step position
- Update validation whitelists in worker
- LCM-based pattern length already works for arbitrary counts

This unlocks polyrhythms like 5:8, 3:4, and 7:8 used in techno, IDM,
and Afrobeat production.
… analysis

- Add comprehensive research document (specs/research/POLYRHYTHM-RESEARCH.md)
  covering musical theory, hardware survey, and genre-specific patterns
- Document roadmap overlaps (Euclidean, per-track swing, step rotation)
- Add "Extra Features Required" section for Phase 2/3 enhancements
- Document 6 deferred ideas (arbitrary step counts, irrational rhythms, etc.)
- Analyze 5 alternative approaches with pros/cons
- Note: Swing fix is prerequisite for future per-track swing feature
@adewale adewale merged commit a759581 into main Dec 30, 2025
3 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants