docs

[thorrester]

Pull Request

Short Summary

Adds potato_spec integration tests covering all SpecLoader code paths (parallel workflow, DAG workflow, file loading, accessor None paths) and a new from-spec.md doc page covering the full YAML spec format for agents and workflows. Bumps workspace version from 0.19.1 to 0.20.0.

Context

Integration test coverage — potato_spec had zero integration tests against the mock server. The existing tests in crates/potato_spec/tests/load_spec.rs only parsed YAML into structs; no test exercised the actual agent/workflow construction pipeline. Eight tests now live in crates/baked_potato/tests/agent/spec_test.rs, covering: single-agent execution, sequential workflow, parallel workflow (the path through build_parallel and LoadedSpec::parallel was completely untested), DAG workflow via Workflow::run(None), missing-model error via SpecError::WorkflowBuild, file-based loading via from_spec_path, SpecError::Io for a nonexistent path, and None returns for all four accessors on an unknown ID.

To wire this in, potato-spec was added as a dependency of baked-potato (test-only crate, not published).

Documentation — from-spec.md covers the full YAML format: agent fields, memory config, completion criteria, tool registration, callback hooks, and all three workflow types (sequential with pass_output, parallel with merge_strategy, DAG with tasks/dependencies). Includes a full end-to-end Rust example and a LoadedSpec accessor reference table. Added to the MkDocs nav under Rust Agents and cross-linked from overview.md.

File	Change
crates/baked_potato/Cargo.toml	Add potato-spec dependency
crates/baked_potato/tests/agent/mod.rs	Register spec_test module in alphabetical position
crates/baked_potato/tests/agent/spec_test.rs	8 new integration tests (new file, 254 lines)
crates/baked_potato/tests/agent/fixtures/spec.yaml	Fixture for from_spec_path test
py-potato/docs/docs/agents/from-spec.md	New doc page: full YAML spec reference (269 lines)
py-potato/docs/docs/agents/overview.md	Add From Spec row to component table; bump version to 0.20
py-potato/mkdocs.yml	Add From Spec nav entry
Cargo.toml / Cargo.lock / py-potato/pyproject.toml / py-potato/uv.lock	Version bump 0.19.1 → 0.20.0

Is this a Breaking Change?

No. No public API signatures, config formats, or serialization contracts changed. The version bump is a workspace-level increment; all existing callers of SpecLoader, LoadedSpec, and the workflow types are unaffected.

---

[devin-ai-integration]

✅ Devin Review: No Issues Found

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

View in Devin Review to see 2 additional findings.