Skip to content

feat: Add gamified learning module for critical analysis of documentation#9

Merged
Keramikus-97 merged 1 commit into
mainfrom
devin/1780825824-gamified-learning
Jun 7, 2026
Merged

feat: Add gamified learning module for critical analysis of documentation#9
Keramikus-97 merged 1 commit into
mainfrom
devin/1780825824-gamified-learning

Conversation

@Keramikus-97

Copy link
Copy Markdown
Owner

Summary

Adds a new gamified_learning module that enables gamified critical analysis of technical documentation — identifying hidden assumptions, scoring analysis quality, and tracking learner progress with XP/levels/badges.

Inspired by a German-language critical analysis exercise ("Gamifiziertes Lernen") that decomposes documentation into underlying assumptions with structured evidence evaluation.

Key components:

# Core data model
Assumption(statement, category, evidence, impact_on_argument, confidence)
LearnerProfile(user_id, xp, level, challenges_completed, streak, badges)
LearningChallenge(challenge_id, title, source_text, difficulty, xp_reward)

# Main API surface
identify_assumption_indicators(text) -> list[str]  # detect assumption signals
score_analysis(assumptions, source_text) -> AnalysisResult  # score with breakdown
create_challenge(id, title, text, ...) -> LearningChallenge  # gamified wrapper
complete_challenge(profile, challenge, result) -> (profile, events)  # award XP/badges
format_analysis_markdown(result, locale="de"|"en") -> str  # output as markdown table
  • estimate_difficulty() uses word count, sentence complexity, and technical vocabulary density heuristics
  • Scoring weights differ by AssumptionCategory (CAUSAL=25, IMPLICIT_COMPARISON=20, etc.)
  • Supports de and en locales for markdown output (matching the original German format)
  • 53 new tests, overall coverage 99% (115 tests total)

Link to Devin session: https://app.devin.ai/sessions/e783b2864bf3411f8832faec6c5f93bf
Requested by: @Keramikus-97

…tion

- Add gamified_learning.py with assumption detection, scoring, and XP system
- Support for German and English locales in output formatting
- Learner profiles with levels, XP, badges, and streaks
- Difficulty estimation heuristics based on text complexity
- Comprehensive test suite (53 tests, 98% coverage)
- Updated __init__.py to export new public API

@Keramikus-97 Keramikus-97 left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 1 potential issue.

View 4 additional findings in Devin Review.

Open in Devin Review

Comment thread src/opencode_github/__init__.py
@github-actions

github-actions Bot commented Jun 7, 2026

Copy link
Copy Markdown

opencode session  |  github run

@Keramikus-97 Keramikus-97 merged commit bf8c4e6 into main Jun 7, 2026
1 of 2 checks passed

@Keramikus-97 Keramikus-97 left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Details

@Keramikus-97 Keramikus-97 left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Details

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.

1 participant