Skip to content

Simplify agent docs and bring them up to date with #2 and #3 - #4

Merged
jeremy-wayland merged 2 commits into
mainfrom
docs/simplify-agents-guide
Oct 9, 2026
Merged

jeremy-wayland merged 2 commits into
mainfrom
docs/simplify-agents-guide

Conversation

@jeremy-wayland

@jeremy-wayland jeremy-wayland commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

Rebased onto main after #2 (multiclass/multilabel) and #3 (regression) merged.

Summary

AGENTS.md: trimmed to the policy and details a model can't infer from the repo

  • Folds the tool-boundary section into one safety line: pasteur-cli is local only, and Hub I/O goes through hf.
  • Drops the intro, the doc links, and the CLI responsibilities that --help already lists.
  • Adds the patient-data upload rule ("never upload a bundle built from patient data, even to a private repo"). README.md and cli/README.md already cite AGENTS.md for this rule, but it wasn't there.
  • Notes that git worktrees must not share a CARGO_TARGET_DIR.
  • Adds --locked to the clippy/test commands, matching CI and CONTRIBUTING.md.

.agents/skills/pasteur-rs/SKILL.md: rewritten for #2 and #3

  • Adds a --task table: what truth input each task takes, how --positive-group-id works, and what --flip-threshold means per task.
  • Notes that simulate rejects --flip-threshold for classifiers.
  • Covers when flipper/ is written for regression.
  • Removes the pointer to "copy-paste workflows in AGENTS.md", which never existed. Links to cli/README.md and the docs schemas instead.

Accuracy fixes

  • cli/README.md: the predictions schema now covers the multi-output label__<class>/<model>__<class> columns and what all_agree compares for each task. Before, it said "same side of 0.5" for every task.
  • README.md: says AGENTS.md holds the rules and the skills hold the publishing workflow.

Verification

Every claim was checked against the source:

  • the flags, defaults and per-task rules in cli/src/args.rs and cli/src/commands/simulate.rs;
  • all_agree in cli/src/data/all_agree.rs;
  • the column names in cli/src/data/predictions.rs;
  • hf repos create --type dataset --private against the hf-cli skill.

All relative links resolve. cargo fmt --all --check passes. These are docs-only changes, so CI covers the rest.

🤖 Generated with Claude Code

jeremy-wayland and others added 2 commits October 9, 2026 12:15
Keep policy and non-obvious dev commands; drop redundant tool-boundary detail and doc links.

Co-authored-by: Cursor <cursoragent@cursor.com>
- AGENTS.md: state the patient-data upload rule that README.md and
  cli/README.md point to; add --locked to match CI and CONTRIBUTING.md.
- pasteur-rs skill: cover --task (multiclass, multilabel, regression),
  --targets and the regression cutoff; drop the link to AGENTS.md
  workflows that never existed there.
- cli/README.md: describe multi-output predictions columns and what
  all_agree compares per task.
- README.md: point to AGENTS.md for rules, skills for the workflow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jeremy-wayland
jeremy-wayland force-pushed the docs/simplify-agents-guide branch from 4c1686f to bb344eb Compare October 9, 2026 12:17
@jeremy-wayland jeremy-wayland changed the title Simplify AGENTS.md for capable models Simplify agent docs and bring them up to date with #2 and #3 Oct 9, 2026
@jeremy-wayland
jeremy-wayland merged commit 5977b28 into main Oct 9, 2026
9 checks passed
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