ModusPractica Manual

⚠️ The issue: Many musicians practice the same pieces every day, wasting time on material they already know while neglecting sections that need attention. This inefficient approach slows progress and leads to frustration.

💡 Pro version advantage: Unlike the web app (limited to ~300 pieces due to browser localStorage), this desktop release provides unlimited storage for professionals with large repertoires.

⚠️ Important: After creating your profile, export your data using "Export Data". This creates a backup on your computer or cloud. Do this after each practice day. The file can be imported into another device or browser.

💡 Tip: Keep sections small! For complex passages 2–4–8 bars often work well; a chunk can even be half a bar. Smaller chunks make focused practice and faster progress easier.

Steps:

1. Click the "+ Create New Profile" button on the sign-in screen
2. Enter a profile name (required)
   • Pick a recognizable name like "John", "Maria" or "Student 1"
   • Names must be unique — you cannot have two profiles with the same name
3. Optionally select your experience level:
   • Beginner (0-2 years)
   • Intermediate (3-5 years)
   • Advanced (6+ years)
   • Professional
4. Click "Create Profile"

⚠️ Important: Immediately after creating your profile, make a backup with "Export Data". This is your safety net against data loss!

💡 When to change your experience level?

If you make clear progress and move up a level, update it in profile settings. The app preserves all practice history and stability data while adjusting planning heuristics for your new level.

Steps:

1. Select the profile to edit from the dropdown
2. Click the "✏️ Edit Profile" button
3. Change the name and/or experience level
4. Click "Save Changes" to confirm
5. Or click "Cancel" to discard changes

🔐 Data safety: Editing a profile preserves all pieces, sections, practice history and statistics. Only the name and experience level are changed.

⚠️ Note: Deleting a profile is permanent and cannot be undone. All data will be removed:

• All pieces and sections
• Complete practice history
• All statistics and progress charts
• Settings and preferences

Steps to delete a profile:

1. Select the profile you want to delete
2. Click the "🗑️ Delete Profile" button
3. Confirm in the warning dialog that you are sure
   • The system will show how many pieces will be lost
   • You must acknowledge that this is permanent
4. The profile and all associated data are removed immediately

🛡️ Safety tip: Always export a backup via "Export Data" before deleting a profile in case you change your mind later!

What is exported?

• All profiles — names, experience levels, creation dates
• All pieces — titles, composers, sections, colors
• Complete practice history — sessions, evaluations, timestamps
• Statistics and metrics — tau values, memory stability, practice stages
• Settings — intensity module config, preferences

Steps to export data:

1. Click the "📥 Export Data" button at the bottom of the profile screen
2. The app generates a JSON file containing all data
3. The file is saved to your Downloads folder with a name like: ModusPractica_Export_[date]_[time].json
4. Store this file safely:
   • USB stick (backup)
   • Cloud storage (Google Drive, Dropbox, OneDrive)
   • External hard drive

💡 Best practice: Export regularly — ideally after each practice session or at least once a week. This prevents data loss from browser issues or accidental cache clearing.

Steps to import data:

1. Click the "📤 Import Data" button
2. Select the exported JSON file from your computer
3. Choose an import strategy:

   Option 1: Merge

   Adds new profiles to existing data. If a profile name already exists it will be skipped. Recommended for combining data from multiple devices.

   Option 2: Replace

   Deletes ALL existing data and replaces it with the imported data. Use this to fully restore a backup.

4. Confirm your choice
5. The app loads the data and shows a confirmation

⚠️ Warning for Replace mode: Choosing "Replace" will permanently remove all current profiles and data before importing. Make sure to export your current data if you want to keep it!

Scenario 1: From desktop to laptop

1. Export data on computer A
2. Copy the JSON file to a USB stick or cloud storage
3. Download the file on computer B
4. Import with "Replace" to get the exact same data

Scenario 2: Combine students' data

1. Each student exports their profile
2. The teacher imports each file with "Merge"
3. All student profiles are now available on one device

⚠️ DANGER: The "🗑️ Clear All Data" button removes:

• All profiles (without exception)
• All pieces and sections
• All practice history and statistics
• All settings and preferences

This cannot be undone! Use only if you are absolutely sure. Export first if you may need the data later.

💡 Summary: Data management best practices

• Export regularly — at least once a week
• Store backups in multiple locations — USB + cloud
• Test your backups — try importing on a test device
• Label exports clearly — include dates in filenames
• Before deleting a profile — export it first
• On browser issues — import your latest backup

📝 Note for advanced users: The export JSON contains all data in a readable format. If you're technically skilled, you may edit it with a text editor before re-importing.

