docs: rebalance prose cleanup and add trimming skill

packages/core/agent-loop/tests/properties.spec.ts

@@ -1,5 +1,7 @@
 /**
- * Property-based tests for the agent loop's inbox/turn scheduling (the property-testing RFC).
+ * Deterministic property tests for inbox scheduling: every sent message logs
+ * once, turn numbers increase, and status follows idle→running→idle/disposed.
+ * Schedules advance on status events rather than wall-clock sleeps.
  */
 
 import { describe, expect, it } from 'vitest'
@@ -139,8 +141,8 @@ describe('agent loop scheduling properties', () => {
         const ctx = await harness()
         try {
           const agent = ctx.agentLoop.create(AgentId('a'), { model: 'mock' })
-          // Capture an idle waiter before EACH send; the last one is guaranteed to resolve
-          // because the final send always triggers (or joins) a turn that ends idle.
+          // Capture before each send; the last waiter covers the final turn, and
+          // awaiting an already-settled earlier waiter is harmless.
           let lastIdle: Promise<void> | undefined
           for (const step of steps) {
             const idle = nextIdle(ctx, agent)