Skip to content

Remove superseded agentic-workflows examples; make example docs consistent - #142

Merged
NicholasDCole merged 1 commit into
mainfrom
chore/agentic-examples-cleanup-and-smoke-tooling
Jul 28, 2026
Merged

Remove superseded agentic-workflows examples; make example docs consistent#142
NicholasDCole merged 1 commit into
mainfrom
chore/agentic-examples-cleanup-and-smoke-tooling

Conversation

@NicholasDCole

@NicholasDCole NicholasDCole commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Cleanups following the agentspan merge (#131):

Remove examples/agentic-workflows/

The 5 hand-built LLM-system-task workflow examples are superseded by the durable agents layer — every scenario they demonstrated (tool calling, multi-agent chat, HITL, MCP) has a richer counterpart under examples/agents/. All references across README.md, examples/README.md, SDK_DEVELOPMENT.md, and SDK_NEW_LANGUAGE_GUIDE.md are repointed to the agents examples. The LLM task builders (llmChatCompleteTask etc.) remain documented — only the example folder is removed.

Documentation consistency on example counts

  • examples/agents/README.md catalog rebuilt to list all 111 core examples organized by topic — 65 were missing from the catalog after the merge, and it linked one nonexistent file (27-user-proxy-agent.ts). Verified programmatically: 111 unique links, zero broken, zero missing.
  • All agent-example count claims standardized to "200+" (previously an inconsistent mix of "60+" and stale per-directory counts).
  • Stale workflow-example counts in SDK_DEVELOPMENT.md corrected (14 core / 9 api-journeys / 8 advanced).

Related

🤖 Generated with Claude Code

@codecov

codecov Bot commented Jul 21, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Flag Coverage Δ
integration-v4-sm 41.47% <ø> (-0.07%) ⬇️
integration-v5-sdkdev 44.03% <ø> (+0.11%) ⬆️
unit 73.84% <ø> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 2 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@NicholasDCole
NicholasDCole marked this pull request as ready for review July 21, 2026 16:30
…stent

The examples/agentic-workflows/ folder (5 hand-built LLM-system-task
workflow examples) is superseded by the durable agents layer merged in
891bd06 - every scenario it demonstrated (tool calling, multi-agent chat,
HITL, MCP) has a richer counterpart under examples/agents/. Delete it and
repoint all references (README, examples/README, SDK_DEVELOPMENT,
SDK_NEW_LANGUAGE_GUIDE) to the agents examples.

Also make the docs consistent about example counts:
- examples/agents/README.md catalog rebuilt to list all 111 core examples
  (65 were missing after the merge) organized by topic; removed a broken
  link to the nonexistent 27-user-proxy-agent.ts
- all counts standardized to "200+" across README, CHANGELOG,
  SDK_DEVELOPMENT, SDK_NEW_LANGUAGE_GUIDE, and examples READMEs
- stale workflow-example counts in SDK_DEVELOPMENT fixed (14 core /
  9 api-journeys / 8 advanced)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@NicholasDCole
NicholasDCole force-pushed the chore/agentic-examples-cleanup-and-smoke-tooling branch from ea872ca to 8781a19 Compare July 21, 2026 16:31
@NicholasDCole NicholasDCole changed the title Remove superseded agentic-workflows examples; add agent-example smoke tooling Remove superseded agentic-workflows examples; make example docs consistent Jul 21, 2026
@NicholasDCole
NicholasDCole merged commit 367cf9d into main Jul 28, 2026
96 of 104 checks passed
@NicholasDCole
NicholasDCole deleted the chore/agentic-examples-cleanup-and-smoke-tooling branch July 28, 2026 20:42
ambiorix2099 added a commit that referenced this pull request Jul 29, 2026
main advanced four commits while this branch was in flight (#141, #142
touched agent examples). Two files gained AGENTSPAN_* references after the
rename sweep had already run, so they still told readers to set the
deprecated names:

  - SDK_DEVELOPMENT.md:623
  - examples/README.md:51-52

Both are outside the `README.md docs` scope the new CI grep covers, so
they would not have been caught. Worth noting the grep itself is correctly
calibrated: it matches AGENTSPAN_[A-Z] (a concrete variable name) and so
does not fire on the `AGENTSPAN_*` glob that the migration and reference
pages legitimately use.

Also resolves the rebase conflict in examples/agents/README.md, taking
main's table shape from #142 (example counts removed) with this branch's
"Conductor Quickstart" rename applied. The `agentspan deploy` CLI
invocation in that file is left as-is -- external command surface.

Re-verified post-rebase: lint 0 errors (358 warnings, unchanged), 1582
unit tests across 80 suites, lychee 508 links / 0 errors, schema verifier
green, 649 internal markdown links resolve.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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