The Art of the Prompt 🎨

We built Argraide to be magic. You type a description, and a fully interactive, graded activity appears. But like any magic, the spell matters.

While typing "Fractions" will get you a decent activity, describing a scenario with cause-and-effect gameplay gets you an unforgettable learning experience.

Here is the secret to writing prompts that turn a standard lesson into a core memory for your students.

The Structured Prompt Formula

The best Argraide prompts follow a clear structure. Think of it as a recipe:

[Grade & Subject] + [Concept] + [Visuals] + [If/Then Gameplay Loop] + [Logic]

Let's break each piece down.

1. Start with the Grade & Subject

Tell the AI exactly who this is for and what curriculum strand it covers. This anchors the difficulty, vocabulary, and learning objectives.

• Vague: "Fractions game"
• Sharp: "Grade 4 Math — Fractions"

2. Describe the Concept (The Scenario)

Don't just ask for a subject — ask for a situation. Students learn best when they have a job to do. Give the AI a world to build.

• Vague: "Create a game about fractions."
• Sharp: "Run a bakery where customers order specific fractions of cakes and pies. Students must slice baked goods into the right number of pieces and serve the correct fraction."

3. Paint the Visuals

Help the AI understand what the activity should look and feel like. You don't need to be an artist — just describe the vibe.

• Example: "Cozy bakery counter with cakes, pies, and a queue of cartoon customers. Warm colors, flour dust particles."

4. Define the If/Then Gameplay Loop (The Core)

This is where Argraide shines. The best activities are built on cause and effect — the learning IS the game mechanic. Describe what happens when students get it right AND what happens when they get it wrong.

• Example:
  • Customer orders "3/4 of a chocolate cake" → student drags a knife to divide the cake, then selects slices to plate.
  • IF they serve the right fraction → customer is happy, tips well, reputation goes up.
  • IF they serve too much → bakery loses money. IF too little → customer complains, reputation drops.
  • As reputation grows, orders get harder (mixed numbers, equivalent fractions).
  • IF reputation hits zero → bakery closes (game over). Reach 5-star reputation to win.

Notice how the student can't just guess — they have to understand fractions to succeed. That's the magic.

5. Explain the Logic (Assessment)

Finally, tell the AI what to track and how difficulty should scale. This ensures the activity is actually measuring learning, not just engagement.

• Example: "Track accuracy per order, money earned vs spent, and reputation score. Difficulty scales with reputation. Students must understand what fractions MEAN to serve correctly — no multiple choice."

Putting It All Together

Here is a complete prompt you can try right now:

Grade 6 Science — Ecosystems & Food Webs

Build and maintain a balanced ecosystem by introducing species and managing their populations. Top-down nature scene with animals as colorful sprites and population counters. Day/night cycle advances the simulation.

Start with an empty habitat. Add producers (grass, algae), then herbivores (rabbits, deer), then predators (wolves, hawks). Press "Simulate" to watch population dynamics play out over seasons.

IF too many predators → prey dies out → predators starve → ecosystem collapses. IF no predators → herbivores overpopulate → eat all plants → mass starvation. IF balanced → all species survive through the year → level complete!

3 biome levels. Track species survival rates and balance metrics. Collapse = restart with what you learned.

More Examples to Try

Here are a few starter prompts built with this exact formula:

🔬 Circuit Lab (Grade 6 Science)

Wire up circuits to power devices in a house. Drag components (batteries, wires, switches, bulbs) onto a workbench. IF circuit is complete → devices turn on! IF short circuit → fuse blows. IF bulbs are in series → removing one kills them all. Students learn by SEEING what works.

💰 Market Trader (Grade 5 Math)

Run a market stall buying wholesale goods and setting retail prices. IF price is too high → few customers buy, stock spoils. IF too low → sells out but you barely break even. IF you find the sweet spot → healthy profit, expand inventory. Students calculate margins to survive.

🌍 Planet Terraformer (Grade 5 Science)

Terraform a barren planet to support human life. Adjust atmospheric gases and temperature with sliders. IF oxygen too low → colonists can't breathe. IF CO2 too high → greenhouse effect, planet overheats. Find the Goldilocks balance.

The Golden Rule

Learning IS the game mechanic. If a student can win your activity without understanding the concept, the prompt needs work. The best prompts make it impossible to succeed without thinking.

You don't have to get it perfect on the first try. Just click Remix and refine: "Make the orders start easier" or "Add a tutorial round." The AI remembers the full context and adjusts.