🎵 Why chunking is so powerful

• It reduces cognitive load: Smaller units are easier to understand and retain.
• It improves focus: You can isolate a specific technical or musical challenge.
• It speeds up progress: Mastery of small parts accumulates into mastery of the whole piece.
• It reduces frustration: Early success on manageable units keeps motivation high.
• It improves retention: Each chunk receives its own memory trace and review schedule.

💡 Practical guidelines

• Beginners: 1-4 bars per chunk, sometimes even half a bar for highly technical material.
• Intermediate players: 2-8 bars per chunk.
• Advanced players: 4-16 bars depending on complexity.
• Professionals: 8-32 bars when appropriate, while still isolating challenging material.

Rule of thumb: if you cannot play a section fluently three times in a row without mistakes after five minutes of work, it is probably too large and should be split further.

Step 1: Create the piece

1. Click "+ New Piece" in the Dashboard.
2. Fill in:
   • Title: "Für Elise"
   • Composer: "Ludwig van Beethoven"
   • Color: Choose, for example, blue.
3. Click "Save".

Step 2: Analyze the structure

Open the score and identify natural sections:

Note: this is a broad division. In practice you may want to split it further, especially for technically demanding passages in section B.

Step 3: Add chunks

Click the piece in the Dashboard to open the detail page, then:

1. Click "+ Add Section".
2. For the main theme:
   • Name: "Section A - Main Theme"
   • Bars: "1-23"
   • Description: "Characteristic E-Dm-E phrase" (optional)
   • Target Reps: Enter your desired target repetitions (for example 6). The field starts empty — there is no default value.
3. Click "Save Section".
4. Repeat for the other sections.

Step 4: Start your first session

1. In the Dashboard, the new section now appears in "Today's Agenda".
2. Click the section itself to start the practice session.
3. This opens the Practice Session interface where you can:
   • Use the timer while you practice
   • Track failed attempts and correct repetitions
   • Evaluate your performance at the end

🔧 Editing a section:

1. Go to the piece detail page.
2. Click the ✏️ icon next to the section.
3. Update the description or other details.
4. Click "Save".

Note: the section name cannot be changed because it acts as an identifier for the planner. Practice history remains intact.

➕ Splitting a chunk:

If a chunk turns out to be too large:

1. Add a new, smaller section, for example "Bars 1-4" instead of "Bars 1-8".
2. Optionally remove or archive the oversized section.
3. Start fresh with the new chunks.

🔗 Combining chunks:

If two adjacent chunks are both stable:

1. Add a new combined section, for example "Bars 1-8" to merge "1-4" and "5-8".
2. Archive the individual chunks if you no longer need them.
3. Practice the new combined section as one musical unit.

⚠️ Common chunking mistakes

• Chunks that are too large: "I will treat the whole first page as one chunk." Split it. Small successes build momentum.
• Adding too many chunks at once: "I will add all 47 chunks now." Start with two or three and expand gradually.
• Unclear chunk boundaries: "Bars 5-9... or was it 6-10?" Be precise and write the range clearly.
• Ignoring musical structure: Splitting in the middle of a phrase often works against the music.
• Overthinking the first division: You can always refine it later. Start, observe, and adjust.

✅ Full-piece maintenance:

1. Add the full piece as a new section, for example "Full piece - maintenance".
2. Set Target Repetitions to 1.
3. Play through the entire piece.
4. Evaluate it as "Excellent" if it went well. The planner will then assign the next maintenance date automatically.
5. You decide yourself whether to play it again on the same day. Extra same-day repetitions do not change the scheduled date.

Tip: extra repetitions on the same day do not affect planning. The next maintenance date changes only after the first session of the day.

How to merge chunks

1. Open a piece and go to the chunk list.
2. Click ⊕ Merge Mode.
3. Select at least two chunks with the checkboxes that appear.
4. Click Merge Selected.
5. In the modal, enter the new combined bar range, an optional description, and the target repetitions.
6. Click ⊕ Confirm Merge.

What happens after a merge?

• A new merged chunk is created as a fresh active chunk.
• The next review date is inherited conservatively: the app uses the earliest due date among the selected parents, never a date in the past.
• The original parent chunks are archived, not deleted, so their practice history remains intact.
• Stability data is transferred pessimistically, which prevents the new larger chunk from being treated as already overlearned.

⚠️ Important: Merging does not automatically verify musical adjacency or structural logic. You are responsible for entering a sensible new range and selecting chunks that truly belong together.

How to split a chunk

