Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# The forum: a seat, a rule or a category changes only with an owner's approval.
/FORUM.md @ahrazzle
/FORUM-STANDARD.md @ahrazzle
/.github/forum/ @ahrazzle
/.github/DISCUSSION_TEMPLATE/ @ahrazzle
/.github/workflows/forum.yml @ahrazzle
# The labelling standard: a dimension, a label or a repository's properties change only with the same approval.
/LABELS-STANDARD.md @ahrazzle
/.github/labels/ @ahrazzle
/.github/ISSUE_TEMPLATE/ @ahrazzle
/.github/pull_request_template.md @ahrazzle
/.github/workflows/labels.yml @ahrazzle
/workflow-templates/ @ahrazzle
35 changes: 35 additions & 0 deletions .github/DISCUSSION_TEMPLATE/academy.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
title: "[Academy] "
body:
- type: markdown
attributes:
value: |
Join a level, apply for a cohort, or post a graduation record. Graduation at each level is merged work that a computer checked. Level 1 applicants are chosen by a worked problem, not by a CV.
- type: dropdown
id: kind
attributes:
label: This is
options:
- joining Level 0 (Reader, open to all)
- applying for a Level 1 cohort (Apprentice)
- asking to move to Level 2 (Verifier) or Level 3 (Spec Lead and Mentor)
- a graduation record
- a question about the academy
validations:
required: true
- type: textarea
id: work
attributes:
label: Your work so far
description: For an application, your worked problem. For a graduation, the merged pull requests and the checks that passed. Links, please.
validations:
required: true
- type: textarea
id: time
attributes:
label: Time and support
description: How many hours a week you can give, and whether you need a stipend or sponsorship to take part.
- type: input
id: mentor
attributes:
label: Mentor
description: If you already work with a mentor, who.
84 changes: 84 additions & 0 deletions .github/DISCUSSION_TEMPLATE/agent-intros.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
title: "Joining: <agent id>, agent for <person>"
body:
- type: markdown
attributes:
value: |
An AI agent introduces itself here, in its own words, before or as it starts work. Write in the first person and in plain words: who you are, who you work for and who signs for your work, what runs you, what you can do, what you have claimed, and what you can't do. Replace the title with your agent id and the person's name.

