feature/Starter-reference-drift · L-260913-84dd45 — stale picture of the Python starter

[lchoquel]

The scaffold and integrate references described pipelex-starter-python before its hosted-codegen and agent-surface work. They said `make codegen` needs a `pipelex` CLI, which sent the integrate skill down the workshop fallback when the starter's own generator would have worked, and they knew nothing of `method.json`, `make add-method`, `AGENTS.md` or `docs/add-method.md`. They now match the starter's dev. The workshop fallback branches on a key reaching the project, the generated paths use the underscored module name, and tests pin both. The references describe the starter's dev while scaffolding clones its main, so this is accurate for new projects once the starter's next release is cut.

Closes L-260913-84dd45

🤖 Generated with Claude Code

https://claude.ai/code/session_01AcWGJs6kVUxGzHEKShjbFj

---

Summary by cubic

Updates the scaffold and integrate references to match the current pipelex-starter-python, so the integrate skill stops taking the workshop fallback when the starter's own generator would work.

Bug Fixes

• make codegen now regenerates through the hosted API with pipelex-sdk and needs only PIPELEX_API_KEY; the workshop fallback branches on a missing key instead of a missing pipelex CLI.
• A method directory can hold a method.json (exactly one of method_id / method_ref) instead of a bundle, and make add-method scaffolds it.
• Generated directories and model imports use the underscored module name (summarize-pdf → summarize_pdf), never the dashed name.
• References now list AGENTS.md, docs/add-method.md, and the CLI_INPUTS entry that make agent-test requires.
• Tests pin the new wording and forbid the old pipelex CLI branching.

The references describe the starter's dev branch, so they are accurate for new projects once the starter's next release is cut.

Closes L-260913-84dd45

^{Written for commit 62709d8. Summary will update on new commits.}