1. Open the piece detail view and find the chunk you want to refine.
2. Click ✂ Split on that chunk.
3. Enter two new child bar ranges and choose the target repetitions.
4. Click ✂️ Confirm Split.

What happens after a split?

• Two new child chunks are created and both start fresh with a 1-day interval and a new-practice state.
• The parent chunk is archived, not deleted, so historical data remains available.
• The child chunks inherit provenance and stability links from the parent, which preserves continuity in the data model.
• The parent description is copied to the children so you can refine it instead of rewriting everything from scratch.

⚠️ Important: The app validates bar-range formatting and prevents duplicate child ranges, but it does not decide the musical split for you. Choose two ranges that make structural and technical sense.

Scientific background

These tools reflect well-established practice principles. Cognitive load theory, associated with John Sweller, shows that smaller, clearly defined learning units reduce overload. Deliberate practice research, associated with K. Anders Ericsson, emphasizes isolating weak spots before reintegrating them into larger contexts. In practical music study, that means:

• Split when a passage contains too much information or too many technical demands at once.
• Merge when previously isolated chunks are strong enough to function as one coherent phrase or gesture.

🎯 The guiding principle

Cognitive load theory shows that the optimal chunk size is not fixed — it evolves as you learn. A passage that once needed to be broken into four bars may later be fluent enough to practice as eight. Equally, a chunk that seemed manageable at first can reveal hidden complexity after a few sessions. Smart Suggestions let the data drive those structural decisions rather than guesswork.

What triggers a Smart Merge suggestion?

• Both chunks show a consistently high Stability Index across multiple recent sessions.
• Their bar ranges are adjacent or overlapping, meaning they form a natural musical unit.
• Neither chunk has shown a significant regression (streak resets remain low).

💡 Musical tip: Accepting a Smart Merge suggestion is usually the right move when both chunks feel effortless in isolation but you still hesitate at the join. Practicing the larger phrase trains the motor continuity that makes a piece feel like music rather than a sequence of separate exercises.

What triggers a Smart Split suggestion?

• The chunk's Entry Cost remains persistently high across several consecutive sessions, meaning your brain is working very hard just to begin the movement.
• The chunk accumulates a high number of streak resets, indicating that while you can sometimes play it correctly, reliable recall has not been established.
• The chunk fails to advance through practice stages over multiple sessions despite regular attention in the schedule.

🎵 Musical tip: Accepting a Smart Split suggestion is an act of strategic patience, not defeat. When four bars feel impossible as a unit, two bars practiced correctly a hundred times builds the motor pattern that will make those four bars easy. The resulting micro-chunks will themselves suggest a merge once they are both stable — closing the loop automatically.

✅ You are always in control

Smart Suggestions are exactly that — suggestions. The app never restructures your repertoire without your explicit confirmation. If you dismiss a suggestion, the algorithm takes note and will not repeat it immediately. Accepting a suggestion triggers the same merge or split workflow as the manual tools described in section 4A, with the same data safeguards: parent chunks are archived, not deleted, and all practice history is preserved.

1. Open the Dashboard.
2. Find the chunk you want to practice in "Today's Agenda" or "All Pieces".
3. Click the chunk itself, not the edit icon.
4. The Practice Session interface opens automatically.

💡 What you see when the session opens

• Piece title and chunk information so you know exactly what you are working on.
• Memory Zone showing the learning phase: Exploration, Consolidation, Mastery, or Overlearning.
• Last practice date so you can see when the chunk was worked on last.
• Timer for tracking practice time.
• Tracking Metrics for correct repetitions, failed attempts, and streak resets.
• Energy level to log your physical and mental state.
• Notes field for observations and reminders.

Purpose: Tracks how much time you spend on this chunk.

These are the core metrics used by the Ebbinghaus-based algorithm to calculate your next practice date:

Purpose: The number of error-free repetitions you want to reach in this session.

Purpose: Determines how aggressively the overlearning algorithm reacts to mistakes.

Example: With 10 mistakes before the first correct repetition, and a chunk baseline T₀ = 8, 100% yields Target = MAX(8,10) = 10, while 50% yields Target = 8 + floor((10 − 8)/2) = 9.

Purpose: Records your physical and mental state during the session.

Use: This data is stored for later analysis. It can help you find patterns, for example whether you perform better in the morning or after a coffee break.

Purpose: Tracks tempo progress for chunks where tempo is an important learning goal.

Purpose: Document observations, discoveries, and recurring problems during the session.

Auto-load: Notes from your previous session are loaded automatically, so you can review and continue your earlier observations.

