Remove markdown test docs and document tests inline

packages/coord-core/store/inbox_test.go

@@ -10,6 +10,7 @@ import (
 	dbpkg "ai-workflow-skill/packages/coord-core/db"
 )
 
+// TestClaimThreadReturnsLeaseConflictAfterBusyWrite verifies claim returns a lease conflict after a concurrent write wins.
 func TestClaimThreadReturnsLeaseConflictAfterBusyWrite(t *testing.T) {
 	t.Parallel()
 

packages/coord-core/store/orch_test.go

@@ -8,6 +8,7 @@ import (
 	dbpkg "ai-workflow-skill/packages/coord-core/db"
 )
 
+// TestRecordCheckRefreshesDependentReadyStateWhenGatePasses verifies the final passing check unlocks dependent work.
 func TestRecordCheckRefreshesDependentReadyStateWhenGatePasses(t *testing.T) {
 	t.Parallel()