Skip to content

Commit e4f25d6

Browse files
bokelleyclaude
andcommitted
docs(proposals): clarify scope of evidence in #502 revision
The architectural claim (recipe is adopter-owned; framework types, doesn't cache) is general. The empirical evidence in examples/recipe_falsification/ is GAM-specific by construction — validates GAMRecipe against GAM's implementation_config, not other adopter shapes. Added explicit scope note to the top-level revision callout so reviewers don't read the change as GAM-only thinking. Multi-adopter validation (LinkedIn, Meta, TikTok, Prebid multi-decisioning) is future work that would tighten Q2 across more shapes; the general architecture claim doesn't wait on it. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 7f4c622 commit e4f25d6

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

docs/proposals/product-architecture.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,20 @@ because the conceptual gap surfaced during the Python migration story.
2828
> reflect that the framework **types the recipe contract** but does
2929
> not **manage recipe storage**. Sections marked "Revision (post-
3030
> experiment)" or "(revised)" carry the corrections.
31+
>
32+
> **Scope of evidence behind this revision.** The architectural claim
33+
> ("recipe is adopter-owned; framework types, doesn't cache") is
34+
> general — it came from a salesagent reading but applies to any
35+
> adopter's data model. The empirical evidence in
36+
> [`examples/recipe_falsification/`](../../examples/recipe_falsification/)
37+
> is GAM-specific: it validates that a typed `GAMRecipe` carries
38+
> GAM's `implementation_config` shape without escape hatches. It
39+
> does NOT validate `LinkedInRecipe`, `MetaRecipe`, `KevelRecipe`, or
40+
> any other adopter shape. Multi-adopter validation (against the
41+
> agentic-adapters reference codebases for social shapes, against a
42+
> Prebid-style multi-decisioning adopter, etc.) is future work — it
43+
> would tighten Q2 across more shapes. The general architecture
44+
> claim doesn't wait on it.
3145
3246
## Motivation
3347

0 commit comments

Comments
 (0)