Skip to content

docs(generation-benchmark): describe the generation experiment - #160

Draft
bcleary-nv wants to merge 13 commits into
mainfrom
feat/generation-benchmark-docs
Draft

bcleary-nv wants to merge 13 commits into
mainfrom
feat/generation-benchmark-docs

Conversation

@bcleary-nv

@bcleary-nv bcleary-nv commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  1. Experiment design - describe generation as a coverage experiment stacked on the metric benchmark
  2. Adapter contract - name the request, response, draft path, and coverage work cell
  3. Operator docs - document the benchmark files, stages, and commands
  4. Work-cell paths - use input/tasks/ and output/tasks-generated/ instead of subset notation

2 commits on branch feat/generation-benchmark-docs.

Stacked on #96 (feat/metric-benchmark-coverage).

What changed

6 files. Design only. The driver and adapters are in #161.

Path Role
labs/generation-benchmark/README.md Experiment overview and stage list
labs/generation-benchmark/docs/architecture.md Actors, adapter contract, artifacts
labs/generation-benchmark/docs/stages.md Stage inputs and outputs
labs/generation-benchmark/docs/benchmark-format.md Experiment files, including draft_dir
labs/generation-benchmark/docs/tools.md Driver and adapter commands
labs/generation-benchmark/docs/assets/experiment-flow.svg Stage flow diagram

request.json carries the subset score and the staged paths input/tasks/, input/coverage/, and output/tasks-generated/. response.json returns the new task ids and the suite digest. The reference adapter reads authored/audit.md and report.json from the coverage work cell. The driver does not.

G, A, and C are defined once. The pinned generator_config is where C is configured. The example config is what pins Codex.

Commit summary

Commits

SHA Description
4c2406d docs: keep subset notation out of the work-cell paths
0840519 docs: describe the generation experiment

Commit 4c2406d -- docs: keep subset notation out of the work-cell paths:

  • Define G, A, and C once, under Definitions
  • Say the example generator_config is what pins Codex
  • Name the staged directories input/tasks/ and output/tasks-generated/

Commit 0840519 -- docs: describe the generation experiment:

  • Add the generation benchmark design docs and flow diagram
  • Record the stage flow, draft_dir, and the request/response adapter contract

Checklist

  • Links to a ticket
  • Has an assignee
  • Has reviewers
  • Has tests
  • Pipeline passes
  • All discussions resolved
  • Documentation updated

AI-assisted draft.

Rebased onto the refreshed #96 after #157 merged; documentation patches unchanged.

@mstaats-nvidia
mstaats-nvidia force-pushed the feat/generation-benchmark-docs branch from bf65b7a to 5a07a70 Compare October 30, 2026 21:38
Clarify when scoring can omit executable inputs and document unsigned iteration.

Signed-off-by: mstaats <mstaats@nvidia.com>
Signed-off-by: mstaats <mstaats@nvidia.com>
@mstaats-nvidia
mstaats-nvidia force-pushed the feat/generation-benchmark-docs branch from 5a07a70 to 2fefc92 Compare October 31, 2026 10:09
Signed-off-by: mstaats <mstaats@nvidia.com>
@mstaats-nvidia
mstaats-nvidia force-pushed the feat/generation-benchmark-docs branch from 2fefc92 to d3038a6 Compare October 31, 2026 11:33
mstaats-nvidia and others added 7 commits October 31, 2026 11:34
Signed-off-by: mstaats <mstaats@nvidia.com>
…tifacts

Signed-off-by: mstaats <mstaats@nvidia.com>
Signed-off-by: mstaats <mstaats@nvidia.com>
Signed-off-by: mstaats <mstaats@nvidia.com>
Record the stage flow, adapter contract, and benchmark files so the implementation can follow one design.

Signed-off-by: Brian Cleary <bcleary@nvidia.com>
… paths

Name the staged directories input/tasks and output/tasks-generated, define the actors once, and say the example generator config is what pins Codex.

Signed-off-by: Brian Cleary <bcleary@nvidia.com>
Match the metric benchmark, which uses .yml for its YAML files.

Signed-off-by: Brian Cleary <bcleary@nvidia.com>
@mstaats-nvidia
mstaats-nvidia force-pushed the feat/generation-benchmark-docs branch from d3038a6 to 0ae9311 Compare October 31, 2026 11:36
Base automatically changed from feat/metric-benchmark-coverage to main October 31, 2026 12:31

This branch has not been deployed

No deployments
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.

2 participants