Skip to content

chore(docs): README — model/provider recommendation (opencode go + GLM-5.3 / Kimi K3) + stale-fact fixes #490

Description

@aarontrowbridge

Important

Problem

The README's model story is stale: it recommends "Kimi K3, Muse Spark, open models" with no provider guidance, while the product strategy (per the team discussion) is to recommend an opencode go subscription + extra usage running GLM-5.3 or Kimi K3. Parsing the README also surfaced stale facts: the public-skill count (37 vs the actual 38), a skills table that lists the internal-only fleet skill and omits six shipped ones, and a terminal description predating the M4 updater (managed canonical binary + opencode-amicode shim).

Approach

Update the subtitle + models paragraph to the recommended setup (opencode go + extra usage, GLM-5.3 or Kimi K3, model-agnostic framing intact); fix the skill count and table to match packages/extension/skills/ exactly; update the Amicode-terminal sentence to the post-M4 PATH reality.

Scope

In: README.md only. Out: onboarding PROVIDER_MODELS surfacing GLM-5.3/Kimi K3 (a product-UI change, flagged as follow-up); any telaio/subscription pre-announcements.


Source

Aaron's request (2026-08-21 session) + README parse. Docs-only; no code paths touched.

Metadata

Metadata

Assignees

No one assigned

    Labels

    hitlHuman-in-the-loop — needs human review/decision

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions