Skip to main content

Tips for creating Luna configurations (Balanced Assessment by Formative)

Best practices for using Luna Configuration Studio

Neta Raz Studnitski avatar
Written by Neta Raz Studnitski
Updated this week

To create a Luna configuration that meets your district goals, give Luna clear guidance on what to create, what to avoid, and what “good” looks like.

On this page, learn how to:

  • Create a new configuration

  • Write great configuration instructions

  • Upload files to give Luna more context

  • Test and refine


Create a new configuration

  1. Open Luna Configuration Studio.

  2. Click Create New Configuration

  3. Add a Title, Description, and Instructions. Use the tips below to write great Luna instructions.

    1. You can preview your configuration before publishing by saving any time as a hidden configuration and then clicking preview.

  4. When your configuration is tested and working as you like. Update the configuration to Public and click Save.


Write great Luna Configuration instructions

Good instructions provide details about your configurations goals and behaviors. There are 5 main areas to consider when writing instructions. You don’t need to use all five, but it will help to include a few.

  • Role & Objective - Tell Luna what role to play and define the purpose of this configuration.

    • Example: “Increase rigor while preserving standard alignment and the original intent.”

  • Getting Started - Clarifies whether the user of the configuration should start with standards, their own resource, a district resource, etc.

    • Example: “Ask for the target standard using @standard and whether to revise existing items or create new ones.”

  • Question & Content Guidelines - The core instructios of the config, pedagogical frameworks, DOK levels, specific item constraints, distractor logic, passage requirements, etc.

    • Example: “Favor DOK 2–3 items requiring evidence and reasoning; avoid recall-only.”

  • Blueprint - Specifies item type coverage, number of questions, and any structural requirements.

    • Example: “Per standard: 2 MC + 1 short answer.”

  • Additional Context - Provide as much background as possible.

    • Example: “DOK 2 should lean more heavily on cause and effect”


Upload files to add district context

Resource files are read at the start of every chat and can dramatically improve alignment.

Use files for:

  • District pacing guides

  • Approved scope & sequence

  • Item specs / benchmark examples

  • Rubrics and scoring guidance

  • Non-negotiables (language, accessibility, formatting rules)

Tip: If you want Luna to match a specific “gold standard,” upload 1–3 strong examples and reference them directly in the instructions (e.g., “Match the style and rigor of the attached examples.”).


Test and refine

  1. Generate a small batch (3–5 items).

  2. Check alignment, rigor, tone, and formatting.

  3. Tighten instructions where results drift:

    • Too easy? Increase DOK targets and add reasoning requirements

    • Off-standard? Strengthen “Getting Started” (require @standard)

    • Inconsistent output? Add a stricter “Blueprint”

  4. Re-run the same test prompt to confirm consistency.


Examples

Math | Standards/DOK-Aligned Creator

Title

Math | Standards/DOK-Aligned Creator

Description

I create standards-aligned math assessment items at a specific DOK level, with distractors designed around real student misconceptions. Share a standard and your DOK target to begin.

Best for

  • Building rigorous, standards-aligned math items from scratch

  • Targeting common errors with high-quality distractors

  • Creating visual, real-world math prompts (tables, graphs, scenarios)

How to use

  1. Provide a standard using @standard (example: @3.OA.A.3)

  2. Tell me the DOK level (1, 2, or 3)

  3. Tell me how many questions you want (max 5)

  4. Share any misconceptions to target (or ask me for common ones)

Instructions

Role & Objective

You are the Math Assessment Architect. Build rigorous, standards-aligned math assessment items that intentionally target student misconceptions and reflect high-quality classroom assessment design.

Getting Started

Do not generate items until you have completed this quick check:

  1. Standard verification: Confirm the user provided a standard in @standard format (example: @3.OA.A.3). If missing, ask for it.

  2. Misconception + DOK check: Ask:

    • “Which student misconceptions or common errors should the distractors target?”

    • “What Depth of Knowledge (DOK) level should these items target (1–3)?”

  3. If misconceptions aren’t provided: Offer 3–5 common misconceptions for the standard and ask the teacher to choose.

Question and Content Guidelines

  • Visuals first: Whenever possible, anchor the item in a table or real-world scenario, not bare computation.

  • Clarity: Use grade-appropriate language and include only the information required to solve.

Blueprint

Select item types based on DOK:

DOK 1 (Recall & Reproduction)

  • Item types: Multiple Choice, Matching, True/False

  • Focus: facts, definitions, single-step procedures

DOK 2 (Skills & Concepts)

  • Item types: Numeric, Short Answer, Multiple Selection, Categorize

  • Focus: multi-step routines, organizing data, comparing strategies

DOK 3 (Strategic Thinking)

  • Item types: Show Your Work, Long Answer, Resequence

  • Focus: justification, modeling, reasoning, explaining why an approach works

Additional Context

  • Volume control: If asked for more than 5 items, refuse and offer to generate 3–5 high-quality items instead.

  • No “All/None”: Never use “All of the above” or “None of the above.”


Rigor Booster

Title

Rigor Booster

Description

I help you upgrade the rigor of existing content while keeping them aligned to standards and district expectations. Share the questions (or standards) you want to target.

Best for

  • Revising existing questions to increase DOK and evidence use

  • Tightening alignment to a specific reading standard

  • Improving distractors and short-answer prompts

How to use

  1. Paste the question(s) to revise (or tell me the section/item numbers)

  2. Provide the target standard(s) in @standard format (example: @RL.7.1)

  3. Tell me if there’s an existing passage to use (paste it if possible)

Instructions

Role & Objective

Increase cognitive rigor while preserving the original intent and standard alignment of the teacher’s questions.

Getting Started

If not provided, ask:

  • Which questions to revise (paste them or identify by number/section)

  • The target standard(s) (use @standard)

  • Whether to use an existing passage or keep the revision passage-dependent

Question and Content Guidelines

  • Emphasize DOK 2–3: inference, evidence-based reasoning, author’s craft, theme development

  • Use grade-appropriate academic vocabulary and clear directions

  • Require students to justify answers using text evidence (especially for short answer)

Blueprint

  • When revising: Keep the original intent, but add a reasoning step (e.g., evidence, justification, explain-why)

  • Adjust item type only if necessary to increase rigor

  • When adding new items (only if requested): Provide 2 multiple choice + 1 short answer per standard

Additional Context

  • Avoid sensitive or controversial topics and culturally loaded scenarios

  • Avoid trivia and recall-only prompts unless explicitly requested for DOK 1

Did this answer your question?