docs: retain source-supported coordination lessons - #766

Scope

Document source-supported coordination lessons: look up each writer's recorded worktree, inspect cleanup behavior before selecting branch-deletion options, coordinate shared API reads and bounded native jobs, and retain native event times.

• Base commit: ecfa112764c664d35377dd66b8cfcb67e5a94d60.
• Lane: lane:shared; trading-lane acknowledgment at the final head is required before merge.
• Owned paths: docs/lanes.md; integrity entry committed last.

SOTA sources

• git/[email protected] stable porcelain format and worktree records.

• cli/[email protected] merge cleanup conditions and linked-worktree removal. The guidance preserves the branch-deletion and local-eligibility conditions.

• GitHub REST per-user allowance and authentication-specific exceptions.

• coreutils/[email protected] scheduler advice and current-clock date invocation.

• native-agent-stack@ecfa112764c664d35377dd66b8cfcb67e5a94d60:docs/acceptance-evidence-policy.md:24-40, docs/lanes.md:94, recipes/README.md:69,95. Primary sources reread; source scopes and restored references were independently checked.

• uutils0.10.0 scheduler interface; repository bounded-run recipe at native-agent-stack@ecfa112764c664d35377dd66b8cfcb67e5a94d60:adoption/tools/README.md:3-15 and result-retention policy.

Evidence-class table

Local commands run

python3 scripts/validate.py
exit 0: 69 components, 10272 hashed files, 4 profiles, 212 receipts
python3 -m unittest tests.test_install_claude_profile tests.test_github_automation_practice tests.test_merge_guard_doc tests.test_runtime_worker_openhands_resolver tests.test_jcodemunch_config
exit 0: 263 tests, 4 skipped
gitleaks git --pre-commit --staged --redact=100 --no-banner --no-color --config .gitleaks.toml --report-format json --report-path <owned-report> .
exit 0: 3048 staged bytes scanned, no findings
added-text/body login-name, personal-path, private-identifier and internal-reference scans
zero matches
git diff --check
exit 0

Heavy checks ran sequentially at niceness 19 with owned temporary storage. Scheduler advice does not establish isolation or explain a particular timeout; no merge, worktree deletion, quota event or new performance result is claimed.

Decision record

Worktree lookup now sits after the handoff text, preserving the first 151 base lines and their working references. Resource guidance uses the existing bounded-run recipe and returned-result policy. GNU 9.12 documentation and installed uutils 0.10.0 interfaces are named separately. A trading-owner acknowledgment remains pending.

These are source-bound operating lessons. Recheck cleanup conditions against the selected CLI revision, API budgets against the actual authentication type, and performance claims against retained native runs and controls. An inferred time cannot replace an earlier action's original event record.

Host evidence

No host receipt or platform-status promotion.

GitHub checks

The original review-head OSV scan reported five advisory identities across five unchanged base lockfiles (native scan):

Ordinary and frozen-macOS scans both exited 1. Dependency repair remains separately owned; green checks on a refreshed base are required after it lands. The prior body omitted three advisories; this table corrects that incomplete summary.

Checklist

• No workflow or GitHub Actions change.
• No credential value, private host identity/path or user quotation added.
• No new billing surface.
• Separate owned worktree; peer content preserved.
• Registry committed last; draft for independent exact-head review.