PlaysbyMoat8
Back to the library
The workflow guideProduct & Engineering

Build a maths practice generator

Provide teachers and learners with a mobile interface for generating practice sets from a checked question bank.

5 implementation stepsAdvanced

How this works

Provide teachers and learners with a mobile interface for generating practice sets from a checked question bank. Use this to assemble practice sets from educator-checked material rather than generate unchecked exam questions on demand. A mobile interface should make topic and difficulty choices clear and preserve the answer key's relationship to each question.

Build a narrow prototype around a versioned question bank, selection rules and a deterministic set manifest. AI may classify or explain approved questions, but an educator validates new items and solutions before they enter the usable bank. This is practice support, not high-stakes grading.

Before you start

Checked question bank

Provide question IDs, topic, difficulty, wording, answer and worked solution.

Selection rules

Define allowed topics, set length and repetition constraints.

Prototype environment

Use an isolated local or staging app and available development tools.

Prepare the inputs

question_bank
Required

versioned structured items

Each usable question must have an educator-approved answer key.

practice_request
Required

topic, level, count and optional seed

Reject unsupported topics and excessive set sizes clearly.

presentation_rules
Required

notation, units and accessibility requirements

Preserve mathematical symbols across mobile layouts.

validation_cases
Required

known sets and boundary requests

Include empty topics, insufficient items and duplicate prevention.

Implementation, step by step

  1. Audit the bank

    • Check unique IDs, missing solutions and topic coverage.
    • Quarantine unreviewed or contradictory items rather than silently repairing their mathematics.

    Checkpoint: A usable-item manifest is available.

  2. Define set assembly

    • Filter by requested topic and level and sample without repetition according to the rules.
    • Record the bank version and selection seed when reproducibility is useful.

    Checkpoint: The same saved request can reproduce its set.

  3. Build the learner interface

    • Implement a small mobile-friendly form and readable question view.
    • Show unsupported requests and loading failures without losing the selected options.

    Checkpoint: The prototype covers normal and empty states.

  4. Attach checked feedback

    • Connect each question to its correct answer and worked solution.
    • If AI rephrases an explanation, compare it with the approved solution before release.

    Checkpoint: Question and answer IDs remain aligned.

  5. Validate the prototype

    • Run known requests and inspect small-screen notation, keyboard use and answer visibility.
    • Have an educator review sample sets before learner use; preserve test results and remaining gaps.

    Checkpoint: The prototype is ready for a bounded practice pilot.

Decisions along the way

Too few approved items

Offer a smaller set or broader topic rather than inventing unreviewed questions.

Question permits several valid answers

Encode the accepted forms and have an educator verify them.

Learner requests an exam score

Keep grading outside scope unless a separately validated rubric is supplied.

What you will produce

practice-set.json

JSON

A reproducible practice set with checked solutions.

Include: set_id · bank_version · request · question_ids · answer_key

prototype-review.md

Markdown

A review record for educators and developers.

Include: tested_flows · math_checks · device_checks · open_issues

Check the result

  • Verify every displayed question maps to the correct answer key.
  • Solve sampled items independently of generated explanations.
  • Test insufficient-bank and unsupported-topic requests.
  • Inspect notation and controls on representative mobile widths.

When something goes wrong

Formula rendering breaks

Use a readable fallback and hold affected items from learner use.

Bank update changes an answer

Version existing sets and require educator review of the changed item.

Build or test fails

Keep the bounded patch and error evidence; do not call the prototype ready.

A worked example

SYNTHETIC EXAMPLE · NOT A REPORTED BUSINESS RESULT

Request

Synthetic: create a short linear-equation practice set.

Inputs

Bank Q1: x+3=7, answer 4; Q2: 2x=10, answer 5; Q3 is unreviewed. Request asks for three approved questions.

Expected result

Synthetic result: report only two approved items available and offer a two-question set. The manifest contains Q1 and Q2 with answers 4 and 5; Q3 is excluded.

Run a small pilot

Start small

Use one topic and a small educator-reviewed bank with a few learners.

Record the baseline

Record manual set-preparation time and question or interface errors.

Agree success criteria

Agree mathematical correctness and usable-flow criteria before adding topics.

Stop or revise

Stop learner access to any item with an unresolved answer-key discrepancy.

Keep the scope clear

  • Do not treat generated explanations as educator validation.
  • Keep learner data minimal and prototype changes within the agreed feature scope.

Check before using

Have educators validate questions and solutions.

Business activities

  • Build and change software
  • Deliver courses and training

Editorially adapted workflow; not independently tested.

FROM A RECIPE TO YOUR WORKFLOW

Bring the company context together.

This workflow needs reliable inputs before it needs a better prompt. Moat8 Vault brings working information into a readable archive for the AI tools you use.

For this recipe: A checked question bank with worked solutions · Topic, difficulty, and exam-length requirements

Start with one recurring task, agree which sources to use, and review the first result with your team.

Discuss this workflow

What does your team do?

Choose the recurring work you would like to improve.

A field guide, made for work.

Plays is a curated library of anonymized business workflows. Each recipe explains the inputs, steps, tools, and checks you can adapt to your team. These are editorial guides, not independently tested implementations.

When you share a company website, the guide may read a limited number of public pages on that website. Messages and retrieved page text are sent to our AI provider, NVIDIA, to recommend relevant workflows. Share a general description rather than confidential information.

Saved workflows and selected activities stay in this browser. Your chat history and selected company website are kept in this tab and cleared when you reload or start a new chat. The server does not store conversations. Live source monitoring is not enabled.

If you allow analytics, PostHog receives page views and actions such as workflow saves, skill downloads and link clicks. Random browser and session identifiers connect these actions without identifying you by name. Your choice and browser identifier expire after 90 days; sessions restart after 30 minutes of inactivity or 24 hours. We use local storage, not analytics cookies. Messages, company URLs, search text, full referrers and IP addresses are not sent. There are no person profiles or session recordings. You can decline or withdraw in Analytics settings; Do Not Track and Global Privacy Control keep analytics off.

Read the Plays Privacy Notice ↗