Skip to content

Docs: fill in README and add task.md spec#1

Open
xdotli wants to merge 5 commits into
mainfrom
docs/readme-and-spec
Open

Docs: fill in README and add task.md spec#1
xdotli wants to merge 5 commits into
mainfrom
docs/readme-and-spec

Conversation

@xdotli

@xdotli xdotli commented Jun 8, 2026

Copy link
Copy Markdown
Member

Fills in the public repo so the GitHub link from the site lands on real docs instead of a stub.

  • README.md — project overview: what PostTrain Arena is, how it works (contribute → post-train → score → rank), the eight domains, how to contribute a task (the four-piece submission), validate locally with the bench CLI, and submit.
  • SPEC.md — the full task.md authoring reference, mirrored from posttrain.com/docs/spec (frontmatter schema, body sections, environment/verifier/oracle contracts, local validation).

All links point to posttrain.com and this repo; no external hub references.


Note

Low Risk
Documentation-only changes with no runtime, auth, or application code touched.

Overview
Replaces the repo’s one-line README stub with a full PostTrain Arena landing page: what the competition is, contribute → post-train → IndexBench → rank, the eight category domains, the four-piece task layout under tasks/, local validation via bench tasks check, PR submission expectations, and links to the site, catalog, and Discord.

Adds SPEC.md as the in-repo task.md authoring reference: directory layout, frontmatter schema 1.3, body sections, environment/ (including multi-container compose), verifier/ strategies and reward artifacts, oracle/, and bench CLI levels from schema through publication-grade/acceptance.

Reviewed by Cursor Bugbot for commit e25223e. Bugbot is set up for automated code reviews on this repo. Configure here.

Replace the stub README with a clear project overview — what PostTrain
Arena is, how it works, the eight domains, how to contribute, validate,
and submit. Add SPEC.md mirroring the full task.md authoring reference
from posttrain.com/docs/spec.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

xdotli added 4 commits June 8, 2026 15:22
Update to the current native task.md format: schema_version 1.3 (was
version 1.0), /app workspace (was /root), verifier strategy model
(script / llm-judge / agent-judge / reward-kit), reward at
/logs/verifier/reward.txt, and the bench tasks init/normalize/check CLI
with the full level set. Drop the stale verifier.md 0.3 schema and the
cp-template scaffold.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant