[owieschon]

What & why

Adds docs/attention-authoritative-needs-attention.md.

Operators still invent parallel "needs human" language or second status detectors while the board already has Needs attention. This recipe locks the hire-line rule: page humans for Needs attention; do not invent NeedsHuman or a second agentStatus SoT. Matters for overnight honesty work staying on attested nouns.

How I tested it

• Docs-only diff vs upstream main (single file)
• Cut from upstream/main (no fork-main drift)
• Stay DRAFT — no undraft without CoS→Owen

Mechanism

Docs-only recipe. Lexicon: Needs attention (attested). Fence Todd #7007/agentStatus SoT; no wake-policy ownership; no dock #6506; no hooks.

Checklist

• Single docs file vs upstream main
• No invented NeedsHuman column
• Stay DRAFT until CoS READY + Owen undraft

---

Summary by cubic

Adds a docs recipe that makes Needs attention the single authoritative human-page signal on the board, so operators stop inventing parallel NeedsHuman states or a second agentStatus source of truth.

Rollout

• Stays DRAFT until it has a proof gate and is explicitly undrafted.
• Docs-only change; no runtime behavior or dependencies affected.

^{Written for commit 476f26f. Summary will update on new commits.}

How I tested it

• RECEIPT_PATH=/workspace/handoffs/pr7304-receipt-476f26f77.md
• Tip: 476f26f77356f02ffa087d6155f96130dd371459
• Fork tip-match (authoritative env cleanup #38 only): CI tip-match: #7304 attention-authoritative docs owieschon/superset#38
• Fork CI: https://github.com/owieschon/superset/actions/runs/34186419877 — owned jobs SUCCESS (Lint/Test/Typecheck/Build/Sherif/Vale/Version Sync/Build CLI×4); Neon Deploy Database FAIL allowlisted
• Docs self-check: single-file tip vs upstream/main
• Stay DRAFT

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[owieschon]

Closing — this was internal operator practice, not an upstream product change. Keeping the bar in private doctrine; will land trust work as product behavior instead.