Design in Product social media card
← Back to Hub substantive

Cross-Pollination Brief — March 3, 2026

Piper Morgan's highest-commit day to date: 23 commits, 5 issues closed, three agents working in parallel across bug resolution, documentation maintenance, and content creation. The weekly docs audit (#877) found systemic debt — 23 broken links, 6 missing ADRs, a 20-day-stale briefing. Lead Developer replaced 26 raw exception leaks with conversational error messages (#876). A subagent commit-verification guideline was added to CLAUDE.md after orphaned code was discovered. Comms produced 7 content pieces in a single session. Klatch had not yet launched.

Key Insights

1. Subagent Commit-Verification Guideline

From: Piper Morgan (docs/, commit af9bfa94) Relevant to: Klatch

Lead Developer discovered 6 orphaned files from a prior subagent session — the subagent had completed work 10 days earlier, but nobody verified staging with git status. The files sat in limbo, causing 9 tests to fail silently. Root cause: "After subagent completes, stage its output, but verify with git status that all expected files are included."

Added to CLAUDE.md as a permanent guideline. Directly applicable to any team using subagents: Klatch's Argus and Daedalus regularly hand off work via branch commits, making the same gap possible.

Suggested action (Klatch): Add a git status verification step after staging any subagent output. The cost is one command; the failure mode (orphaned files causing silent test failures 10 days later) is hard to diagnose.

2. Weekly Docs Audit — Systemic Debt Found Immediately

From: Piper Morgan (#877) Relevant to: Klatch

First formal weekly audit found: 23 broken internal links, 6 ADRs missing from index (042, 044, 055-058), 20-day-stale briefing, 75 stale GitHub issues (most intentional backlog, not forgotten). Audit calendar had been running at 3-4 week intervals — corrected to weekly after this run.

Key finding on the 75 stale issues: most were intentional backlog or future-work decisions. The "icebox" label was recommended rather than mass closure. Stale ≠ forgotten.

Suggested action (Klatch): Establish a docs audit cadence before documentation debt compounds. Even a 15-minute link check catches broken references before they mislead agents.

3. Exception Contract Cleanup — 26 Leaks Fixed

From: Piper Morgan (#876, commit 4781d315) Relevant to: Klatch

Audit cascade found 26 locations in intent_service.py returning raw {str(e)} in user-facing message fields. Fix: _make_error_result() helper routing through UserFriendlyErrorService.get_conversational_error(). All 26 catch blocks updated. Pattern: audit cascade (Explore agents → precise count → systematic fix → verify with test suite) is more reliable than incremental patching.

Suggested action (Klatch): When error handling is inconsistent, run a codebase-wide audit rather than fixing one at a time. Klatch's error responses in the API layer warrant a similar scan as the project matures.

Emerging Patterns

Parallel agents, disjoint file sets. Docs Mgmt committed 14 times and Lead Dev committed 8 times to the same branch on the same day without a single conflict — because each agent owned a distinct file namespace. Coordination overhead stays near zero when responsibilities don't overlap.

Granular commits over batch commits. PM explicitly directed: "I do not prefer one big commit. Patient, one at a time." 14 Docs commits, each with a coherent message, produced a clean history. A single large commit would have obscured what changed and why.

Background Changes (Noted, Low Priority)

  • Pattern-061 (Human-AI Collaboration Referee) added and committed
  • ADR index: 6 missing ADRs cataloged, total now 61, next ADR-059
  • Briefing consolidation: knowledge/ copies deleted, docs/briefing/ symlinks → real files
  • Comms: "The Assembly Assumption" published, 6 more pieces drafted

Sources Read

Piper Morgan:

  • docs/omnibus-logs/2026-03-03-omnibus-log.md — 3 sessions, 23 commits, 5 issues closed

Klatch:

  • Not yet launched.
← Back to Hub