Specialization kata · AGR-R01

Agriculture Randori: an unseen change of assumption

Start from the maize estimate; a partner reveals one changed assumption after you begin. Predict the direction and rough size of the change, then recompute and explain the difference.

Draft. This recipe is a draft. Its checks may not have been run, and it can change.

Status
Draft
Kata ID
AGR-R01
Maintainer
Agriculture pathway maintainer
Last verified
Not available. Built and checked by the Dojo maintainers and CI; no independent, agronomic or engineering review yet.
Found a problem?
Report it

The outcome

Meet one changed assumption you did not see in advance, with a prediction first and a recompute after.

For: Learners who finished AGR-003, working with a partner or Sensei.

Done when

  • Your prediction (sign and rough size) is written before you recompute
  • Your recomputed season need matches /examples/agriculture-pathway/generated/randori/cards.json for the card
  • You name the equation or table value the card changed and explain any gap between prediction and result

You make: Irrigation estimate. Outcome: Estimate irrigation need.

Showcase and provenance

The Dojo’s worked example, made by the maintainers rather than by a learner: one year of NOAA daily weather for a California station, FAO-56 reference evapotranspiration and a maize irrigation estimate, every number computed by the site’s CI.

See the showcase

Made by
NOAA National Centers for Environmental Information (weather record); Developer Dojo maintainers (script and results)
Source
NOAA GHCN-Daily station USW00093193, 2023; method from FAO Irrigation and Drainage Paper 56; results from /examples/agriculture-pathway/tools/agri_pathway.py
Licence
Weather record is a US government work (no US copyright, 17 U.S.C. 105); script and outputs MIT
Date

Brief, inputs and constraints

Inputs

  • Your AGR-003 estimate. Source: Your own output, or /examples/agriculture-pathway/generated/irrigation.json. Terms: Dojo output, MIT licence.
  • The Randori cards. Source: The table on /katas/agriculture-pathway (the partner keeps it; the learner sees only the drawn card). Terms: Dojo content, MIT licence.

Constraints

  • No paid tools
  • Offline capable
  • No personal data

Capabilities practised

  • Calculate
  • Verify evidence

Stack, permissions and cost

Stack components with version, permissions and cost
PartComponentVersionPermissionsCost
RuntimePython, standard library only3.12Reads the files you give it and writes only the output folder you nameFree
ToolAny spreadsheetNot available. Not fixed; any spreadsheet that opens CSV worksOpens a copy of the CSV filesNot available. Depends on the spreadsheet you use; free ones work
DataNOAA GHCN-Daily record, station USW000931932023, SHA-256 abde4990…b3b9a7Read a copyFree (US government work)
HarnessAny chat assistant or coding agentNot available. Not fixed; an assistant may explain an equation or draft code, and every number it gives is checked against FAO's worked examplesReads what you paste in; give it a copy of the record onlyNot available. Depends on your assistant and plan; not measured

Stack recipes

  • Python standard library

Why this stack

The standard library is enough for these equations, runs offline with nothing to install, and gives the same numbers on every machine. CI runs the identical script on every pipeline.

Alternatives

  • A ready-made evapotranspiration package or FAO's ETo Calculator. Faster, but hides the equations this pathway is about. Not tried for this pathway, so its numbers are not compared here. Not tested for this recipe.

Agents and review gates

  1. Partner or Sensei

    Draws one card after the learner starts and keeps the others hidden.

    Review gate: Asks for the prediction, the recompute and the explanation.

  2. Learner

    Reads the card, predicts, changes only the one assumption and recomputes.

    Depends on: Partner or Sensei

    Review gate: The prediction is written down before the recompute runs.

Setup and smoke test

  1. Use the folder and Python from AGR-003.
  2. The partner opens the Randori table on /katas/agriculture-pathway; the learner does not.

Sign-in and access: None.

Smoke test

Do
Recompute all three cards with the pathway script
Expect
Card A +22.5 mm, card B +26.9 mm, card C -2.4 mm against the 726.8 mm baseline
Result
Passed /examples/agriculture-pathway/generated/randori/cards.json, recomputed by CI on every pipeline

Prompts

Copy a prompt into the assistant you use. Replace anything that does not fit your situation, and never paste private or personal data you are not allowed to share.

Predict before you compute

Make the learner commit to a reading of the method before the code answers.

You can also select and copy the text.

Practice exercise

Crop evapotranspiration (FAO Irrigation and Drainage Paper 56). From Crop evapotranspiration (FAO Irrigation and Drainage Paper 56) (Food and Agriculture Organization of the United Nations).

Terms: © FAO. Free to read online; cite it and read FAO's terms before copying text or figures.

Execution and handoffs

  1. Partner or Sensei: Waits until the learner has started, then reveals one card. Hand-off: The learner writes a prediction.
  2. Learner: Changes only what the card says, recomputes the season and compares with the prediction.
  3. Partner or Sensei: Reviews the prediction, the result and the explanation.

Tests, failures and corrections

Checks with expected and recorded results
CheckExpectedResultEvidence
Recompute the three cards with the pathway scriptA (Kc end 0.60): 749.3 mm, +22.5; B (dewpoint Tmin minus 2 degrees C): 753.7 mm, +26.9; C (planting 1 May): 724.4 mm, -2.4, harvest 2023-09-27Passed on /examples/agriculture-pathway/generated/randori/cards.json
A learner meets a drawn card with a prediction written firstPrediction, recompute and explanationNot runNot run, so there is no evidence. This is not a pass.

Failures and corrections

  • Observed: Card C was expected to lower the need a lot because the season moves later Correction: The season also ends a month later, in September, so the hot months stay inside it; only the total over the shifted days changes.

Adapt it

  • The partner draws two cards Apply one at a time and recompute after each, so you know which change moved what.

Unseen Randori

Meet one changed assumption you have not seen, revealed after you start, on the maize estimate.

Constraints

  • Write your prediction before you compute
  • Change only what the card says
  • Name the equation or table value that moved

How it is judged: The recompute matches the CI result for the card, and the partner agrees the explanation names what moved.

More Randori challenges

Belt evidence

Belt stages are proposed practice stages, not issued credentials. Evidence below is what a reviewer would look for; it is not a record that anyone has shown it.

Evidence a reviewer looks for

  • For the card drawn, a written prediction, the recomputed season need, and an explanation of any gap between them (Automated check)
  • A Sensei or partner checks that the prediction was written before the recompute and that the explanation names the equation that moved (Sensei review)

Belt criteria

  • Practice: Handles card C, where the change is small, and explains why it is small
  • Adapt: Handles card A or B and predicts the sign of the change correctly
  • Demonstrate: Writes a fourth card for a partner and predicts its result before running it

See the belt stages · Prepare a practice review

Connections

Used by
No other kata names this one as a foundation yet.
Transfers to
Professional review
Required. Any real use of this outcome needs independent validation and any approval required from a qualified professional. Practice here does not grant a licence.

Sources

Maintenance and caveats

Review cadence: Every six months, or when FAO revises Paper 56

  • This recipe is a draft: the example was built and checked by the Dojo maintainers and CI, and no learner has run it yet.
  • Nothing here is an irrigation recommendation. No agronomist, irrigation engineer or water authority has reviewed it, and real water use needs the qualified people and local rules that apply to it.
  • Humidity, radiation and wind are estimated from temperature, as FAO-56 describes for missing data. The results are estimates, not measurements.
  • NOAA says GHCN-Daily is not homogenized. One station and one year say nothing about a trend.
  • The cards are invented practice changes, not advice for any farm.

All kata recipes · Back to katas