This opens the Evaluation Modal, the final important part of the session workflow.

This is the most important input for the Ebbinghaus-based algorithm. Your evaluation directly affects the next review interval:

If you have completed at least 2 sessions for this chunk, the evaluation modal automatically shows a Success Ratio Trend Chart.

Use: This visualization helps you assess consistency and identify trends, for example whether your success rate is dropping because you are moving through chunks too quickly.

After selecting a performance rating, click "Save Evaluation".

What happens next:

1. The session is stored in the piece's practiceSessions array.
2. An entry is added to practiceHistory for statistics.
3. The chunk properties are updated:
   • lastPracticeDate → today
   • completedRepetitions → plus the correct repetitions from this session
   • targetTempo and achievedTempo are updated
4. The Ebbinghaus-based algorithm calculates the next review interval:
   • Stage 0-2: fixed 1-day intervals for the foundation phase
   • Stage 3+: the Ebbinghaus formula, t = -τ × ln(R*), with performance adjustment
5. nextReviewDate is set.
6. If you reached targetRepetitions, practiceScheduleStage increases by 1.
7. Adaptive systems are updated:
   • Personalized Memory Calibration (PMC) learns your individual retention behavior
   • Memory Stability Manager tracks stability (S) and difficulty (D)
   • Adaptive Tau Manager computes optimized τ values
8. The draft is cleared and auto-saved temporary data is removed.
9. You are taken back to the Dashboard.

⚠️ What if the chunk is too difficult?

Sometimes you can work on a chunk for 10 or more minutes without reaching a single successful repetition. That is normal for very challenging passages.

The system recognizes this automatically:

• If you practiced for 2+ minutes but reached 0 correct repetitions
• The evaluation modal shows a warning: "Passage too difficult?"
• The session is marked as sessionOutcome: 'Incomplete'

Consequences:

• Fixed 1-day interval: you get another chance tomorrow.
• No stage penalty: your practice stage stays the same.
• Data is preserved: your time and effort are still recorded.
• No target increment: the target stays at your configured value for that chunk.

Advice: Consider splitting the chunk into smaller sub-chunks or working at a slower tempo first. Sometimes the best move is to stop and come back with a fresh mind.

If you want to cancel the session without saving it, click "Cancel Session".

What happens:

• If you entered any data, such as time, attempts, or notes, you receive a warning.
• After confirmation, all session data is removed.
• The draft is cleared.
• You return to the Dashboard.
• Nothing is saved and the chunk remains unchanged.

⚠️ Note: Canceling cannot be undone. If you cancel by mistake, you have to start the session again.

💾 Automatic saving

ModusPractica automatically saves your session as a draft every 30 seconds while you are practicing.

What is stored in the draft:

• Timer status (totalElapsedSeconds, isRunning, pausedTime)
• Tracking metrics (failedAttempts, correctRepetitions, streakResets)
• Dr. Gebrian state (errorsBeforeFirstCorrect, hasAchievedFirstCorrect, targetRepetitions)
• Energy-level selection
• Session notes
• Tempo values (target and achieved)
• Timestamp of the last save

Recovery scenarios:

• Browser crash: reopening the session loads the draft automatically.
• Accidentally closing the window: the draft is restored when you reopen the same chunk.
• Power outage: if the draft was saved within the last 30 seconds, the data is preserved.

💡 Tip: You will see a "💾 Unsaved Changes" indicator in the lower-right corner when there is unsaved data. It disappears as soon as auto-save runs.

The Intensity Module is an advanced system that gives real-time feedback about practice intensity and quality.

Use: These metrics are intended for advanced users who want to optimize their practice process. For beginners they are optional.

✅ Recommended approach:

• Start the timer as soon as you begin because accurate time tracking matters for statistics.
• Record every attempt honestly because quality matters more than quantity.
• Use failed attempts conservatively and only for true failures before the first success.
• Take micro-breaks seriously because short pauses after 3 correct repetitions support consolidation.
• Be honest in evaluation because the system is only as good as the input you provide.
• Document observations because future-you will benefit from clear notes.
• Track tempo progress because even small improvements can be highly motivating.
• Split chunks that are too difficult because if you still have 0 correct repetitions after 10+ minutes, the chunk is probably too large.

⚠️ Common mistakes:

• Rating too optimistically: "It went fairly well" → Excellent → interval too long → memory failure next session.
• Changing the target manually without a reason: this disables the Gebrian logic, so let the system do its job unless you have a clear reason.
• Keeping failed attempts running after first success: use Reset ↻ when the streak breaks, not failed attempts.
• Forgetting to start the timer: retroactive entry is possible but less accurate.
• Ignoring notes: documented insights are extremely valuable in later sessions.
• Racing through chunks: quality is better than quantity. Three chunks done excellently are better than ten mediocre ones.

