WORK-008
ID:WORK-008Status:pending

Build exercise Rune

Priority:mediumComplexity:unknownSource:SPEC-008
main View source

Relationships

Implements 1
Branches 3
main current pending
claude/file-naming-convention-LJdwR pendingchangeset-release/main pendingclaude/align-sidenav-styling-4MuxV pending
History 4
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. f262d7b
    Content editedby Claude
  3. ebe0c64
    Content editedby Claude
    Migrate plan files to {% ref %} xref syntax (WORK-021)
  4. d275b2a
    Created (pending)by Claude
    Add work items for 16 unbuilt runes from SPEC-008

Summary

Practice problem with a prompt, optional hints, and a revealable solution. Encourages active learning.

Attributes

NameTypeDefaultRequiredDescription
difficultyString'medium'Noeasy, medium, hard
pointsNumber—NoPoint value (for graded contexts)
typeString'open'Noopen (free response), code (expects code), multiple-choice

Content Model

  • First paragraph/section → the problem prompt
  • ## Hints or ## Hint heading → progressive hints (each child is one hint, revealed sequentially)
  • ## Solution heading → the solution (hidden by default, revealed on click)
  • Code fences in the solution section get syntax highlighting

Transform Output

  • typeof: Exercise
  • Tag: <article>
  • Properties: difficulty, points, type
  • Refs: prompt (div), hints (ol, each li is a hint), solution (div, initially hidden)

Implementation Tasks

  1. Create schema in runes/learning/src/tags/exercise.ts
  2. Add RuneConfig entry in runes/learning/src/config.ts
  3. Write CSS in packages/lumina/styles/runes/exercise.css
  4. Import CSS in packages/lumina/index.css
  5. Add hint revelation + solution toggle behaviors in packages/behaviors/
  6. Write tests in runes/learning/test/tags/exercise.test.ts
  7. Create inspector fixture

Dependencies

  • Hint revelation and solution toggle need JS — candidate for @refrakt-md/behaviors