Docs site pivot + reduction + link cleanup (Memo 142)

astro.config.mjs

@@ -135,23 +135,24 @@ export default defineConfig({
         '/concepts/agents-overview/':    '/concepts/primitives/',
         '/de/concepts/agents-overview/': '/de/concepts/primitives/',
 
-        '/docs/usage/cli/':              '/reference/cli/',
-        '/docs/usage/mcp-server/':       '/reference/mcp-server/',
+        // Memo 142: Reference section removed; legacy URLs repoint to surviving pages.
+        '/docs/usage/cli/':              '/quickstart/quickstart/',
+        '/docs/usage/mcp-server/':       '/specification/mcp-integration/',
 
         '/docs/guides/schema-creation/':    '/guides/schema-creation/',
         '/docs/guides/examples/':           '/guides/examples/',
         '/docs/guides/server-integration/': '/guides/server-integration/',
 
-        '/docs/reference/core-methods/':    '/reference/core-methods/',
-        '/docs/reference/cli-reference/':   '/reference/cli/',
-        '/reference/cli-reference/':        '/reference/cli/',
-        '/de/reference/cli-reference/':     '/de/reference/cli/',
-        '/docs/reference/troubleshooting/': '/about/faq/',
-        '/reference/troubleshooting/':      '/about/faq/',
-        '/de/reference/troubleshooting/':   '/de/about/faq/',
+        '/docs/reference/core-methods/':    '/quickstart/quickstart/',
+        '/docs/reference/cli-reference/':   '/quickstart/quickstart/',
+        '/reference/cli-reference/':        '/quickstart/quickstart/',
+        '/de/reference/cli-reference/':     '/de/quickstart/quickstart/',
+        '/docs/reference/troubleshooting/': '/about/',
+        '/reference/troubleshooting/':      '/about/',
+        '/de/reference/troubleshooting/':   '/de/about/',
 
-        '/docs/ecosystem/agentprobe/':      '/ecosystem/agentprobe/',
-        '/docs/ecosystem/x402/':            '/ecosystem/x402/',
+        '/docs/ecosystem/agentprobe/':      '/specification/overview/',
+        '/docs/ecosystem/x402/':            '/specification/overview/',
 
         '/docs/specification/overview/':            '/specification/overview/',
         '/docs/specification/schema-format/':       '/specification/schema-format/',
@@ -166,7 +167,7 @@ export default defineConfig({
         '/docs/specification/migration/':           '/specification/migration/',
         '/docs/specification/security/':            '/specification/security/',
         '/docs/specification/output-schema/':       '/specification/output-schema/',
-        '/docs/specification/route-tests/':         '/specification/route-tests/',
+        '/docs/specification/route-tests/':         '/specification/tests/',
         '/docs/specification/preload/':             '/specification/preload/',
         '/docs/specification/groups-prompts/':      '/specification/groups-prompts/',
         '/docs/specification/tests/':               '/specification/tests/',
@@ -181,12 +182,12 @@ export default defineConfig({
         '/de/introduction/about/': '/de/about/',
         '/introduction/why/': '/about/',
         '/de/introduction/why/': '/de/about/',
-        '/introduction/faq/': '/about/faq/',
-        '/de/introduction/faq/': '/de/about/faq/',
+        '/introduction/faq/': '/about/',
+        '/de/introduction/faq/': '/de/about/',
 
-        // PRD-015: License & ToS FAQ → Schemas & Sources (Memo 060 Phase 4)
-        '/license-faq/':    '/schemas-and-sources/',
-        '/de/license-faq/': '/de/schemas-and-sources/',
+        // PRD-015 (Memo 060) → Memo 142: License & ToS FAQ now points to the spec license page.
+        '/license-faq/':    '/specification/license-and-tos/',
+        '/de/license-faq/': '/de/specification/license-and-tos/',
     },
     integrations: [
         starlight({
@@ -243,11 +244,9 @@ export default defineConfig({
                     translations: { de: 'Ueber FlowMCP' },
                     collapsed: true,
                     items: [
+                        // Memo 142 (REMOVE): FAQ, Use Cases, Schemas & Sources moved to
+                        // .trash/memo-142-reduction (default-out reduction principle).
                         { label: 'About FlowMCP', translations: { de: 'Ueber FlowMCP' }, slug: 'about' },
-                        { label: 'FAQ', translations: { de: 'Haeufige Fragen' }, slug: 'about/faq' },
-                        { label: 'Use Cases', translations: { de: 'Anwendungsfaelle' }, slug: 'introduction/use-cases' },
-                        // Memo 060 PRD-016 (LM1): For LLMs verschoben von About-Gruppe nach Get Started.
-                        { label: 'Schemas & Sources', translations: { de: 'Schemas & Quellen' }, slug: 'schemas-and-sources' },
                     ],
                 },
                 // Memo 059 PRD-011: Quickstart + Guides merged into "Get Started" (B3/B7).
@@ -261,11 +260,9 @@ export default defineConfig({
                     collapsed: true,
                     items: [
                         // Memo 060 PRD-016 (QS3): "Quickstart" -> "CLI Setup" (DE bewusst englisch, analog "Tag Search").
+                        // Memo 142 (REMOVE): Hackathon Kit, Agent Creation, GTFS Pilot -> .trash/memo-142-reduction.
                         { label: 'CLI Setup', translations: { de: 'CLI Setup' }, slug: 'quickstart/quickstart' },
                         { label: 'For LLMs', translations: { de: 'Fuer LLMs' }, slug: 'introduction/for-llms' },
-                        { label: 'Hackathon Kit', translations: { de: 'Hackathon-Kit' }, slug: 'guides/hackathon-kit' },
-                        { label: 'Agent Creation', translations: { de: 'Agent-Erstellung' }, slug: 'guides/agent-creation' },
-                        { label: 'GTFS Pilot', translations: { de: 'GTFS-Pilot' }, slug: 'guides/gtfs-pilot' },
                     ],
                 },
                 // Memo 060 PRD-007 (Phase 2): Concepts reduziert auf 4 Eintraege
@@ -293,43 +290,11 @@ export default defineConfig({
                 ...gradingGroup,
                 // Memo 108: Best Practice nav group (advisory track) + badge.
                 ...bestPracticeGroup,
-                {
-                    label: 'Reference',
-                    translations: { de: 'Referenz' },
-                    collapsed: true,
-                    items: [
-                        { label: 'CLI Usage', translations: { de: 'CLI-Nutzung' }, slug: 'reference/cli' },
-                        { label: 'Programmatic API', translations: { de: 'Programmatic API' }, slug: 'reference/core-methods' },
-                        { label: 'MCP Server Mode', translations: { de: 'MCP Server Mode' }, slug: 'reference/mcp-server' },
-                    ],
-                },
-                {
-                    label: 'Ecosystem',
-                    translations: { de: 'Oekosystem' },
-                    collapsed: true,
-                    // Memo 064 Phase 4 PRD-011: badge objects replaced by
-                    // parenthesis qualifiers in the label text (no badge styling).
-                    items: [
-                        {
-                            label: 'AgentProbe (External)',
-                            translations: { de: 'AgentProbe (External)' },
-                            slug: 'ecosystem/agentprobe',
-                        },
-                        {
-                            label: 'x402 (Experimental)',
-                            translations: { de: 'x402 (Experimental)' },
-                            slug: 'ecosystem/x402',
-                        },
-                        // Memo 064 Phase 4 PRD-011: third ecosystem element.
-                        // geo-gtfs-toolkit has no dedicated ecosystem page yet —
-                        // link to the existing in-site GTFS Pilot guide.
-                        {
-                            label: 'GTFS (Add-on)',
-                            translations: { de: 'GTFS (Add-on)' },
-                            slug: 'guides/gtfs-pilot',
-                        },
-                    ],
-                },
+                // Memo 142 (REMOVE): the whole "Reference" (CLI/Programmatic API/MCP
+                // Server Mode) and "Ecosystem" (AgentProbe/x402/GTFS) nav groups are
+                // removed; their pages moved to .trash/memo-142-reduction. FlowMCP is a
+                // format/specification — the add-on/ecosystem surface is the Drumherum,
+                // not the core message.
                 // Memo 064 Phase 4 PRD-011: lone top-level Blog sidebar entry
                 // removed. Blog has its own /blog/ section (BlogIndexLayout).
                 // Memo 059 PRD-011 (B4/B5): Roadmap + Team removed from sidebar.

public/spec-generated/docs-payload/00-overview.md

@@ -6,9 +6,9 @@ spec_file: "00-overview.md"
 order: 0
 section: "Specification"
 normative: false
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/00-overview.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/00-overview.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/00-overview.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/00-overview.md."

public/spec-generated/docs-payload/01-schema-format.md

@@ -6,9 +6,9 @@ spec_file: "01-schema-format.md"
 order: 1
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/01-schema-format.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/01-schema-format.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/01-schema-format.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/01-schema-format.md."

public/spec-generated/docs-payload/02-parameters.md

@@ -6,9 +6,9 @@ spec_file: "02-parameters.md"
 order: 2
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/02-parameters.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/02-parameters.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/02-parameters.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/02-parameters.md."

public/spec-generated/docs-payload/03-shared-lists.md

@@ -6,9 +6,9 @@ spec_file: "03-shared-lists.md"
 order: 3
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/03-shared-lists.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/03-shared-lists.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/03-shared-lists.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/03-shared-lists.md."

public/spec-generated/docs-payload/04-output-schema.md

@@ -6,9 +6,9 @@ spec_file: "04-output-schema.md"
 order: 4
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/04-output-schema.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/04-output-schema.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/04-output-schema.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/04-output-schema.md."

public/spec-generated/docs-payload/05-security.md

@@ -6,9 +6,9 @@ spec_file: "05-security.md"
 order: 5
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/05-security.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/05-security.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/05-security.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/05-security.md."

public/spec-generated/docs-payload/06-agents.md

@@ -6,9 +6,9 @@ spec_file: "06-agents.md"
 order: 6
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/06-agents.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/06-agents.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/06-agents.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/06-agents.md."

public/spec-generated/docs-payload/07-tasks.md

@@ -6,9 +6,9 @@ spec_file: "07-tasks.md"
 order: 7
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/07-tasks.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/07-tasks.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/07-tasks.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/07-tasks.md."

public/spec-generated/docs-payload/08-migration.md

@@ -6,9 +6,9 @@ spec_file: "08-migration.md"
 order: 8
 section: "Specification"
 normative: false
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/08-migration.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/08-migration.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/08-migration.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/08-migration.md."

public/spec-generated/docs-payload/09-validation-rules.md

@@ -6,9 +6,9 @@ spec_file: "09-validation-rules.md"
 order: 9
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/09-validation-rules.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/09-validation-rules.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/09-validation-rules.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/09-validation-rules.md."

public/spec-generated/docs-payload/10-tests.md

@@ -6,9 +6,9 @@ spec_file: "10-tests.md"
 order: 10
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/10-tests.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/10-tests.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/10-tests.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/10-tests.md."

public/spec-generated/docs-payload/11-preload.md

@@ -6,9 +6,9 @@ spec_file: "11-preload.md"
 order: 11
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/11-preload.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/11-preload.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/11-preload.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/11-preload.md."

public/spec-generated/docs-payload/12-prompt-architecture.md

@@ -6,9 +6,9 @@ spec_file: "12-prompt-architecture.md"
 order: 12
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/12-prompt-architecture.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/12-prompt-architecture.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/12-prompt-architecture.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/12-prompt-architecture.md."

public/spec-generated/docs-payload/13-resources.md

@@ -6,9 +6,9 @@ spec_file: "13-resources.md"
 order: 13
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/13-resources.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/13-resources.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/13-resources.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/13-resources.md."

public/spec-generated/docs-payload/14-skills.md

@@ -6,9 +6,9 @@ spec_file: "14-skills.md"
 order: 14
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/14-skills.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/14-skills.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/14-skills.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/14-skills.md."

public/spec-generated/docs-payload/15-catalog.md

@@ -6,9 +6,9 @@ spec_file: "15-catalog.md"
 order: 15
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/15-catalog.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/15-catalog.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/15-catalog.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/15-catalog.md."

public/spec-generated/docs-payload/16-id-schema.md

@@ -6,9 +6,9 @@ spec_file: "16-id-schema.md"
 order: 16
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/16-id-schema.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/16-id-schema.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/16-id-schema.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/16-id-schema.md."

public/spec-generated/docs-payload/17-selections.md

@@ -6,9 +6,9 @@ spec_file: "17-selections.md"
 order: 17
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/17-selections.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/17-selections.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/17-selections.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/17-selections.md."

public/spec-generated/docs-payload/18-prefill.md

@@ -6,9 +6,9 @@ spec_file: "18-prefill.md"
 order: 18
 section: "Specification"
 normative: true
-source_commit: "236dbb3"
-source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/236dbb3/spec/v4.3.0/18-prefill.md"
-generated_at: "2026-06-21T11:44:44.465Z"
+source_commit: "42b4603"
+source_url: "https://github.com/FlowMCP/flowmcp-spec/blob/42b4603/spec/v4.3.0/18-prefill.md"
+generated_at: "2026-06-21T01:06:21.418Z"
 generated_from: "spec/v4.3.0/18-prefill.md"
 generator: "scripts/generate-docs-payload.mjs"
 edit_warning: "This file is auto-generated. Source: spec/v4.3.0/18-prefill.md."