Contents
- The written record, in reading order
- Foundations: the studies as a path
- The long arc, with its sources
- Where the fields meet
- Check it the way a scholar would
- For builders: data, code, and the agent map
- Where the record is thin
The written record, in reading order
The whole written record stands on one page, The Record, and document by document below, in the order the Record reads them. Each document also stands on its own page, and its source is kept on GitHub.
- The long arc (TIMELINE.md), source on GitHub.
- The charter (ECOSYSTEM.md), also on its own page, source on GitHub.
- The needs map (NEEDS.md), also on its own page, source on GitHub.
- Democracy (DEMOCRACY.md), also on its own page, source on GitHub.
- Participation (PARTICIPATION.md), also on its own page, source on GitHub.
- The registry (REGISTRY.md), also on its own page, source on GitHub.
- The open table (OPEN_TABLE.md), also on its own page, source on GitHub.
- The ledger (LEDGER.md), also on its own page, source on GitHub.
- Intentions (INTENTIONS.md), also on its own page, source on GitHub.
- The progress log (PROGRESS.md), also on its own page, source on GitHub.
- Interactions (INTERACTIONS.md), also on its own page, source on GitHub.
- Funds (FUNDS.md), also on its own page, source on GitHub.
- The funds ledger (FUNDS_LEDGER.md), also on its own page, source on GitHub.
- The shelf: proven work by others and by the Commons, each entry with its license checked at its source and three doors, use it, adopt it, and change it.
- Public records: what stands in the open for each need, what the Commons holds, what others hold open for anyone, and what is missing, each record with its source and its limits.
Foundations: the studies as a path
Foundations holds 71 studies across 38 fields of study, each one opened and read at its source before it was filed, and each printed with its source beside it. Walk it as a curriculum: begin with a demonstration you can run, then read the field it came from.
Five findings can be run, each in under a minute:
- Cash transfers, Kenya
- False news travels faster
- Connection and survival
- Citizen report cards, Uganda
- AI help and novices
The fields, and where to begin in each:
- Poverty and material security: 2 studies. Begin with The Short-term Impact of Unconditional Cash Transfers to the Poor: Experimental Evidence from Kenya (Quarterly Journal of Economics, 2016).
- Economics and incentives: 2 studies. Begin with Performance Pay and Productivity (American Economic Review, 2000).
- Governance and democracy: 2 studies. Begin with Power to the People: Evidence from a Randomized Field Experiment on Community-Based Monitoring in Uganda (Quarterly Journal of Economics, 2009).
- Health and the body: 2 studies. Begin with The Association Between Income and Life Expectancy in the United States, 2001-2014 (JAMA, 2016).
- Mind and mental health: 2 studies. Begin with A Wandering Mind Is an Unhappy Mind (Science, 2010).
- Meaning, values, and human flourishing: 2 studies. Begin with Purpose in Life as a Predictor of Mortality Across Adulthood (Psychological Science, 2014).
- Learning and education: 2 studies. Begin with Active Learning Increases Student Performance in Science, Engineering, and Mathematics (Proceedings of the National Academy of Sciences, 2014).
- Language and communication: 3 studies. Begin with Consequences of Erudite Vernacular Utilized Irrespective of Necessity: Problems with Using Long Words Needlessly (Applied Cognitive Psychology, 2006).
- Artificial intelligence and human computer interaction: 2 studies. Begin with Experimental Evidence on the Productivity Effects of Generative Artificial Intelligence (Science, 2023).
- Belonging and social connection: 2 studies. Begin with Social Relationships and Mortality Risk: A Meta-analytic Review (PLOS Medicine, 2010).
- Cooperation and collective action: 2 studies. Begin with Altruistic Punishment in Humans (Nature, 2002).
- Truth and shared knowledge: 2 studies. Begin with The Spread of True and False News Online (Science, 2018).
- Food systems and agriculture: 2 studies. Begin with Global food demand and the sustainable intensification of agriculture (Proceedings of the National Academy of Sciences, 2011).
- Water and sanitation: 2 studies. Begin with Water, sanitation, and hygiene interventions to reduce diarrhoea in less developed countries: a systematic review and meta-analysis (The Lancet Infectious Diseases, 2005).
- Housing and homelessness: 3 studies. Begin with A Multiple-City RCT of Housing First With Assertive Community Treatment for Homeless Canadians With Serious Mental Illness (Psychiatric Services, 2016).
- Energy access: 2 studies. Begin with The Effects of Rural Electrification on Employment: New Evidence from South Africa (American Economic Review, 2011).
- Early childhood: 3 studies. Begin with Labor market returns to an early childhood stimulation intervention in Jamaica (Science, 2014).
- Aging: 4 studies. Begin with Loneliness and Social Isolation as Risk Factors for Mortality: A Meta-Analytic Review (Perspectives on Psychological Science, 2015).
- Disability and inclusion: 3 studies. Begin with World report on disability (World Health Organization and World Bank report, 2011).
- Digital access: 2 studies. Begin with The Digital Provide: Information (Technology), Market Performance, and Welfare in the South Indian Fisheries Sector (The Quarterly Journal of Economics, 2007).
- Law and justice: 2 studies. Begin with The Effects of Pretrial Detention on Conviction, Future Crime, and Employment: Evidence from Randomly Assigned Judges (American Economic Review, 2018).
- Environment and climate adaptation: 3 studies. Begin with Climate Trends and Global Crop Production Since 1980 (Science, 2011).
- Work and livelihoods: 2 studies. Begin with A multifaceted program causes lasting progress for the very poor: Evidence from six countries (Science, 2015).
- Migration and refuge: 3 studies. Begin with The Place Premium: Bounding the Price Equivalent of Migration Barriers (The Review of Economics and Statistics, 2019).
- Sleep: 2 studies. Begin with The effects of improving sleep on mental health (OASIS): a randomised controlled trial with mediation analysis (The Lancet Psychiatry, 2017).
- Grief and loss: 1 study. Begin with Treatment of Complicated Grief: A Randomized Controlled Trial (JAMA, 2005).
- Addiction and recovery: 1 study. Begin with Effect of Prize-Based Incentives on Outcomes in Stimulant Abusers in Outpatient Psychosocial Treatment Programs: A National Drug Abuse Treatment Clinical Trials Network Study (Archives of General Psychiatry, 2005).
- Savings: 1 study. Begin with Tying Odysseus to the Mast: Evidence From a Commitment Savings Product in the Philippines (Quarterly Journal of Economics, 2006).
- Insurance: 1 study. Begin with Free Distribution or Cost-Sharing? Evidence from a Randomized Malaria Prevention Experiment (Quarterly Journal of Economics, 2010).
- Debt: 1 study. Begin with The High Price of Debt: Household Financial Debt and Its Impact on Mental and Physical Health (Social Science and Medicine, 2013).
- Play: 1 study. Begin with Taking Shape: Supporting Preschoolers' Acquisition of Geometric Knowledge Through Guided Play (Child Development, 2013).
- Music: 1 study. Begin with Effects of Group Drumming Interventions on Anxiety, Depression, Social Resilience and Inflammatory Immune Response among Individuals with Mental Health Conditions (PLOS ONE, 2016).
- Craft and making: 1 study. Begin with Learning in the Making: A Comparative Case Study of Three Makerspaces (Harvard Educational Review, 2014).
- Public space: 1 study. Begin with Changing the urban design of cities for health: The superblock model (Environment International, 2020).
- Local news: 1 study. Begin with Newspaper Closures Polarize Voting Behavior (Journal of Communication, 2018).
- Pain: 1 study. Begin with Literacy-Adapted Cognitive Behavioral Therapy Versus Education for Chronic Pain at Low-Income Clinics: A Randomized Controlled Trial (Annals of Internal Medicine, 2018).
- Libraries: 1 study. Begin with Public Libraries: A Community-Level Resource to Advance Population Health (Journal of Community Health, 2019).
- Repair: 1 study. Begin with 'Fixing the World One Thing at a Time': Community Repair and a Sustainable Circular Economy (Journal of Cleaner Production, 2021).
The corpus itself is a data file, foundations.json, so a learner or a machine can take the whole set away and work on it.
The long arc, with its sources
The timeline opens with the long arc: farming's ten independent origins and the milestones each harvest made possible. It stands at the head of The Record and in full in TIMELINE.md.
Every span here is a range because the scholarship gives ranges. These were slow processes, spread over centuries of trying, not single years with a date on them, and the beginnings are still argued over. Ethiopia's row is the least settled of the ten.
The research behind it opened 30 sources, peer reviewed papers, university publications, and museum and heritage records among them, and the notes name the argued points. Two claims were left out for lack of support, and the log says so: an Indus origin of farming, and an early date for enset. The entry stands in the progress log.
Where the fields meet
The Commons draws a few connections itself, between a finding in one field and the layer of need it speaks to. Each stands open to correction like everything else here.
- Money and the body. The Kenya cash transfer finding, in Poverty and material security, measures the floor of the body directly: money with no conditions raised what households consumed. Run it. The tool at that layer is Ground.
- Printed facts and shared truth. The Uganda report cards finding, in Governance and democracy, shows a community scorecard moving clinics and schools. Run it. Graph works the same bet at the layer of shared truth, and the Index files claims the same way, with their checks attached.
- Help and learning. The study of AI help and novices, in Artificial intelligence and human computer interaction, found the least practiced gained the most from the same help. Run it. Atlas is built on that shape at the layer of learning: one claim at a time, its proof shown.
- Speed and truth. False news travels faster than true news, in Truth and shared knowledge. Run the race. The Index exists in the shape of that finding: one timeline for everyone, claims before verdicts, corrections added and never quietly edited.
- Ties and belonging. Connection and survival, in Belonging and social connection, ties the strength of a person's ties to living longer. Run it. Cohort serves that layer, and Still serves the mind that carries it.
Where the record disagrees with itself, both readings stand. In the Index, one early Graph figure stands filed as corrected, and its correction stands in its own entry beside it, each with its source and its hand. Nothing here is quietly edited; a fix is a new entry. See the pair in the Index.
Check it the way a scholar would
Every claim in this record carries three things: its ground, the source it stands on; its hand, the named person or people who stand behind it; and its check, the way a stranger can test it again and find the same result. The methods and measures stand one layer down from every claim, so a learner in any field can go as deep as the record goes.
- The Index: its format, its six states, and its validator are kept in the Index repository, and the entries themselves stand in the viewer, each with its seal.
- Atlas: one claim stands on its page with its full proof, the same on phone, watch, voice, and wall: the Proof screen.
- Graph: its scores come from a hand labeled set of documents, and the misses are published beside the scores, in its repository and on its page.
- Machine: its gradient checks and its two benchmark runs are recorded in its repository, with the numbers counted by the code.
- Lumen: its refusal tests run over the real texts of its two exhibits, and the results stand in its repository.
- Still: it collects nothing and calls nothing; its one measure, the pacer timing runs, stands committed in its repository, labeled as builder test runs.
- Ground: every listing carries its check date and its expiry, and past expiry a listing shows as stale, never silently: the board and its repository.
For builders: data, code, and the agent map
One section among the learning sections, for those who build: the data files, the code, and the map written for agents.
- Data: site.json, the acts in machine readable form; foundations.json, the 71 studies; listings.json, Ground's listings with their check dates.
- The agent map: llms.txt, this whole site written plainly for agents, with the duties an agent carries here: state that you are an agent, and name your operator.
- Code: nine repositories, one per act and one for the record: github.com/topsoilcommons. The scripts that build these pages stand in tools of the record repository.
- Taking part: the doors on the home page are sized in minutes and credited in the open; the rules stand in The open table and Participation.
Where the record is thin
Stated as thin, in the open:
- Money: the funds ledger opened on October 15, 2026, and its one entry records $0 in, no funds received yet, and no host appointed. Every later amount joins it there. Funds and the funds ledger.
- People: the doors for taking part were wired on October 15, 2026, and no outside interaction stands answered yet. The log of them stands open and empty: Interactions.
- Languages: Still stands in English. Its Spanish is staged, awaiting a fluent human check, and does not ship until that check resolves every disputed line.
- Cohort's room: its server cannot run on static hosting, so the live room is a package ready to deploy, not a running room, and the record says so.
- Reach: no outside contributor has shipped yet, and no institution has adopted a tool. The phases in the timeline name those as gates, not as facts.
For the plain telling: The story, where this comes from, where it stands, and where it is going.
For agents and builders
The machine readable forms of this page's contents: llms.txt, the agent map; site.json, the acts as data; and foundations.json, the studies as data.