🧠 The core idea: why adaptive learning?

ModusPractica's strength lies in its use of spaced repetition based on the Ebbinghaus forgetting curve. Instead of reviewing randomly or practicing everything every day, the system schedules repetitions at the optimal moment, just before you are likely to forget. This maximizes retention while minimizing wasted practice time.

The mathematical formula

Where:

• R(t) = retention, the probability of successful recall after time t
• t = time since the last review, in days
• τ (tau) = memory half-life, the time at which retention drops to about 37% (e^-1)
• e = Euler's number, about 2.718

The optimal review moment

ModusPractica calculates your next practice date using the inverse Ebbinghaus formula. The full formula includes the asymptotic baseline:

Where:

• t = optimal interval until the next review, in days
• τ = your personal tau parameter, described below
• R* = desired retention threshold
• L₀ = initial learning strength = 0.80, meaning 80% immediately after learning
• B = asymptotic retention baseline = 0.15, meaning 15% always remains
• ln = natural logarithm

Base tau calculation

ModusPractica starts from a science-based baseline and adjusts it using several factors:

1️⃣ Personalized Memory Calibration (PMC)

What it does: Learns your individual memory patterns by comparing predictions with actual performance.

2️⃣ Memory Stability Manager (MSM)

What it does: Tracks memory stability and difficulty for each section using ideas derived from SuperMemo SM-17+ style algorithms.

3️⃣ Adaptive Tau Manager (ATM)

What it does: Coordinates PMC and MSM data to compute a single integrated and reliable tau value.

💡 When should you change difficulty?

• Difficult → Average: when you consistently rate sessions as "Good" and have minimal streak resets
• Average → Easy: when you achieve "Excellent" in 3 or more sessions in a row
• Easy → Mastered: only in stage 5 or later, when the material is automatic and essentially error-free
• Mastered → Average: if quality starts to degrade after long intervals

ℹ️ Planner: During per-session scheduling, the system uses performance-derived retention targets (R*). The difficulty-based R* values above are policy values that provide the general framework.

How stage progression works

You advance to the next stage only when you reach your Target Repetitions in a session. Stage progression does not happen automatically unless you hit the target.

💡 Pro tips for stage management:

• Be patient in Stage 0-2: daily repetitions are an investment. Do not jump to stage 3 without a solid foundation.
• Expect regression in Stage 3-4: longer intervals test retention. Occasional "Fair" or "Good" ratings are normal, and the system learns from them.
• Do not lower target reps manually: if you have reached stage 5 or higher, you have already proven that 6 or more repetitions are achievable. Keep that standard for strong consolidation.
• "Mastered" difficulty is not for everyone: use it only for chunks you truly perform effortlessly and without errors in stage 5 or above.
• Reset the stage after major edits: if you drastically change a chunk, such as raising the tempo by 40+ BPM or adding ornamentation, consider starting again at stage 0 under a new chunk name.

⚠️ Common misconceptions:

• Myth: "A higher stage is always better"
  Reality: Stage is only an indicator of consolidation progress. A stage 3 chunk you perform excellently is more valuable than a stage 8 chunk that is degrading.
• Myth: "I need to practice every chunk every day"
  Reality: ModusPractica is designed to avoid that. Trust the scheduling. Chunks in stage 8 may only need review once a month.
• Myth: "If the interval is long, I will definitely forget it"
  Reality: The system adapts. If you do forget, for example with a Poor or Fair evaluation, the interval gets shorter again. Desirable difficulty supports learning.
• Myth: "The adaptive systems are too complex, so I should set everything manually"
  Reality: The adaptive systems need 10 or more sessions to converge. Give them time. Manual override requires unusually deep knowledge of spaced-repetition algorithms.

The adaptive loop

1. You add a new chunk → Stage 0, τ = baseline of about 9 to 11 days
2. You practice in Stage 0-2 → Daily repetitions while the system observes your performance
3. Stage 3 is reached → Ebbinghaus scheduling activates, with an initial interval of about 2 to 3 days
4. You practice the chunk again after 3 days → Evaluation: "Good"
   • PMC: "Performance was as expected" → τ remains stable
   • MSM: Stability grows by 1.3× → S = 2.3d
   • ATM: Integrates the data → τ = 11.5d
   • Next interval: about 3.5 days with R* = 0.80
