---
title: Crop Template
description: Standard documentation structure for a crop, with frontmatter and all standard sections (PRD §12).
status: template
---

# {Crop Name}

**Scientific name:** *{Genus species}*
**Common name:** {name}
**Family:** {family}
**Category:** {seed | grain | oilseed | legume | vegetable | staple}

> ⚠️ **Status:** {outline | drafted | reviewed} — research {not yet | partially | fully} written. Update as the crop progresses.

## Documentation map

| Topic | Page | Scope |
| --- | --- | --- |
| Overview | `index.md` | Identity and reading order |
| Biology | `biology.md` | Taxonomy, growth habit, lifecycle, flowering, photoperiod, seed development |
| Climate | `climate.md` | Temperatures, frost/heat tolerance, rainfall, day-length |
| Soil | `soil.md` | Type, texture, drainage, pH, salinity, preparation |
| Planting | `planting.md` | Seed, germination, sowing, density, dates |
| Irrigation | `irrigation.md` | Water needs by growth stage, water stress |
| Fertilization | `fertilization.md` | N, P, K, micronutrients, amendments |
| Pests & diseases | `pests-diseases.md` | Insects, fungi, birds, weeds |
| Harvesting | `harvesting.md` | Maturity, window, manual harvesting |
| Processing | `processing.md` | Threshing, winnowing, cleaning, sorting |
| Storage | `storage.md` | Drying, moisture, containers, shelf life, viability |
| Yield | `yield.md` | Yield across scales (g/plant → kg/ha) |
| Economics | `economics.md` | Inputs, labor, cost per kg, market equivalent |
| Open questions | `open-questions.md` | What is not yet known |
| Sources | `sources.md` | Sources cited for this crop |

## How to use this template
1. Copy this directory structure when adding a new crop (`docs/crops/<crop>/index.md` + one file per topic).
2. Every page gets the same frontmatter (`title`, `description`, `status`) and the ⚠️ status note until its claims are evidence-tagged.
3. Map the topic files 1:1 to `data/crops/<crop>.yaml`; keep the two in sync.
4. Research method: see `docs/methodology/` (evidence levels, source quality, units, experiments).

## Cross-cutting links
- Methodology: [`docs/methodology/overview.md`](../../methodology/overview.md)
- Evidence levels: [`docs/methodology/evidence.md`](../../methodology/evidence.md)
- Units: [`docs/methodology/units.md`](../../methodology/units.md)
- Structured data schema: [`data/crops/`](../../../data/crops/)