Plectis

Documentation guide

Documentation guide

Rendered from docs/README.md in the public Lean repository. View source

Reading and working with the research

The front page introduces the project. This index helps you choose what to read or do next, whether you want to understand a result, check its proof, continue the research, or inspect how the tools work.

Using the degree-seven polynomial constructed by the erdosproblems.com contributor ani, Lean proves that every preconnected strict-lemniscate set containing two distinct roots has one-dimensional Hausdorff measure greater than two. This refutes the exact Formal Conjectures path-image-length statement; the separate total-variation bound is also checked. The other seven targets remain open. Independent human review of correspondence with the 1958 wording has not been recorded. Comparator checks only selected exact statements, axioms and kernel acceptance; it does not assess novelty or historical correspondence. The papers report intermediate results and the approaches that stopped, with enough of the record preserved for somebody else to inspect the argument and continue from it.

Choose a way in

What you want to do Start here Where it takes you
Understand the project without installing anything A reader’s way in The eight questions, what formalisation adds, and how to read the evidence.
Read the mathematics The papers A short paper for each problem, then a longer record when you need the details.
Read the comparison across problems The cross-problem paper Capacity and congruences, Lambert subsums, method obstructions and their full research record.
Find what has been established and what is missing Results and limits The results beside their remaining open questions, with routes to the evidence.
See what is open and what would settle it The argument graph Every conditional theorem read out of the Lean kernel: what is proved, what reduces to what, which open statements are the same problem in other coordinates, and what a missing input would settle.
Check a result yourself Reproducibility Inspect one claim without Lean, then install the pinned environment if you want to rebuild proofs.
Continue the work or send a correction Contributing A plain-language issue or a focused pull request, with evidence and credit.
Understand the software and research process How this repository works The roles of proofs, claim records, papers, query tools and release checks.

Read

Choose a statement in a short paper. Read its assumptions and argument, then use the longer record for a compressed step, an earlier attempt, or the surrounding computations. Prior work helps with attribution; related problems follows connections elsewhere in the collection.

The source map locates the supporting Lean declarations and paper passages. Each paper says which results have a Lean proof and which use an ordinary mathematical argument or a cited theorem. The claim record gives the selected public statements, their status and their exact remaining-open propositions. Scope records the release boundary, and methodology explains the rules for changing a claim.

Check

To replay a check, follow reproducibility. For selected statements, external verification also provides Comparator interfaces: separately declared formal statements that can be compared with the development. The verification guides explain those checks and their limits.

Contribute

A contribution can be a correction, clearer explanation, earlier reference, counterexample, or useful failed approach. Contributing explains what to send back. The research commons describes how longer investigations retain their starting point, evidence and credit.

For an AI-assisted session, use the research-shift guide. Give a coding agent AGENTS.md so it can find the relevant workflow. The agent guides explain the tools once you have a question to work on. You can also contribute to navigation, validation or the contributor experience through the architecture contribution path.

Where things live

Folder What belongs there
Papers Current PDFs and manuscript sources, grouped by problem.
Paper full text Generated Markdown versions and the detailed paper inventory.
Agent guides Query tools, proof tools and instructions for making changes.
Verification guides Replay instructions, statement comparisons and submission requirements.
Technical reference Research history, correction records and indexing details.
Research commons Contribution, review and attribution records.
Semantic index Technical navigation through formal statements and their recorded relationships.
Primary sources Source provenance and redistribution records.
Measurements Recorded measurements of the tools.
Release records Audits and release identity records.

The main reading guides stay directly under docs/. The JSON files beside them supply the query tools and website. For example, claims.json records public claim status and methodology.json records review rules; the other indexes help locate evidence. You can read the papers without opening these files. Generated technical navigation is a compact entry for readers who want to use the indexes.

Outside docs/, the repository map distinguishes the proof libraries, manuscripts and working records. Folder indexes cover experiments, returned research, tools and formal verification files. The naming conventions explain why similarly named source and documentation folders have different roles.

Files at the repository root

README.md introduces the work and CONTRIBUTING.md explains how to help. AGENTS.md is the shared entry for coding agents; CLAUDE.md loads it for Claude Code. The detailed rules live in the agent guide.

lakefile.toml, lake-manifest.json and lean-toolchain configure the Lean project and pin its dependencies. formalization.yaml is the Comparator manifest for selected statements. CITATION.cff supplies citation metadata; LICENSE, LICENSES/ and REUSE.toml record the licences.

The code of conduct, security policy, CI and contribution forms live under .github/. The privacy policy stays here with the other guides.

Improving these guides

Give each guide a reader’s question to answer, and make its index link say what the reader will learn or be able to do. Define terms where they first matter, and check examples from the repository root. Keep mathematical hypotheses, evidence and open boundaries exact when changing the prose. For a generated page, change its source and run its owning builder; Contributing explains how to return the improvement.

Work on a paper joins the existing question, paper, source and return routes for every programme.