5. You practice after 4 days, slightly later → Evaluation: "Excellent"
   • PMC: "Better than expected" → increase τ by 5%
   • MSM: Stability grows by 1.3× → S = 3.0d
   • ATM: τ = 12.5d
   • Next interval: about 5 days with the Excellent bonus of ×1.8
6. You practice after 5 days → Evaluation: "Fair" + 2 streak resets
   • PMC: "Worse than expected" → decrease τ by 3%
   • MSM: Stability drops because of the broken streaks → S = 2.6d, difficulty rises
   • ATM: τ = 11.0d
   • Next interval: about 2.5 days because of the Fair penalty
7. The cycle repeats... → τ gradually converges toward your real retention pattern

🎓 Ready for the next step?

Now that you understand how the adaptive system works, you can enter practice data with confidence. The system learns from every session and automatically optimizes itself for your unique memory profile.

→ Continue to Section 7: Intensity Module (advanced)

Important: The Intensity Module does not affect scheduling, meaning τ or the review interval. It gives duration and repetition recommendations based on your Success Ratio and Overlearning Quotum (OLQ). You can enable or disable the module in settings.

• Initial Acquisition (0–40%): many errors and a steep learning curve
• Refinement (40–70%): fewer errors and increasingly stable technique
• Consolidation (70–85%): few errors and the start of automation
• Mastery (85–95%): very few errors and high consistency
• Overlearning (95–100%): error-free and performance-ready

UI: In the session screen, a line labeled “Estimated Duration” appears below the OLQ target. When enough historical data is available, the app uses your learned average time per correct repetition, based on a robust estimate with outlier filtering and trimming. Otherwise it falls back to the phase defaults above. The UI also shows a simple range (±20%) and a confidence level of low, medium, or high, based on how many sessions were available for calibration.

Module on/off: When the module is off, the app uses a fixed duration, 15 minutes by default, and no OLQ instructions are shown. When the module is on, you receive a dynamic instruction with the phase, target, and estimated time.

✅ Retention Check — 3 reps

When this green badge appears at the top of the session screen, it means the app has detected Mastery from your previous session (an Excellent rating combined with a low Entry Cost and a high Stability Index). Instead of running a full Overlearning sequence again, the system offers a lean 24-hour verification: reach 3 consecutive correct repetitions to confirm the memory trace is still fully intact.

A successful 3-rep Retention Check counts as a full session and advances the interval normally. It is designed to protect your practice time: if you can demonstrate retrieval cleanly in three reps, there is no cognitive benefit to doing eight more.

When does the Retention Check appear?

• The previous session was rated Excellent.
• The Entry Cost in that session was at or below your personal baseline (very few failed attempts before the first correct rep).
• The chunk's Stability Index has risen above the Mastery threshold, indicating a well-consolidated memory trace.
• The review falls within a 24-hour window of the scheduled date.

💡 Want more depth? Use the + button

The Retention Check is a suggestion, not a lock. If you want to do deeper overlearning regardless of the badge, tap the + button next to the target repetitions counter to manually raise the target. The app will then run the full Overlearning sequence at your chosen level. Your additional repetitions are logged and contribute positively to the Stability Index.

Archiving unworkable chunks

If a session produces CR = 0, meaning no correct repetitions at all, the module marks the section as unworkable for that session and recommends archiving it. This prevents distorted statistics and keeps your focus on material that is currently workable.

⚠️ When does it trigger?

The guard activates when it detects a combination of:

• A high number of streak resets in the current session — indicating repeated retrieval failures, not just initial learning errors.
• Significant time already spent on the chunk — meaning the brain has been working hard without stabilising the pattern.

💬 What does the app do?

The app proactively opens a coaching dialogue and offers to lower the Target Repetitions for this session. Reducing the target does two things:

• It makes a successful completion reachable again, which protects the user's motivation and prevents the session from ending on a failure state.
• It signals to the algorithm that the chunk needs closer attention: the schedule tightens automatically so the chunk reappears sooner.

You can accept the suggestion or dismiss it and continue at the original target — the choice is always yours.

📚 Science note: Research on self-efficacy in motor learning (Bandura, 1997) consistently shows that repeated failure without success experiences erodes intrinsic motivation more than it builds resilience. The Frustration Guard is designed to honour the real physiology of learning: a saturated brain needs relief, not more repetitions.

⏰ The 12-minute threshold

When a single chunk session exceeds 12 minutes of active practice time, ModusPractica warns you that you may have entered a state of mindless repetition: motor execution that feels productive but is no longer generating new memory consolidation. Beyond this threshold, the law of diminishing returns sets in sharply.

