tdd: note what each proposed seam catches and misses (#1192)

* tdd: note what each proposed seam catches and misses

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Add changeset for tdd seam trade-offs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Matt PocockandClaude Opus 5.5 authored and GitHub committed 2026-10-07 11:21:08 +01:00
1 parent ad5400b930
commit 3f59913910
2 files changed
+6 -1

No files matched your search

+5
View File
@@ -0,0 +1,5 @@
---
"mattpocock-skills": patch
---
`tdd` now gives each proposed seam a one-line note on what it catches and what it misses, so choosing between seams is no longer a guess (#607).
+1 -1
View File
@@ -21,7 +21,7 @@ A **seam** is the public boundary you test at: the interface where you observe b
**Test only at pre-agreed seams.** Before writing any test, write down the seams under test and confirm them with the user. No test is written at an unconfirmed seam. You can't test everything, so agreeing the seams up front is how testing effort lands on the critical paths and complex logic instead of every edge case.
Ask: "What's the public interface, and which seams should we test?"
Ask: "What's the public interface, and which seams should we test?" Give each proposed seam a one-line note on what it catches and what it misses.
When the shape of that interface is itself in question (how deep the module is, where the seam belongs, what the interface should expose), call the Skill tool with "codebase-design" for the vocabulary. It is the shared source of the module, interface, depth, seam, adapter, leverage and locality terms, and it is a reference to consult, not a session to run.