Skip to content

skill trimming: rewrite core skills and stream-react - #71

Open
myandrienko wants to merge 3 commits into
mainfrom
v2-core-skills
Open

skill trimming: rewrite core skills and stream-react#71
myandrienko wants to merge 3 commits into
mainfrom
v2-core-skills

Conversation

@myandrienko

Copy link
Copy Markdown
Collaborator

What

Replaces the four core skills with the v2 fresh-write: stream and stream-react are rewritten from zero; stream-builder and stream-docs are deleted. Net: 919 insertions, 9,624 deletions.

The rewrite applies one deletion criterion to every line: it survives only if it prevents a failure an agent actually hits. Everything the getstream CLI explains itself (-h, getstream docs local copies), everything the official docs cover, and everything a competent agent infers on its own was removed.

Changes

  • stream - a ~400-word router: conceptual overview, the CLI as the base tool ("read -h" replaces the command table and safety rules), one first-match routing list. RULES.md, peers.yaml + schema, the track dispatch table, the verbatim /stream menu, and the trust/consent prose are gone.
  • stream-react - one linear build flow (init, scaffold, credentials, SDKs, configure, build, verify, run) with conditional clauses instead of tracks, plus separate sections for auditing, upgrading an SDK major, matching a reference design, building an AI support agent, and migrating from Sendbird. Product blueprints and docs-map.md are replaced by the CLI-served local docs; the curated Sendbird mapping is kept nearly whole (concrete API joins are the knowledge), the extended mapping verbatim as a grep-only lookup.
  • stream-builder - deleted. It was a near-clone ancestor of stream-react (same Steps 0-7, also scaffolds Next.js). Unique content was salvaged: the use-case table, hub-first page flow, and the AI-support-agent recipe (now stream-react/ai-support-agent.md).
  • stream-docs - deleted. Docs questions route to the local docs via getstream docs.

Verification

Five independent empty-context agents audited v1 against v2, testing every absent idea for recoverability by actually running getstream -h and reading the local docs pages. Result: ~85-90% of distinct v1 ideas present or verified recoverable; the ~16 real losses were each restored (enhance-mode rules, capability-debugging traps, fixture-channel recipe, the AI recipe, livestream/design gotchas) or explicitly ruled out.

Deliberately out of scope (follow-ups)

  • Root README.md / AGENTS.md still describe the deleted skills and old structure.
  • stream-react-native, stream-feeds-migration (and other packs pending their own rewrites) still reference the deleted ../stream/RULES.md / stream-docs.
  • The getstream skills default set and the getstream.io agent-skills docs pages still list stream-builder/stream-docs.
  • Pending fact-check: whether the livestream call type really denies host publish grants (v1 claim, currently not restored).
  • Docs fixes that would delete further skill lines: import.md shows the old stream-cli; video best-practices recommends the deprecated no-op usePersistedDevicePreferences.

🤖 Generated with Claude Code

…d stream-docs

Fresh-write of the core skills against a hard deletion criterion: a line
survives only if it prevents a failure an agent actually hits. Everything
the getstream CLI explains itself (-h, getstream docs local copies), the
official docs cover, or a competent agent infers was removed.

- stream: router + CLI overview, one first-match routing list. RULES.md,
  peers.yaml, and the track dispatch table are gone.
- stream-react: one linear build flow plus sections for auditing,
  upgrading, design matching, AI support agents, and Sendbird migration.
  Blueprints and docs-map are replaced by the CLI-served local docs; the
  curated Sendbird mapping is kept nearly whole, the extended mapping
  verbatim (grep-only lookup).
- stream-builder: deleted - it was a near-clone ancestor of stream-react;
  its unique content (use-case recipes, page flow) was salvaged.
- stream-docs: deleted - docs questions route to getstream docs.

Verified by five independent empty-context audits comparing every v1 idea
against v2 + CLI help + local docs; the real losses found were restored
or explicitly ruled out.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@myandrienko myandrienko changed the title v2: rewrite stream + stream-react, remove stream-builder + stream-docs skill trimming: rewrite core skills and stream-react Aug 24, 2026
Replaces the two rewritten skills with the current v2 text. Changes since the
first rewrite: design refinement scoped to explicit references ("a Slack-like
team chat" is guidance on structure, not a look to match; only a reference
design earns design-matching.md); CLI install marked "unless already present"
with getstream.io/cli as the alternative; Sendbird mapping and kill list kept
complete; wording passes throughout.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant