From a33622bdf1270739e241fafc17f1fde2d32c9627 Mon Sep 17 00:00:00 2001 From: JackChen Date: Mon, 20 Apr 2026 15:51:18 +0800 Subject: [PATCH] chore(examples): introduce cookbook/ and move meeting-summarizer (#140) patterns/ is for orchestration primitives (fan-out, handoff, retry, etc.). Use-case-driven examples like meeting-summarizer fit better in a new cookbook/ bucket, positioned between patterns/ and production/ in acceptance bar. meeting-summarizer.ts relocated; paths stay valid since directory depth is unchanged. --- examples/README.md | 12 ++++++++++-- .../{patterns => cookbook}/meeting-summarizer.ts | 0 2 files changed, 10 insertions(+), 2 deletions(-) rename examples/{patterns => cookbook}/meeting-summarizer.ts (100%) diff --git a/examples/README.md b/examples/README.md index 5109f74..a2cf8ba 100644 --- a/examples/README.md +++ b/examples/README.md @@ -44,7 +44,14 @@ Reusable shapes for common multi-agent problems. | [`patterns/multi-perspective-code-review`](patterns/multi-perspective-code-review.ts) | Multiple reviewer agents in parallel, then synthesis. | | [`patterns/research-aggregation`](patterns/research-aggregation.ts) | Multi-source research collated by a synthesis agent. | | [`patterns/agent-handoff`](patterns/agent-handoff.ts) | Synchronous sub-agent delegation via `delegate_to_agent`. | -| [`patterns/meeting-summarizer`](patterns/meeting-summarizer.ts) | Fan-out post-processing of a transcript into summary, structured action items, and sentiment. | + +## cookbook — use-case recipes + +End-to-end examples framed around a concrete problem (meeting summarization, translation QA, competitive monitoring, etc.) rather than a single orchestration primitive. Lighter bar than `production/`: no tests or pinned model versions required. Good entry point if you want to see how the patterns compose on a real task. + +| Example | Problem solved | +|---------|----------------| +| [`cookbook/meeting-summarizer`](cookbook/meeting-summarizer.ts) | Fan-out post-processing of a transcript into summary, structured action items, and sentiment. | ## integrations — external systems @@ -68,8 +75,9 @@ End-to-end examples wired to real workflows. Higher bar than the categories abov |----------------|----------|----------| | A new model provider | `providers/` | `.ts` (lowercase, hyphenated) | | A reusable orchestration pattern | `patterns/` | `.ts` | +| A use-case-driven example (problem-first, uses one or more patterns) | `cookbook/` | `.ts` | | Integration with an outside system (MCP server, observability backend, framework, app) | `integrations/` | `.ts` or `/` for multi-file | -| A real-world end-to-end use case | `production/` | `/` directory with its own README | +| A real-world end-to-end use case, production-grade | `production/` | `/` directory with its own README | Conventions: diff --git a/examples/patterns/meeting-summarizer.ts b/examples/cookbook/meeting-summarizer.ts similarity index 100% rename from examples/patterns/meeting-summarizer.ts rename to examples/cookbook/meeting-summarizer.ts