google-deepmind / google-deepmind/formal-conjectures

Agent guidance: landed contributor docs, review skill and CLI handoff

Open
#4,876 5 comments 0 reactions 0 assignees View on GitHub
Dominant language
Lean
Stars
1.3k
Forks
485
Avg merge
1d 20h
Merged PRs (30d)
328

Description

Updated 11 September 2026. The entry points now have separate, concrete owners.

| Entry point | State |
| --- | --- |
| `AGENTS.md`, `STATEMENTS.md`, `PROOFS.md`, `CONTRIBUTING.md` | Landed contributor guidance |
| Semantic review procedure and retained report contract | #4899, open for review |
| CLI usage guide, skill discovery/installation and prepare → finish handoff | #5386, draft after #4899/#5375 |

The contributor's existing agent conducts semantic review and owns authentication/model choice. The CLI prepares exact inputs, builds independently, collects bounded sources and validates the completed report. Findings are advisory; maintainers decide acceptance.

The review skill points to deterministic operations rather than reproducing them in prose. A separate plugin framework, model launcher, autonomous `formalize`/`fix` system and automatic broad review are deferred in #4394.

**Evaluation:** the earlier development scores in this discussion are historical and are not a broad accuracy estimate. The retained five-case pilot received William's qualitative approval; two original coverage gaps remain. No per-case scores or missed-issue estimates were supplied. See #4899 and #5376 for current evidence and limitations.

Close when the review and CLI entry points are accepted and available to contributors. Preserve the useful rubric/skills discussion below; it does not imply approval to enable an upstream review bot.

Contributor guide

Open the contributing guide

Research direction

Read the landed guidance in AGENTS.md, STATEMENTS.md, PROOFS.md, and CONTRIBUTING.md, then follow the review work in #4899 and the CLI handoff work in #5386. Confirm that the review and CLI entry points are accepted and available to contributors; preserve the rubric discussion without enabling an upstream review bot.

Written by the indexing model from the issue text.

Assessment

Domain
cli, developer-experience, documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.