Skip to content

Gentle-ramp the first exercises of each topic #17

@abhiksark

Description

@abhiksark

Part of the 0.3.0 adoption roadmap — Curriculum (beginner ramp).

Why (adoption impact)

Beginners bounce if the early exercises are too steep. The first 1–3 exercises of each topic should be confidence-builders. This issue audits and gently smooths those on-ramps.

Current state

  • 292 exercises across 31 topics (exercises/, ordered via info.toml).
  • A gap-audit methodology is already specced in docs/superpowers/specs/2026-06-02-gap-audit-design.md — its difficulty-curve checks are the tool for this issue.

Scope / acceptance criteria

  • For each topic, review the first 1–3 exercises for "gentle start": single new concept, minimal prerequisites, short.
  • Flag any topic whose opener jumps in difficulty (multiple new concepts at once, long, depends on un-taught material).
  • Propose concrete fixes (reorder, simplify, or insert a gentler intro exercise) in a checklist here before editing.
  • Apply approved fixes keeping exercises/ + checks/ + solutions/ + info.toml in sync, every reference solution passing (tests/integration/test_solution_verify.py).

Where to look

  • exercises/<topic>/, info.toml, checks/, solutions/_answers.py.
  • docs/superpowers/specs/2026-06-02-gap-audit-design.md (difficulty-signal heuristics).

Out of scope

  • Full coverage-gap analysis (that's the separate gap-audit effort); this issue is only the early-ramp of existing topics.

Verify

  • python -m pytest -q stays green; manually skim the first exercises of a few topics for gentleness.

Difficulty

help wanted · documentation — curriculum judgment; coordinate proposed changes before editing 31 topics.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or requesthelp wantedExtra attention is needed

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions