SongScaffoldCodex

SongScaffoldCodex is an Android app for generating structured constraints for improvised songs. It does not write songs for the user; it helps reduce blank-page pressure by guiding the user through creative choices such as topic, point of view, delivery mode, phrasing style, emotional intensity, chord progression, key, starting note, second note direction, and rhyme scheme.

Current Status

The initial Android implementation is in progress under the DevCycle process documented in doc/planning/. The app is built with Kotlin, Jetpack Compose, Material 3, Navigation Compose, ViewModel state management, and Jetpack DataStore for persisted settings.

Build

Use the Gradle wrapper:

.\gradlew.bat testDebugUnitTest assembleDebug

Android SDK configuration is local to each machine through local.properties, which is intentionally ignored by Git.

Planning Docs

• doc/planning/DevelopmentProcess.md describes the DevCycle workflow.
• doc/planning/DevCycle001.md tracks the first implementation cycle.
• doc/planning/ideas/songscaffold_android_design_doc.md contains the product design.
• doc/planning/ideas/topics.md contains the topic prompt library.
• doc/planning/ideas/implementation_questions.md records implementation decisions.

Authorship

Created by Edward T. Tonai.

Coauthored with Codex.

License

This project is licensed under the MIT License. See LICENSE for details.