Files
pydantic-ai-harness/agent_docs
24fd30e70c docs: stale-PR re-eval, experimental-export, and background-coder review guidance (#288)
* docs: add stale-PR re-eval, experimental-export, and consumer-lens guidance

Adopting a months-old PR (#243) surfaced three gaps in the AICA review/authoring
guides:

- no discipline for re-evaluating a stale or pre-merge PR (retire temporary
  uv.sources pins once upstream lands; re-check drift vs current main)
- the experimental-vs-top-level export convention was undocumented, so the
  code_mode exemplar steered new-capability authors toward top-level exports
- the review checklist named "dogfooding need" but no reference consumer or the
  cache/cost/reliability lens a long-running background coder cares about

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: key export-stability rule on shipped-in-release, not on a symbol list

Only CodeMode has shipped in a published release (v0.3.0 exports just CodeMode);
FileSystem, ManagedPrompt, and Shell are top-level on main but pre-release. The
earlier wording labeled all four "already-released", which is inaccurate.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: drop the reference-consumer lens bullet

Keep the two clearest gaps (stale-PR re-eval, experimental-vs-released exports);
drop the consumer-lens addition, which named pydanty (a separate repo) in the
harness review checklist and was the most likely to read as out-of-place.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: David SF <david.sanchez@pydantic.dev>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 17:15:54 -05:00
..