Skip to content

fix: Make the docs and data say only what is true - #6

Merged
Wolfe-Jam merged 1 commit into
mainfrom
truth-fixes
Nov 12, 2026
Merged

Wolfe-Jam merged 1 commit into
mainfrom
truth-fixes

Conversation

@Wolfe-Jam

Copy link
Copy Markdown
Owner

What changed

The docs and data now say only what is true. From goose's review of the whole repository at 709d522 (report-only; findings triaged before any change).

Data

  • Origin and join dates no cited source states are gone: the join dates for A2A, agentgateway and Agent Router, and AGENTS.md's origin. OpenEnv's origin is "Hugging Face", as the Linux Foundation release says. verify no longer requires origin or joined; the panel shows only the facts that exist, under "Origin" (Agent Router's was not a contributor).
  • Two titles and a caption match their quotes: "goose extensions are based on MCP" (and the coding flow's step), and "OpenSandbox's CLI installs its skills, as SKILL.md for opencode".

Docs

  • Headline (README, project.faf): documented lines are stated by a project's docs; examples and open seams are labelled as such. Two of the 19 lines are seams and one is an example.
  • README: CI runs on pushes to main, pull requests and weekly (not every push).
  • AGENTS.md: what project.faf holds; index.html has a few sentences with counts and dates; new rule 7: origin and join date only from a cited source.
  • CONTRIBUTING: a link's two ends have no direction (the page draws no arrow); seam and label documented; the sentences to update when counts or dates change; Bun 1.3 rewrites bun.lock (git checkout bun.lock); the "Create pull request" step after "Propose new file".
  • Link issue template and the skill: two ends in any order; ids only need to be unique. PR template: a bun.lock checkbox.

Recipe and verify

  • recipes/recheck.yaml: the cache holds only git data, so search with git grep … HEAD / git show HEAD:<path>; handle a moved file and a renamed repository. goose recipe validate: valid.
  • scripts/verify.ts: a failed fetch now fails the repository check instead of passing on an old cached copy.

Checked in a browser: the A2A, AGENTS.md, OpenEnv and goose panels render with only their sourced facts, no page errors.

Source

OpenEnv's origin: the Linux Foundation release of Oct 22, 2026, already cited on the page. Everything else removes or narrows wording.

Verify

bun scripts/verify.ts: 128/128 passed

Tier 1: SOURCES (43/43)
  PASS  repository aaif/technical-committee is reachable  [ac08e71]
  PASS  repository aaif-goose/goose is reachable  [be74c34]
  PASS  repository theagentrouter/agent-router is reachable  [165733c]
  PASS  repository a2aproject/A2A is reachable  [d18aa92]
  PASS  repository agentgateway/agentgateway is reachable  [e7cac5d]
  PASS  repository openenv/OpenEnv is reachable  [ca6df26]
  PASS  repository opensandbox-group/OpenSandbox is reachable  [dc4c26e]
  PASS  repository openresponses/openresponses is reachable  [dce9ddb]
  PASS  link e-agents-goose: source file exists  [aaif-goose/goose/documentation/docs/guides/context-engineering/using-goosehints.md]
  PASS  link e-agents-goose: quote appears in source  [goose reads AGENTS.md]
  PASS  link e-skills-goose: source file exists  [aaif-goose/goose/documentation/docs/guides/context-engineering/using-skills.md]
  PASS  link e-skills-goose: quote appears in source  [goose loads Agent Skills]
  PASS  link e-goose-mcp: source file exists  [aaif-goose/goose/documentation/docs/getting-started/using-extensions.md]
  PASS  link e-goose-mcp: quote appears in source  [goose extensions are based on MCP]
  PASS  link e-goose-router: source file exists  [theagentrouter/agent-router/examples/goose/README.md]
  PASS  link e-goose-router: quote appears in source  [goose runs through Agent Router]
  PASS  link e-mcp-a2a: source file exists  [a2aproject/A2A/docs/topics/a2a-and-mcp.md]
  PASS  link e-mcp-a2a: quote appears in source  [A2A and MCP: two directions]
  PASS  link e-agw-mcp: source file exists  [agentgateway/agentgateway/README.md]
  PASS  link e-agw-mcp: quote appears in source  [agentgateway: MCP gateway]
  PASS  link e-agw-a2a: source file exists  [agentgateway/agentgateway/README.md]
  PASS  link e-agw-a2a: quote appears in source  [agentgateway: A2A gateway]
  PASS  link e-agw-models: source file exists  [agentgateway/agentgateway/README.md]
  PASS  link e-agw-models: quote appears in source  [agentgateway: LLM gateway]
  PASS  link e-router-mcp: source file exists  [theagentrouter/agent-router/README.md]
  PASS  link e-router-mcp: quote appears in source  [Agent Router reaches MCP servers]
  PASS  link e-router-models: source file exists  [theagentrouter/agent-router/README.md]
  PASS  link e-router-models: quote appears in source  [Agent Router reaches models]
  PASS  link e-router-a2a: source file exists  [theagentrouter/agent-router/site/docs/capabilities/a2a/index.md]
  PASS  link e-router-a2a: quote appears in source  [Agent Router: A2A traffic (preview)]
  PASS  link e-env-mcp: source file exists  [openenv/OpenEnv/README.md]
  PASS  link e-env-mcp: quote appears in source  [OpenEnv serves tools over MCP]
  PASS  link e-sandbox-mcp: source file exists  [opensandbox-group/OpenSandbox/README.md]
  PASS  link e-sandbox-mcp: quote appears in source  [OpenSandbox ships an MCP server]
  PASS  link e-sandbox-skills: source file exists  [opensandbox-group/OpenSandbox/cli/README.md]
  PASS  link e-sandbox-skills: quote appears in source  [OpenSandbox's CLI installs its skills, as SKILL.md for opencode]
  PASS  link e-app-responses: source file exists  [openresponses/openresponses/README.md]
  PASS  link e-app-responses: quote appears in source  [An app speaks Open Responses]
  PASS  link e-responses-models: source file exists  [openresponses/openresponses/README.md]
  PASS  link e-responses-models: quote appears in source  [Open Responses: one interface, many providers]
  PASS  link e-responses-mcp: source file exists  [openresponses/openresponses/src/specifications/2026-04-24.mdx]
  PASS  link e-responses-mcp: quote appears in source  [Open Responses names MCP as an example]
  PASS  link s-gateways: source file exists  [theagentrouter/agent-router/docs/proposals/012-mcp-tool-name-prefix-mode/proposal.md]

Tier 2: STAGES (12/12)
  PASS  technical committee project table is readable  [aaif/technical-committee/README.md]
  PASS  project count matches the committee table  [map 10, table 10]
  PASS  project skills: stage matches committee  [map Impact, committee Impact]
  PASS  project agentsmd: stage matches committee  [map Impact, committee Impact]
  PASS  project goose: stage matches committee  [map Impact, committee Impact]
  PASS  project responses: stage matches committee  [map Impact, committee Impact]
  PASS  project mcp: stage matches committee  [map Impact, committee Impact]
  PASS  project a2a: stage matches committee  [map Growth, committee Growth]
  PASS  project router: stage matches committee  [map Growth, committee Growth]
  PASS  project agw: stage matches committee  [map Growth, committee Growth]
  PASS  project sandbox: stage matches committee  [map Sandbox, committee Sandbox]
  PASS  project openenv: stage matches committee  [map Growth, committee Growth]

Tier 3: DATA (73/73)
  PASS  node ids are unique  [12 nodes]
  PASS  link ids are unique  [19 links]
  PASS  link e-agents-goose: both ends exist  [agentsmd ↔ goose]
  PASS  link e-skills-goose: both ends exist  [skills ↔ goose]
  PASS  link e-goose-mcp: both ends exist  [goose ↔ mcp]
  PASS  link e-goose-router: both ends exist  [goose ↔ router]
  PASS  link e-mcp-a2a: both ends exist  [mcp ↔ a2a]
  PASS  link e-agw-mcp: both ends exist  [agw ↔ mcp]
  PASS  link e-agw-a2a: both ends exist  [agw ↔ a2a]
  PASS  link e-agw-models: both ends exist  [agw ↔ models]
  PASS  link e-router-mcp: both ends exist  [router ↔ mcp]
  PASS  link e-router-models: both ends exist  [router ↔ models]
  PASS  link e-router-a2a: both ends exist  [router ↔ a2a]
  PASS  link e-env-mcp: both ends exist  [openenv ↔ mcp]
  PASS  link e-sandbox-mcp: both ends exist  [sandbox ↔ mcp]
  PASS  link e-sandbox-skills: both ends exist  [sandbox ↔ skills]
  PASS  link e-app-responses: both ends exist  [app ↔ responses]
  PASS  link e-responses-models: both ends exist  [responses ↔ models]
  PASS  link e-responses-mcp: both ends exist  [responses ↔ mcp]
  PASS  link s-gateways: both ends exist  [router ↔ agw]
  PASS  link s-context: both ends exist  [agentsmd ↔ skills]
  PASS  flow coding: every step names a link  [5 steps]
  PASS  flow gateway: every step names a link  [8 steps]
  PASS  flow a2a: every step names a link  [3 steps]
  PASS  flow train: every step names a link  [2 steps]
  PASS  flow model: every step names a link  [3 steps]
  PASS  project skills: required fields present  [repo, docs, stage, committee name]
  PASS  project skills: docs link is https  [https://agentskills.io]
  PASS  project skills: stage is a known stage  [Impact]
  PASS  project agentsmd: required fields present  [repo, docs, stage, committee name]
  PASS  project agentsmd: docs link is https  [https://agents.md]
  PASS  project agentsmd: stage is a known stage  [Impact]
  PASS  project goose: required fields present  [repo, docs, stage, committee name]
  PASS  project goose: docs link is https  [https://goose-docs.ai]
  PASS  project goose: stage is a known stage  [Impact]
  PASS  project responses: required fields present  [repo, docs, stage, committee name]
  PASS  project responses: docs link is https  [https://www.openresponses.org]
  PASS  project responses: stage is a known stage  [Impact]
  PASS  project mcp: required fields present  [repo, docs, stage, committee name]
  PASS  project mcp: docs link is https  [https://modelcontextprotocol.io]
  PASS  project mcp: stage is a known stage  [Impact]
  PASS  project a2a: required fields present  [repo, docs, stage, committee name]
  PASS  project a2a: docs link is https  [https://a2a-protocol.org]
  PASS  project a2a: stage is a known stage  [Growth]
  PASS  project router: required fields present  [repo, docs, stage, committee name]
  PASS  project router: docs link is https  [https://theagentrouter.ai/docs]
  PASS  project router: stage is a known stage  [Growth]
  PASS  project agw: required fields present  [repo, docs, stage, committee name]
  PASS  project agw: docs link is https  [https://agentgateway.dev/docs/standalone/latest]
  PASS  project agw: stage is a known stage  [Growth]
  PASS  project sandbox: required fields present  [repo, docs, stage, committee name]
  PASS  project sandbox: docs link is https  [https://open-sandbox.ai]
  PASS  project sandbox: stage is a known stage  [Sandbox]
  PASS  project openenv: required fields present  [repo, docs, stage, committee name]
  PASS  project openenv: docs link is https  [https://huggingface.co/docs/openenv]
  PASS  project openenv: stage is a known stage  [Growth]
  PASS  link e-agents-goose: has a repository source  [aaif-goose/goose/documentation/docs/guides/context-engineering/using-goosehints.md]
  PASS  link e-skills-goose: has a repository source  [aaif-goose/goose/documentation/docs/guides/context-engineering/using-skills.md]
  PASS  link e-goose-mcp: has a repository source  [aaif-goose/goose/documentation/docs/getting-started/using-extensions.md]
  PASS  link e-goose-router: has a repository source  [theagentrouter/agent-router/examples/goose/README.md]
  PASS  link e-mcp-a2a: has a repository source  [a2aproject/A2A/docs/topics/a2a-and-mcp.md]
  PASS  link e-agw-mcp: has a repository source  [agentgateway/agentgateway/README.md]
  PASS  link e-agw-a2a: has a repository source  [agentgateway/agentgateway/README.md]
  PASS  link e-agw-models: has a repository source  [agentgateway/agentgateway/README.md]
  PASS  link e-router-mcp: has a repository source  [theagentrouter/agent-router/README.md]
  PASS  link e-router-models: has a repository source  [theagentrouter/agent-router/README.md]
  PASS  link e-router-a2a: has a repository source  [theagentrouter/agent-router/site/docs/capabilities/a2a/index.md]
  PASS  link e-env-mcp: has a repository source  [openenv/OpenEnv/README.md]
  PASS  link e-sandbox-mcp: has a repository source  [opensandbox-group/OpenSandbox/README.md]
  PASS  link e-sandbox-skills: has a repository source  [opensandbox-group/OpenSandbox/cli/README.md]
  PASS  link e-app-responses: has a repository source  [openresponses/openresponses/README.md]
  PASS  link e-responses-models: has a repository source  [openresponses/openresponses/README.md]
  PASS  link e-responses-mcp: has a repository source  [openresponses/openresponses/src/specifications/2026-04-24.mdx]

128/128 passed
  • bun scripts/verify.ts passes
  • bunx tsc --noEmit passes
  • bun.lock is unchanged

🤖 Generated with Claude Code

- Drop origin and join dates no cited source states (A2A, agentgateway, Agent Router dates; AGENTS.md origin; OpenEnv is Hugging Face); verify no longer requires them; the panel shows "Origin" and only the facts that exist
- Headline: documented lines are stated by a project's docs; examples and seams are labelled
- CI wording: pushes to main, pull requests, weekly
- AGENTS.md: what project.faf holds; page sentences with counts and dates; rule 7 on sourcing origin and dates
- CONTRIBUTING: link ends have no direction, seam and label documented, the count and date sentences to update, Bun 1.3 rewrites bun.lock, the "Create pull request" step
- Link template and skill: two ends in any order; ids only need to be unique
- Titles and caption match their quotes (goose extensions, OpenSandbox skills)
- Recipe: search the cache with git grep/show; handle a moved file and a renamed repository
- verify: a failed fetch fails instead of passing on an old cached copy

From goose's review of the whole repository at 709d522.

Co-authored-by: goose <goose@aaif.dev>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Wolfe-Jam
Wolfe-Jam merged commit a3789c9 into main Nov 12, 2026
1 check passed
@Wolfe-Jam
Wolfe-Jam deleted the truth-fixes branch November 12, 2026 18:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant