- 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.
- 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
| Part | Component | Version | Permissions | Cost |
|---|---|---|---|---|
| Runtime | Python, standard library only | 3.12 | Reads the files you give it and writes only the output folder you name | Free |
| Tool | Any spreadsheet | Not available. Not fixed; any spreadsheet that opens CSV works | Opens a copy of the CSV files | Not available. Depends on the spreadsheet you use; free ones work |
| Data | NOAA GHCN-Daily record, station USW00093193 | 2023, SHA-256 abde4990…b3b9a7 | Read a copy | Free (US government work) |
| Harness | Any chat assistant or coding agent | Not available. Not fixed; an assistant may explain an equation or draft code, and every number it gives is checked against FAO's worked examples | Reads what you paste in; give it a copy of the record only | Not 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
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.
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
- Use the folder and Python from AGR-003.
- 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.
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
- Partner or Sensei: Waits until the learner has started, then reveals one card. Hand-off: The learner writes a prediction.
- Learner: Changes only what the card says, recomputes the season and compares with the prediction.
- Partner or Sensei: Reviews the prediction, the result and the explanation.
Tests, failures and corrections
| Check | Expected | Result | Evidence |
|---|---|---|---|
| Recompute the three cards with the pathway script | A (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-27 | Passed on | /examples/agriculture-pathway/generated/randori/cards.json |
| A learner meets a drawn card with a prediction written first | Prediction, recompute and explanation | Not run | Not 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.
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
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
NOAA National Centers for Environmental Information
Global Historical Climatology Network - Daily (GHCN-Daily) (opens the publisher's site in a new tab)
- Free
- Docs
- Intermediate
NOAA's archive of daily station weather: maximum and minimum temperature, rain and more, with measurement, quality and source flags for every value. Not homogenized, so check a station's record before you trust a trend from it.
Food and Agriculture Organization of the United Nations
Crop evapotranspiration (FAO Irrigation and Drainage Paper 56) (opens the publisher's site in a new tab)
- Free
- Book
- Advanced
The reference method for reference evapotranspiration (FAO Penman-Monteith), how to estimate missing humidity, radiation and wind, and crop coefficients by growth stage, with worked examples you can reproduce.
Food and Agriculture Organization of the United Nations
Irrigation Water Management: Irrigation Water Needs (Training Manual No. 3) (opens the publisher's site in a new tab)
- Free
- Book
- Beginner
FAO's introductory chapter on irrigation water needs: effective rainfall with two simple monthly formulas, and the irrigation need as crop water need minus effective rainfall, with a worked question and answer.
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.



