Skip to content

Update domain-discovery v3.1: Durable Streams feedback#7

Merged
LadyBluenotes merged 2 commits intoplanfrom
domain-discovery-durable-feedback
Feb 25, 2026
Merged

Update domain-discovery v3.1: Durable Streams feedback#7
LadyBluenotes merged 2 commits intoplanfrom
domain-discovery-durable-feedback

Conversation

@KyleAMathews
Copy link
Collaborator

Summary

Incorporates 9 improvements from the Durable Streams test run feedback (discussion #2):

  • Flexible domain count — replace rigid "4-7" target with complexity-driven minimum
  • Primary audience identification — group for app devs vs implementors vs operators (prevents mixing protocol internals into feature developer skills)
  • Developer task validation pass — merge skills if a developer would commonly need both for one task
  • Peer dependency doc reading — new step 7 in reading order; framework integration failure modes were the 6 highest-impact findings in the Durable Streams test but are invisible from the library's own docs
  • Wrong/correct code patternswrong_pattern and correct_pattern fields in failure mode YAML for direct tree-generator consumption
  • source_type field — distinguish documented vs implicit_knowledge failure modes; require Phase 4c to produce 3+ new failure modes not found in Phase 3
  • Research-backed interview questions — investigate code before asking maintainer ("I found X — is this intentional?" beats "What happens when X?")
  • Pre-1.0 library adaptations — shorter implicit-knowledge phase, longer gap-targeted when usage patterns haven't crystallized
  • Composition safety warnings — explicitly probe whether similar-looking APIs from popular libraries transfer correctly

Test plan

  • Verify all 9 changes are present in the diff
  • Check Phase 3 section numbering is sequential (3a through 3j)
  • Verify YAML schema includes new fields (source_type, wrong_pattern, correct_pattern)
  • Verify skill_spec.md template reflects new failure mode table columns
  • Verify constraints table includes all 9 new checks

🤖 Generated with Claude Code

Incorporate 9 improvements from Durable Streams test run feedback:

1. Flexible domain count — replace rigid "4-7" target with
   complexity-driven minimum
2. Primary audience identification — group for app devs vs
   implementors vs operators
3. Developer task validation pass — merge skills if a developer
   would need both for one task
4. Peer dependency doc reading — framework integration failure modes
   are highest value but invisible from library's own docs
5. Wrong/correct code patterns — wrong_pattern and correct_pattern
   fields in failure mode schema for direct tree-generator consumption
6. source_type field — distinguish documented vs implicit_knowledge
   failure modes; require 3+ new from Phase 4c interview
7. Research-backed interview questions — investigate code before
   asking maintainer for better answers
8. Pre-1.0 library adaptations — shorter implicit-knowledge phase,
   longer gap-targeted when usage patterns haven't crystallized
9. Composition safety warnings — probe whether similar-looking APIs
   from popular libraries transfer correctly

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@pkg-pr-new
Copy link

pkg-pr-new bot commented Feb 25, 2026

Open in StackBlitz

npm i https://pkg.pr.new/TanStack/playbooks/@tanstack/playbooks@7

commit: e545ff2

@LadyBluenotes LadyBluenotes merged commit ba84903 into plan Feb 25, 2026
2 of 4 checks passed
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.

2 participants