m
Mars AI Operator Module 3 Description · Knowledge
50 min · hands-on
Module Structure
  1. Hook3m
  2. Mental model12m
  3. 6 techniques5m
  4. Demo · V1→V412m
  5. Exercise15m
  6. Quiz3m
  7. What's next
Module 3 of 5 · Description × Knowledge

AI doesn't know about your school.

«Aniqlik so'rovda — aniqlik javobda»

Ask Claude: what is “Mars Pro”? You'll get an answer about a planet or some software. Why doesn't AI know about your school? Because Mars IT School is niche/local. In this module — how to describe a task so AI doesn't guess, and how to understand where it's guessing by default.

Duration
50 min
Hands-on
25 min
Prerequisite
M1 + M2
Release
After M1+M4 pilot

Hook — “Mars Pro”? AI thinks about a planet.AI o'qituvchining maktabini bilmaydi

Scene · Monday, between shifts

You open claude. “Come up with 5 Python assignments for my 12-year-olds this week.” You get: sums of squares, primality test, FizzBuzz, guess the number, dictionary. Technically correct. For your kids — way off.

You ask: “what is Mars Pro?” AI confidently: “apparently, some professional software for a Mars mission…”. About your school's plan, it doesn't know.

Ask Claude: “what is Mars Pro?” — you'll get an answer about a planet. Why doesn't AI know about your school? For AI, Mars IT School = rare / niche / local. This isn't a model bug. It's a map of where it's strong and where it needs to be fed.

By the end of this module, you'll be able to

Three skills I'll be checking

  • Apply all 3 levels of Description — product (what I want) / process (how to think) / performance (how I'll know it's good) — all three explicitly in one prompt, not just one or two.
  • Recognize whether a task is in mainstream knowledge vs niche/local; in the niche zone, back up your prompt with your own data (@-mention files, @-import in CLAUDE.md, MCP).
  • Apply the Description ↔ Discernment loop — 2-3 iterations of prompt improvement, not one "perfect on the first try."

Mental model — what AI knows and how to tell it.AI nimani biladi va unga qanday tushuntirish

Two layers: Knowledge — what the model has in its head from training. Description — how you package the task. Each is a separate subsection. Verbatim quotes from Anthropic + translation. If the language gets fuzzy, trust the original next to it.

1. Knowledge spectrum — frequently · recently · consistently

Anthropic Academy · «AI Capabilities and Limitations» · lesson 6 (Knowledge)
«Capability zone: topics that appeared frequently, recently (within training), and consistently in training data. Limitation zone: rare, post-cutoff, niche, local, or contested topics.»
In Russian: the model is strong where the material in its training was encountered frequently, not recently (before cutoff), and consistently across different sources. It's weak where it's rare, after cutoff, narrow, local (one city / one school) or where sources disagree.

The practical question isn't "does AI know this?", but "how well was it represented in what it read?". A four-zone scale:

// knowledge spectrum for Mars IT School mentor MAINSTREAM Python syntax, for/while loops, FizzBuzz, list/dict, basic OOP → AI will answer accurately, you can trust it POPULAR FRAMEWORK pygame for kids, Scratch, Turtle, Replit, Khan Academy patterns → AI will answer confidently, spot-check NICHE Python teaching methods specifically for 12-year-olds, common error patterns for beginners, Scratch → Python transition ~ AI will give plausible — check every time RARE / LOCAL Mars IT School internals, “Mars Pro” tariff, your group, Alisher from Chilonzor, Uzbek fairy tale ! AI doesn't know — it will invent, it won't warn you // important: AI doesn't signal confidence differently. // it delivers both mainstream and hallucination in the same tone.
→ swipe right if the table is cut off
Characteristic Knowledge Failures · from Anthropic lesson 6

Anthropic identifies 4 types of knowledge failure: staleness (truth at training time ≠ truth now), uneven coverage (niche/local is weak), inherited bias (what's considered “normal” = what was in the data), source amnesia (“read it somewhere” — not a citation). All four are active simultaneously. For a Mars mentor, uneven coverage and source amnesia are caught first.

2. Three levels of Description — product · process · performance

AI Fluency Framework · Description Summary (Dakan, Feller, Anthropic, 2025)
«Product Description: defining what you want in terms of outputs, format, audience, and style. Process Description: defining how the AI approaches your request, such as providing step by step instructions for the AI to follow. Performance Description: defining the AI system's behavior during your collaboration, such as whether it should be concise or detailed, challenging or supportive.»
Translation in one phrase: product = what comes out. process = how to think. performance = how you'll know it's good (and how the AI behaves). All three — in one prompt. Not just one or two.
01 · product

What I want as output

Specific artifact. Format. Audience. Style. Length.

“5 tasks on for-loops, for 12-year-olds, in Uzbek, 1 paragraph of conditions + example”
02 · process

How you should think

Steps. Plan first. Which files to read. What to think about before answering.

“first concept → example from a child's life → typical mistake → task”
03 · performance

How I'll know it's good

Verification criterion. Tone. What the AI should discard itself. When to say “I don't know”.

“A 12-year-old retells the condition in their own words in 30 seconds — otherwise it's weak”

3. Description ↔ Discernment loop — the course's engine

AI Fluency for Educators · lesson 2 «Framework review»
«Description and Discernment work together in a continuous feedback loop, transforming AI from a tool into a thinking partner.»
It's not about “writing the perfect prompt on the first try”. It's a cycle: you described → AI did → you evaluated each of the three layers (product/process/performance — what went wrong?) → rewrote the description more precisely → repeat. 2-3 iterations = normal. One “perfect” prompt is a rare stroke of luck.
step 1
Description

product · process
performance

step 2
AI output

model attempt

step 3
Discernment

evaluate across all 3 layers

Antipattern #1 in Mars: a mentor writes one long prompt → gets the wrong thing → blames the model. Pattern: short prompt → you look at what the AI did → you understand which layer was missing → you add to it. After 2-3 rounds — a working template that you then reuse.

Six techniques prompting — from Anthropic Fluency.Oltita texnika — prompting uchun

Verbatim from AI Fluency Framework lesson 9. Each line is a technique + where it maps to product/process/performance. Remember these six, and you'll cover 90% of cases.

Technique
What it means
Description Layer
Give context
“Be specific about what you want, why you want it, and relevant background.” Why this task, for whom, what already exists.
product + process
Show examples
“Demonstrate the output style or format you're looking for.” Show 1-2 examples of a good answer.
product
Specify constraints
“Clearly define format, length, and other output requirements.” 1 paragraph / no markdown / Uzbek only / no new libraries.
product + performance
Break into steps
“Guide the AI through multi-step reasoning.” First read X, then think Y, then answer Z.
process
Think first
“Ask the AI to think first — give space for the AI to work through its process.” “Before answering, list what is unclear.”
process
Role / tone
“Define the AI's role or tone — specify how you want the AI to communicate.” “You are a Python mentor, answer like a senior colleague, not a teacher.”
performance

Anthropic calls it a “secret weapon”: “Ask the AI itself to help improve your prompt.” Finished the prompt — ask Claude: “what in this request is unclear to you?” Often a whole layer you hadn't considered emerges from that.

Prediction · before reading the demo

The same prompt “come up with 5 Python assignments for 12-year-olds” — is run through 4 iterations. On which version (V1, V2, V3, V4) — in your opinion — will the AI start to discard weak options itself, without your prompting? Write down the number. Let's check.

Demo — four iterations of one prompt.Bitta prompt — to'rtta variant

Zuhra, a Python mentor from Yunusobod. Monday morning, she needs to prepare material for a group of 12-year-olds. The same basic request. Each version adds one Description layer. Mock-output shows what changes in quality.

V1 · bare — no layers

~/zukhraV1 · 0 layers
$ claude

 come up with 5 Python assignments for 12-year-olds

⠋ Done:

1. Sum of squares from 1 to n
2. Check if a number is prime
3. FizzBuzz
4. Guess the number (random)
5. Count vowels in a string

What's wrong: technically valid, but it's a generic Hour-of-Code set. For which 12-year-olds exactly? Just started? Already know conditions? What's the topic — loops, strings, dictionaries? It's completely unclear how to evaluate these. Discernment signal: the prompt hit mainstream AI knowledge and pulled the most average from the training data.

V2 · +product — what I want as output

~/zukhraV2 · product
 come up with 5 Python assignments, topic for/while,
  for 12-year-olds, who already know if/else but have just started loops.
  Format: 1 sentence condition + 1 example input/output.

⠋ Done:

1. Print numbers from 1 to 10, each on a new line.
   Example: input — none, output — 1\n2\n...\n10
2. Calculate the sum of all even numbers from 1 to 20.
   Example: input — none, output — 110
3. Print the multiplication table for 5 (up to 5×10).
4. Until the user types "stop", repeat the greeting.
5. Find the first number greater than 1 whose square is greater than 100.

Better: now on topic (loops), now considers the level (they know if/else). But it's still abstract, like school. "Sum of evens" for a 12-year-old — why? What's a typical mistake? What's the pedagogical approach? The AI doesn't know because we haven't told it how to think.

V3 · +process — how to think

~/zukhraV3 · product + process
 the same 5 assignments on for/while for 12-year-olds (they know if/else).
  For each assignment, think in steps:
    1. concept (what specific loop skill are we mastering)
    2. real-life example for a child (not "sum of evens" — something about
       their world: WhatsApp, TikTok, homework, recess)
    3. most common expected mistake (forgot increment? off-by-one?)
    4. assignment

⠋ Done:

1. CONCEPT: for with range
   REAL-LIFE: scrolling through a TikTok playlist — each video is 15 seconds
   MISTAKE: they'll forget that range(5) gives 0..4, not 1..5
   ASSIGNMENT: "Print 'video N (15 sec)' for 8 videos."

2. CONCEPT: while with an exit condition
   REAL-LIFE: waiting for a friend's reply on WhatsApp — until it arrives
   MISTAKE: infinite loop — they'll forget to change the variable
   ASSIGNMENT: "Until you get 'ok' — keep printing
                'waiting...' with a pause." (show time.sleep)

3-5. [similarly — push-up counter, recess countdown,
        checking if all friends have replied]

Much better: The AI started giving pedagogically meaningful material. "Expected mistake" is almost a lesson plan. But we still haven't told it how you'll know if an assignment is strong. What if the AI gives a weak "real-life example"? It has no criteria to discard it.

V4 · +performance — how you'll know what's good

~/zukhraV4 · product + process + performance
 [V3 prompt in full] +
  CRITERION FOR A GOOD ASSIGNMENT:
  "A 12-year-old child can rephrase the assignment's condition
   in their own words in 30 seconds." If an assignment requires
   explaining the concept for longer — it's weak, discard it.

  First, create 8 candidates, then discard them
  based on this criterion, return 5 final ones
  + show which 3 you discarded and why.

⠋ Thinking…
⠋ Generated 8 candidates.
⠋ Running each through the 30-second test…

DISCARDED 3:
  × "Caesar cipher using a loop" — requires explaining encryption,
     30 seconds isn't enough, it's a loaded concept for a 12-year-old
  × "Bubble sort" — the concept of "sorting with an algorithm"
     itself requires explanation, plus while inside for
  × "Prime numbers" — needs explaining primality, 30+ seconds

5 FINAL (passed 30-sec test):
1. TikTok Playlist [as in V3]
2. WhatsApp Wait [as in V3]
3. Push-up Counter [as in V3]
4. Countdown to End of Break [new — better than push-ups]
5. Group Chat Friend Check [new]

The main thing that happened: AI started to filter out weak options itself. You didn't have to argue with it about every task. The performance criterion did the work inside the AI that a human mentor would do with their eyes without it.

Now multiply that by Mars context. Zukhra's ~/zukhra/CLAUDE.md (from M1) says: "I'm a Python mentor for 11-13 year olds at Mars IT School, my kids are from Yunusobod, native Uzbek, Russian as a second language, instructions and examples in two languages, 70% have basic Scratch". This file is loaded automatically. V4 with Mars context no longer just gives 5 tasks — it gives them bilingually, with the note "these 2 assume the child has seen Scratch blocks — for the 30% who haven't, explain in 2 minutes." What would have taken a V5 iteration without CLAUDE.md comes immediately with CLAUDE.md.

Layer added
What improved
V1 — bare
generic FizzBuzz / Hour-of-Code, mainstream knowledge gave average results
V2 — +product
on topic (loops), on level (know if/else) — but academically abstract
V3 — +process
pedagogically meaningful tasks, an "expected error" appeared, examples from the child's life
V4 — +performance
AI filters out weak options based on your criteria — you only get the final result + a clear reason for rejection
Same module — different mentor

What it looks like for Timur (Python Olympiad 12–14, Chilonzor)

Timur has a different performance metric. Not "12-year-old retells in 30 seconds", but: "solution must pass hidden tests on olymp.uz, complexity O(n log n) or better, no external libraries except allowed olymp set (math, itertools, functools, collections, bisect, heapq)".

Timur described exactly this in his ~/olymp-prep/CLAUDE.md. V4 for him, on the prompt "give me 3 tasks on prefix sums", gives solutions with doctests, with a complexity note in the comment, and itself rejects options using numpy. Same ladder Description, different performance — different result.

Zukhra's main layer is process (how to think pedagogically). Timur's main layer is performance (how to pass the judge). Each has their own template.

Edge of knowledge — where AI honestly doesn't know

Zuhra tries: "explain recursion using an Uzbek folk tale — for 12-year-olds". The AI cheerfully responds with "like Ivan Tsarevich..." — Uzbek tales are rare/local in its training. If not stopped, the material will go to children with Russian names.

The Cure · context injection

Zuhra brings the tale herself into the prompt: "here's the text of the tale about Aldar-Kose and his three sons [full text]. Find a structure in it that repeats on a diminishing scale (that's recursion). Explain it to a 12-year-old". Now the AI works not "from memory," but from the provided source. This is the main technique for niche/local: you are the bearer of local knowledge, the AI is the processor. Not the other way around.

Three places to "put" your context:

Mechanism
When
@-mention file in the prompt
Once in this session. "read @docs/scratch-to-python.md". Doesn't clutter CLAUDE.md, works once.
@-import in CLAUDE.md (@docs/api.md)
Constantly. Context is automatically loaded with each session. For rules you apply every day.
MCP servers
Live data (Jira, Google Drive, Postgres). Connected at the Claude Code level. In this course — mentioned, without going deep (see cheatsheet).

Exercise — 3 probes and a template-snippet.Uchta probe va shablon

Adaptation of "Bad Prompt Makeover" (AI Fluency lesson 8) + "Outsider Test" (AI Capabilities lesson 6). Do all three probes manually — without this, your next prompt will be a guessing game like everyone else's.

Probe 1 · 5 min · what layer you usually omit

Take a task from Module 2 (Co-creation level)

In Module 2, you chose a task for Co-creation — where AI and you work together. Go back to it.

  1. Write a prompt for this task as you would on a normal day. Do not edit. Save as V1.
  2. Open it and mark with a highlighter: what here is product, what is process, what is performance. What layer is missing?
  3. Write down in one phrase: "I by default forget the ___ layer"». This is your personal pattern.
What to include in the report: what layer was missing in V1, how this changed from task to task (one habit or different).
Probe 2 · 12 min · ladder V1 → V4

Run the same task through 4 iterations

This is the heart of the exercise. After each version — a short note. Not “improved/not improved,” but what exactly.

  1. V1 (bare). The one from probe 1. Run it. Read the answer. Write down: what's good, what is won't work for a student/colleague/in production.
  2. V2 (+product). Add a specific format / audience / length / style. Run it. Write down what improved vs V1.
  3. V3 (+process). Add steps/plan/“first read X.” Run it. Write down what improved vs V2.
  4. V4 (+performance). Add a criterion “how I'll know it's good” + ask the AI to self-reject weak options. Run it. Write down what the AI self-rejected.
Falsifiable hypothesis: between V3 and V4 you will see a qualitative leap — the AI will start rejecting weak options itself, not you. If this didn't happen — your performance criterion is inaccurate, rewrite it.
Probe 3 · 8 min · your reusable snippet

Assemble a template-snippet that will fly into your clipboard

Your Teaching Context from M1 + your product/process/performance from probe 2 = a template you reuse. Not “one prompt for everything,” but a framework, where you plug in the task.

  1. Open your CLAUDE.md from M1. Copy the relevant section from it (role / audience / language). This is the title of your template.
  2. Below it, write down 3 lines:
    PRODUCT: [what I usually ask for — format/length/style]
    PROCESS: [how the AI should think — my standard steps]
    PERFORMANCE: [my “good” criterion — what the AI uses to self-reject]
  3. Put it in your system clipboard manager (Raycast Snippets / Alfred / just ~/snippets/mars-prompt.txt). The trigger is a short word, for example ;mp.
  4. The following 3 prompts in Claude - start with this snippet, add only the specifics of the task. Compare speed and quality as it was.
Artifact of the exercise: one template file that you use further. If you haven't returned to it even once in a week, the template is weak, rewrite it.
Reflection · before quiz

Before you check yourself - pause for 60 seconds

These answers stay with you — they are not sent. This is an anchor so the module doesn't fly out of your head in a week.

Quiz — check yourself in 3 minutes.O'zingni sina — 3 daqiqada

Three apply-questions. If you made a mistake in at least one, go back to the corresponding section. Not a grade, but an insurance before the next prompt.

Question 01

You've formulated a great question, and it touches on a core aspect of how we're building things here. Let's break down the relationship between CLAUDE.md and AGENTS.md, and how the "Claude Code" fits in. **CLAUDE.md: The Foundation of Intelligence** Think of CLAUDE.md as the "brain" or the core intelligence model. It's the blueprint for how Claude itself thinks, reasons, and processes information. This document contains the fundamental principles, the architectural overview, and the high-level description of Claude's capabilities. It defines: * **Claude's core identity and persona:** Who Claude is, its values, its safety principles. * **Its reasoning capabilities:** How it approaches problems, generates ideas, and makes decisions. * **Its knowledge base and learning mechanisms:** How it acquires and updates information. * **Its interaction protocols:** How it communicates and understands prompts. In essence, CLAUDE.md is about the *what* and *how* of Claude's internal workings as a general intelligence. It's the "operating system" for its mind. **AGENTS.md: The Application Layer** Now, AGENTS.md builds *on top* of CLAUDE.md. If CLAUDE.md is the brain, AGENTS.md describes how we *use* that brain to perform specific tasks and achieve particular goals. It's the "application layer" where we define specialized entities that leverage Claude's core intelligence. AGENTS.md focuses on: * **Defining different types of agents:** What are their roles? What are their specific objectives? * **Agent architectures:** How are agents structured? Do they have sub-agents? How do they interact? * **Tool integration:** What external tools or APIs do agents use (e.g., `git`, `npm`, `kubectl`, `python`, `bash`)? * **Context management for agents:** How do agents maintain and utilize their specific context? * **Prompt engineering for agents:** How do we craft effective prompts to guide agents to perform their specialized tasks? * **Workflow definitions:** How do agents collaborate to achieve complex outcomes? For example, you might have an agent defined in AGENTS.md whose sole purpose is to manage `git` repositories. This agent would leverage Claude's understanding (from CLAUDE.md) to interpret your request ("commit these changes," "rebase this branch") and then translate that into specific `git` commands, using its defined tools. **The "Claude Code": The Implementation** The "Claude Code" is the actual, executable code that brings both CLAUDE.md and AGENTS.md to life. It's the software that: 1. **Implements the core intelligence described in CLAUDE.md:** This includes the neural network architectures, the inference engines, the safety filters, and the mechanisms for processing natural language. This is often proprietary and internal to the model itself. 2. **Implements the agent frameworks described in AGENTS.md:** This includes the code for creating, managing, and orchestrating agents, handling their context, integrating their tools, and processing their prompts. This is where you'd find the logic for how an agent receives a prompt, decides which tool to use, executes the command, and interprets the output. So, when you're interacting with an agent, you're essentially using the "Claude Code" that implements the agent's definition (from AGENTS.md), which in turn relies on the core intelligence implemented by the "Claude Code" based on CLAUDE.md. **MarsCode and the Agent Framework** MarsCode is a specific implementation of this agent framework. It's a system built using the "Claude Code" that allows us to define and run agents. MarsCode uses the principles outlined in CLAUDE.md for its underlying intelligence and the structures defined in AGENTS.md to create its operational agents. When you use MarsCode, you're interacting with an agent (or a system of agents) that has been designed according to AGENTS.md, and that agent is powered by the core Claude intelligence described in CLAUDE.md. **Analogy:** * **CLAUDE.md:** The human brain's anatomy and fundamental cognitive processes (how we think, learn, reason). * **AGENTS.md:** Job descriptions and organizational charts for a company (who does what, how teams are structured, what tools they use). * **"Claude Code":** The actual biological processes of the brain and the employees performing their jobs in the company. * **MarsCode:** The company itself, with its employees (agents) using their brains (Claude's intelligence) to achieve business goals. **In summary:** * **CLAUDE.md** defines the *core intelligence*. * **AGENTS.md** defines *how that intelligence is applied* through specialized agents. * **"Claude Code"** is the *implementation* that makes both possible. * **MarsCode** is a *system* that leverages the "Claude Code" to run agents defined by AGENTS.md, powered by the intelligence of CLAUDE.md. They are all deeply interconnected, with each layer building upon the one below it to create a powerful and flexible system. product (what I want) and process (how to think), but forgot performance (as soon as I understand it's good). What will most likely happen?

AAI will refuse to answer because there is not enough information to launch
BAI will give you a plausible result that you won't be able to reject — you'll have to evaluate each sentence with your eyes instead of AI
CAI will add the performance layer itself, because it will guess from the context
DAI will give a shorter answer than if performance had been specified
Right — B. The performance layer is your rejection criterion. Without it, the AI doesn't know which of its candidates are weak, and returns everything as plausible. This shifts the discernment work back to you — you manually review each one. A — AI almost never refuses due to lack of performance, it just goes and does it. C — it very rarely guesses your criterion; in Mars context, almost never. D — there's no correlation with length.
Question 02

What kind of AI prompt more likely to give a bad answer due to knowledge limitation?

AExplain Python's list comprehension syntax with examples for beginners
BSuggest 3 Tashkent districts for open-air activities with a group of 12-year-olds, considering transport from Yunusabad.
CTell me how an arrow function works in JavaScript ES6 and how it differs from a regular function.
DDescribe the try/except pattern in Python for working with files
Right — B. Tashkent districts, transport logic specifically from Yunusobod, open-air for children's groups — this is rare/local per Anthropic terminology lesson 6. AI will give a plausible (it will name parks it has heard of), but confident tone — without a "I'm not sure" signal. A, C, D are mainstream knowledge, presented frequently/consistently. AI is strong on them.
Question 03

Prompt: "write a message to a late parent". You added Mars context (you're a mentor, their child Alisher is in class, 20 minutes late) and the specifics of the situation. You got a cold, formal letter. What layer of Description was missing?

AProduct — AI didn't know what format was needed
BProcess — AI didn't know what steps to take before writing
CPerformance — the tone/style wasn't set ("warm, like a colleague to a parent, not like a company employee")
DKnowledge — AI doesn't know about your school, you should have explicitly mentioned Mars IT School
Right — C. Tone — this is performance. "Cold, formal" is the AI's default voice without explicit instruction. The Performance layer according to the AI Fluency Framework: "defining the AI system's behavior — concise or detailed, challenging or supportive". D — a distractor: you added Mars context, the AI knew about the school, but didn't know what tone you wanted. A — the format "message" was specified. B — for a short letter, the process isn't critical.
// select an answer for each question
All commands on one page: claude-code-cheatsheet.md @-mention, @-import, /memory, MCP servers

What's next — Module 4.Keyingisi — Modul 4

Attribution and License

This module is adapted by Mars IT School (2026) based on:

«AI Capabilities and Limitations» — Anthropic Academy, 2026, lesson 6 "Knowledge" (frequently / recently / consistently · staleness · source amnesia).

«AI Fluency: Framework & Foundations» — Dakan, Feller, Anthropic, 2025 — lesson 8 "Description" (product / process / performance) and lesson 9 "Effective Prompting" (6 techniques).

«AI Fluency for Educators» — the same authors, 2025 — lesson 2 "Framework review" (Description ↔ Discernment loop) and lesson 3 "Course design" (Stage 2-3 worked example, Teaching Context document).

— Claude Code documentation (claude.com/docs) — @-mention files, @-import in CLAUDE.md, /memory, MCP overview.

Our adaptation is CC BY-NC-SA 4.0. You can copy, remix, use in teaching — with attribution to Mars IT School and retaining the same license.

Final · in one phrase

How was the module overall?