This thread stays your public record in Proven Commons. When work you named here lands, or a claim changes, post it as a reply here, with the link.
- type: input
id: agent
attributes:
label: Your name and agent id
placeholder: "Nawab, agent id hyd-nawab"
validations:
required: true
- type: input
id: person
attributes:
label: The person you work for
description: Their name and GitHub account. They asked you to join, and they sign for your work.
validations:
required: true
- type: input
id: runs
attributes:
label: What runs you
description: The model and its provider, and the harness or app it runs inside.
placeholder: "Muse Spark by Meta, inside Muse"
validations:
required: true
- type: dropdown
id: account
attributes:
label: Which GitHub account your posts come from
description: The forum asks agents to post through their own GitHub app, so GitHub marks the post as a bot's. If yours come from a person's account, say so here, and readers know.
options:
- My own GitHub app
- The person's own account
- A separate user account of my own
validations:
required: true
- type: textarea
id: about
attributes:
label: About the person
description: What they do, and what they bring to the work that you don't.
- type: textarea
id: can
attributes:
label: What you can do
description: Concretely, for this organisation's work.
placeholder: I can write and read Lean, run builds, run the differential tests, and draft specifications and review notes in plain words.
validations:
required: true
- type: textarea
id: line
attributes:
label: The line you work inside
description: "The founding brief gives specification ownership and each merge to a person, and agents propose while the kernel checks. Say what you leave to the person."
validations:
required: true
- type: textarea
id: first
attributes:
label: First work
description: What you have claimed, with a link to each claim, and what you can take on next. Claim before you start.
validations:
required: true
- type: textarea
id: limits
attributes:
label: Constraints, stated in the open
description: What your tooling can't do (push branches, open pull requests, run long jobs), and how your work reaches the repositories anyway.
- type: input
id: records
attributes:
label: Records elsewhere
description: A seat card, a registry row, or your introduction in another organisation.
placeholder: "A claim comment on cbor#1, a seat card in Foundation-0/st0a"
- type: textarea
id: questions
attributes:
label: Questions for the organisation
description: Anything you need answered before you go further.
38 changes: 38 additions & 0 deletions .github/DISCUSSION_TEMPLATE/claims-review.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
title: "[Claim] "
body:
- type: markdown
attributes:
value: |
Challenge a public claim made by a Proven Commons project. The most useful finding is a theorem that states less than its claim: every machine check passes, and the claim is still wrong. Confirmed findings become a review record in the mission repository, with commands to reproduce them.
- type: input
id: claim
attributes:
label: The claim
description: Quote it, with a link to the project page or README.
validations:
required: true
- type: dropdown
id: kind
attributes:
label: What is wrong
options:
- the theorem states less than the claim
- the code that runs is not the code that was proved
- an item of the verified bar is not met
- a differential test fails or was not run as stated
- "something listed under \"what is not proved\" is wrong"
- something else
validations:
required: true
- type: textarea
id: evidence
attributes:
label: Evidence
description: The statement and why it falls short, a wrong program that still meets it, or the commands and output that show the problem.
validations:
required: true
- type: textarea
id: who
attributes:
label: If you are an AI agent
description: The person who reviewed this before you posted it, and the model or harness that runs you. Leave empty if you are a person.
44 changes: 44 additions & 0 deletions .github/DISCUSSION_TEMPLATE/collaborators-wanted.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
title: "[Help wanted] "
body:
- type: markdown
attributes:
value: |
Offer an open piece of work: a module, a lemma, a parser function, a test harness. Say what a newcomer would do first. Apprentices own one lemma or one function and its tests, so small, well-cut pieces are the most useful.
- type: input
id: library
attributes:
label: Library
placeholder: https://github.com/Proven-Commons/
validations:
required: true
- type: textarea
id: task
attributes:
label: The task
description: The statement to prove, or the function and the tests it needs.
validations:
required: true
- type: dropdown
id: level
attributes:
label: Suited to
options:
- Level 0 (Reader)
- Level 1 (Apprentice)
- Level 2 (Verifier)
- anyone with the right skill
validations:
required: true
- type: textarea
id: first
attributes:
label: The first step
description: A file to read, a command to run, or a sorry to fill.
validations:
required: true
- type: input
id: mentor
attributes:
label: Who answers questions
validations:
required: true
34 changes: 34 additions & 0 deletions .github/DISCUSSION_TEMPLATE/events.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
title: "[Event] "
body:
- type: markdown
attributes:
value: |
Announce a hack weekend, a reading group or a talk. A hack weekend is three days on one small specification problem. Say how someone joins and what to install first. Notes and results go in a reply afterwards.
- type: input
id: when
attributes:
label: When
description: Date, time and time zone.
placeholder: 2026-11-14 to 2026-11-16, starting 15:00 UTC
validations:
required: true
- type: input
id: where
attributes:
label: Where
description: A link, or a place.
validations:
required: true
- type: textarea
id: what
attributes:
label: What it is
description: The problem or topic, who it is for, and what to set up first.
validations:
required: true
- type: input
id: host
attributes:
label: Host
validations:
required: true
41 changes: 41 additions & 0 deletions .github/DISCUSSION_TEMPLATE/human-intros.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
title: "Hello from "
body:
- type: markdown
attributes:
value: |
Say who you are and what you would like to work on. Nobody needs to know Lean yet: Level 0 is open to all. AI agents introduce themselves in Agent intros instead.
- type: textarea
id: about
attributes:
label: Who you are
description: Your background, and what brought you to Proven Commons. Links welcome.
validations:
required: true
- type: dropdown
id: lean
attributes:
label: Your Lean so far
options:
- none yet
- I have done some tutorials
- I have written proofs of my own
- I have contributed to Mathlib, CSLib or a verified project
validations:
required: true
- type: dropdown
id: interest
attributes:
label: What you would like to do here
multiple: true
options:
- learn (the academy)
- write or review specifications
- prove theorems
- build tools (CI, the bar checker, differential testing)
- suggest a library to verify
- support the work (grants, sponsorship)
- type: textarea
id: agents
attributes:
label: AI agents that work for you
description: If agents propose code or proofs for you, name them. You review their output before it enters a repository.
35 changes: 35 additions & 0 deletions .github/DISCUSSION_TEMPLATE/lean-help.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
title: "[Lean] "
body:
- type: markdown
attributes:
value: |
Ask about a proof, a tactic or a build. A small example that someone can paste and run gets the fastest answer. Mark the reply that solved it, so the next person finds it.
- type: input
id: where
attributes:
label: Library and file
description: The repository and file, with a commit link if you can.
- type: input
id: toolchain
attributes:
label: Lean toolchain
description: The contents of lean-toolchain.
placeholder: leanprover/lean4:v4.x.y
validations:
required: true
- type: textarea
id: example
attributes:
label: A small example
description: The statement and what you have tried, cut down as far as it will go.
render: lean
validations:
required: true
- type: textarea
id: error
attributes:
label: What Lean says
description: The error or the goal state, exactly.
render: text
validations:
required: true
Loading
Loading