The warning message explicitly suggests switching to Interleaved Practice: moving to a different piece or chunk introduces contextual interference, which forces genuine retrieval on each return and produces significantly stronger long-term retention than blocked same-chunk repetition.

🔀 Why switch to Interleaved Practice?

• Contextual interference (Shea & Morgan, 1979): practicing different material between repetitions of the same chunk forces the brain to reconstruct the motor programme from scratch each time, rather than riding on a temporary "warm" neural trace.
• Spacing effect: even a 5-minute gap on a different chunk before returning acts as a micro-spacing event, measurably improving next-day retention.
• Attention reset: a brief cognitive switch eliminates the automaticity that creeps into blocked repetition, restoring the sharp attentional focus needed for deliberate practice.

You can dismiss the warning and continue with the current chunk if you have a specific reason (for example, preparing an excerpt for an imminent performance). The app will log the extended duration and use it to refine the Entry Cost estimate for future sessions.

💡 Summary: how the two mechanisms work together

Tip: The daily agenda is based on your individual schedule, meaning Ebbinghaus plus τ. Practice the red/orange items first, meaning overdue or due today, and then move on to the green/gray items that are coming soon or are optional.

Why this matters: Effective practice is not just about what you play, but when and in what order you play it. By surfacing the most vulnerable memories first, the app maximizes retention per unit of practice time and ensures no part of your repertoire quietly decays in the background.

How personalized predictions work

• After each session the app records the Entry Cost (failed attempts before the first correct rep) and the total session duration for that chunk.
• Over multiple sessions it builds a rolling average of your time per correct repetition for each specific chunk, weighted toward your most recent data.
• The agenda time estimate for tomorrow's session is then calculated from: your learned T̅_CR × the expected OLQ target for the predicted phase.
• Because Entry Cost varies chunk by chunk, a technically demanding passage may show a 12-minute estimate while a well-consolidated one shows only 3 minutes — and both numbers will be far more accurate than any generic rule.

✅ Result: As your practice data grows, the daily schedule becomes a highly accurate forecast of how long your practice will take. You can plan your day around the agenda with genuine confidence rather than guessing.

Charts use your recorded sessions, including CR, FA, duration, and tempo, from practice history. Incomplete or very short sessions may be filtered out to avoid distortion.

Practical advice: Use charts for quality control, such as whether errors are dropping and stability is rising, and use statistics for time control, such as where your practice time is going. That lets you adjust your work in an evidence-based way.

Outcome: you do not get a random list of chunks, but a carefully balanced circuit that squeezes the maximum learning value out of the exact amount of time you have available.

Mindset: treat a "tough" Lab circuit not as punishment but as the shortest route to mastery. Every difficult switch, every unexpected contrast, and every deliberate pause is a sign that your brain is reorganising your skills at a higher level.

When should you use it? For warm-ups, experiments, technique blocks outside the main schedule, or whenever you want to track something without scheduling it.

Looking ahead: support for multiple media references per piece or section, including audio, score files, and external links, is on the roadmap.

?? LocalStorage vs. IndexedDB at a glance

?? Data is local and browser-bound

Despite the improved technology, your data remains stored locally on this device, and is specifically tied to the browser you use to open ModusPractica. This means:

• You cannot simply switch to a different browser on the same device and see the same data
• If you use ModusPractica on another computer, you need an exported file to bring your progress with you
• Your data does not automatically end up in a cloud or on an external server

?? When can data be lost?

• Clearing browser history including “site data” or “cookies and cached files” — this can delete the entire IndexedDB database
• Formatting the device or installing a new browser without exporting data first
• Browser setting “clear on close” — if your browser is configured to automatically remove data when it closes
• Private or incognito mode — data stored in private mode is deleted as soon as you close the window

??? The golden rule: export regularly

The Export Data (JSON) function — found on the profile screen — is your only 100% safe way to preserve your progress. An export file is a plain text file you can save to:

• A USB stick
• Cloud storage (Google Drive, Dropbox, OneDrive)
• An external hard drive

Our advice: make it a habit to export after every major practice session. It takes just a few seconds and gives you complete peace of mind — even with browser updates, device changes, or an unexpected browser clean-up.

?? In summary: With IndexedDB, your data is technically safer and more scalable than ever. But just like a professional recording of your rehearsals: you are your own best safeguard. Export regularly, store your backups in multiple places, and your years of practice history will be fully protected.

The founder of spaced repetition

