From c64ddecb18186406e170dff46572d2967837dcd0 Mon Sep 17 00:00:00 2001 From: Val Vladescu Date: Wed, 8 Apr 2026 16:09:20 +0300 Subject: [PATCH] docs: drop private internal dispatcher links from README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The "Inspired by" callout and the orchestration matrix paragraph both linked to a private internal design doc (spec 009) by name. The attribution to Fabian's One-Shot Shop study and the operational description of what spec 009 contains stay in place; the private URL is removed. Adds a short "What 'spec 009' means here" section that inlines the field vocabulary so readers don't need to chase a 404. The normative source is now Axiom §17 (public). --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d3be943..4f9deda 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,6 @@ Works against any OpenAI-compatible endpoint — vLLM, TGI, OpenAI, Ollama, LMSt > ([announcement](https://www.linkedin.com/posts/fabian-wesner_oneshotshop-share-7442096217976897536-SRI9/)) — > the study that showed orchestration architecture beats model choice (Team Mode 85% vs Sub-Agents 57% on the same model). > Pawbench's orchestration × complexity matrix operationalizes that finding inside a reproducible benchmark. -> See [spec 009](https://github.com/zenprocess/switchyard/blob/main/specs/009-pawbench-orchestration-axis/spec.md).
@@ -113,7 +112,11 @@ pawbench --verification-runs 2 pawbench --no-quality-analysis ``` -The orchestration matrix scenario (`pawstyle-orchestration-matrix`) is designed to differentiate shapes — four independent feature blocks, one per complexity tier. Inspired by Fabian Wesner's [One-Shot Shop Challenge](https://agentic-engineers.dev) (orchestration > model). See [switchyard spec 009](https://github.com/zenprocess/switchyard/blob/main/specs/009-pawbench-orchestration-axis/spec.md). +The orchestration matrix scenario (`pawstyle-orchestration-matrix`) is designed to differentiate shapes — four independent feature blocks, one per complexity tier. Inspired by Fabian Wesner's [One-Shot Shop Challenge](https://agentic-engineers.dev) (orchestration > model). + +### What "spec 009" means here + +The implementation follows an internal design doc colloquially called "spec 009" that defines the orchestration shape vocabulary, complexity tier vocabulary, the `fixture_gap` terminal status, `verification_runs[]`, and `artifact_quality` schema. The vocabularies are normative in [Axiom §17](https://github.com/zenprocess/axiom/blob/main/spec.md); Pawbench is the reference implementation.