Markdown Converter
Agent skill for markdown-converter
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Chord-Tron is a specialized music theory application built with Nuxt 4 that provides a systematic approach to diatonic chord construction and guitar chord-melody study. It uses a unique "note//skip note" construction methodology rather than traditional chord theory.
The application constructs chords by taking every other note from a given scale starting at any degree, then derives various harmonic objects (shells, triads, dyads) as subsets of these base chords. This creates an "elevator study system" with progressive complexity levels (0-8) for chord-melody practice.
# Start development server npm run dev # Build for production npm run build # Preview production build npm run preview # Generate static files npm run generate
This is a Nuxt 4 project with the new directory structure:
app/ - All application code (components, pages, composables, etc.)docs/ - Comprehensive technical documentationpublic/ - Static assetsnuxt.config.ts - Nuxt configurationAPI-First Design: All chord theory, scale processing, and voicing generation logic should be implemented in server API endpoints (
/api/ routes). The frontend handles only UI, visualization, and user interaction.
Planned API Structure:
/api/chords/generate - Scale-based chord generation/api/voicings/elevator - Elevator study system levels/api/analysis/identify - Note identification and analysisProgressive complexity levels:
Shell chords are NOT traditional 1-3-7 voicings but specific subsets of the base chord at positions [1,3,4] or [1,2,4].
All music theory data structures should be fully typed:
ScaleContext - Scale notes and construction parametersDiatonicChord - Base chord with derived objectsHarmonicObject - Notes with structural positions and inversionsWhen creating new files:
/server/api/ for music theory logic/app/components/ for UI elements/app/composables/ for reusable logic/app/pages/ for route definitions/app/utils/ for helper functions