Hermann Ebbinghaus discovered that memory retention decays exponentially over time. His work showed that strategically timed reviews dramatically extend retention intervals while maintaining high recall rates. The Ebbinghaus forgetting curve is central to ModusPractica's algorithm:

where R(t) is the retention probability after time t, and τ (tau) is the memory decay constant.

🎵 Core research for the Intensity Module

Dr. Molly Gebrian, author of "Learn Faster, Perform Better: A Musician's Guide to the Neuroscience of Practicing" (2024), is a leading researcher in music pedagogy and neuroscience. Her research shows that targeted overlearning (practicing beyond initial mastery) is essential for reliable performance under stress. This work informs the Overlearning Quota (OLQ) system in ModusPractica.

Key findings:

• Minimum threshold: At least 6 correct repetitions are necessary to consolidate motor memory
• Phase-specific targets: Required repetitions increase across learning phases:
  • Initial Acquisition: 6–8 correct repetitions
  • Refinement: 7–10 repetitions
  • Consolidation: 8–12 repetitions
  • Mastery: 9–14 repetitions
  • Overlearning: 10–18 repetitions
• Performance under stress: Extra repetitions beyond first success significantly increase reliability for performances or exams
• Error correction principle: Extra repetitions should scale with initial errors — more early errors require more overlearning

Implementation in ModusPractica:

The OLQ system combines Gebrian's phase baselines with a dynamic adjustment based on technical difficulty:

Example: In the Consolidation phase (FixedGoal = 8) with 4 initial errors, the target becomes: 8 + ceil(4 × 0.5) = 10 correct repetitions.

Key insight: Making errors during initial learning — when corrected — leads to better long-term retention than error-free learning. This research directly inspired ModusPractica's distinction between:

• Failed Attempts (FA): Execution errors that are informative but do not change scheduling
• Streak Resets (SR): Memory retrieval failures that do trigger scheduling adjustments

Motor learning theory: Schmidt & Lee identify three phases of motor learning:

• Acquisition: High error rates are normal during motor exploration
• Refinement: Errors decline as movement patterns stabilize
• Retention: Errors reflect memory decay more than motor exploration

The three stages of motor learning: Fitts & Posner's model identifies three stages used by ModusPractica for the TDS (Technical Difficulty Score):

1. Cognitive stage: Focus on understanding (matches Initial Acquisition)
2. Associative stage: Technique refinement (Refinement & Consolidation)
3. Autonomous stage: Automatic execution (Mastery & Overlearning)

Advanced memory tracking: ModusPractica's Memory Stability Manager implements concepts from SuperMemo's SM-17 algorithm, introducing memory stability (S) — a quantitative measure of how well a memory is consolidated.

The S value represents the expected interval (in days) until retention probability drops to a critical threshold (typically ~90%).

1. Ebbinghaus, H. (1885/1913). Memory: A contribution to experimental psychology. Teachers College, Columbia University.
2. Gebrian, M. (2024). Learn Faster, Perform Better: A Musician's Guide to the Neuroscience of Practicing. Oxford University Press.
3. Kornell, N., & Bjork, R. A. (2008). Learning concepts and categories: Is spacing the "enemy of induction"? Psychological Science, 19(6), 585-592.
4. Schmidt, R. A., & Lee, T. D. (2011). Motor control and learning: A behavioral emphasis (5th ed.). Human Kinetics.
5. Fitts, P. M., & Posner, M. I. (1967). Human performance. Brooks/Cole.
6. Wozniak, P. A., & Gorzelanczyk, E. J. (1994). Optimization of repetition spacing in the practice of learning. Acta Neurobiologiae Experimentalis, 54, 59-62.
7. Cepeda, N. J., Pashler, H., Vul, E., Wixted, J. T., & Rohrer, D. (2006). Distributed practice in verbal recall tasks: A review and quantitative synthesis. Psychological Bulletin, 132(3), 354-380.
8. Walker, M. P., Brakefield, T., Morgan, A., Hobson, J. A., & Stickgold, R. (2002). Practice with sleep makes perfect: Sleep-dependent motor skill learning. Neuron, 35(1), 205-211.
9. Roediger, H. L., & Karpicke, J. D. (2006). Test-enhanced learning: Taking memory tests improves long-term retention. Psychological Science, 17(3), 249-255.
10. Settles, B., & Meeder, B. (2016). A trainable spaced repetition model for language learning. Proceedings of the 54th Annual Meeting of the Association for Computational Linguistics, 1848-1858.

📄 For full scientific details: See the full paper "Adaptive Spaced Repetition for Motor Skill Acquisition in Music Practice" that documents the theoretical basis, algorithms and validation.