docs(#236): add bidirectional cross-referencing guidance for problem docs

[fullsend-ai-coder]

Add a bullet to the problem-doc guidance in AGENTS.md instructing authors to search for references to their topic across docs/problems/ and add backlinks from existing docs to the new doc in the same PR. This codifies a practice that was previously caught only during review, ensuring readers can discover new docs from related contexts.

---

Closes #236

Post-script verification

• Branch is not main/master (agent/236-backlinks-guidance)
• Secret scan passed (scan-secrets --staged)
• Diff matches the proposed change from the issue body

[fullsend-ai-review]

🤖 Finished Review · ❌ Failure · Started 12:59 PM UTC · Completed 12:59 PM UTC
Commit: c776c24 · View workflow run →

[guyoron1]

/fs-review

[fullsend-ai-review]

🤖 Finished Review · ✅ Success · Started 3:57 PM UTC · Completed 4:02 PM UTC
Commit: d8e3df7 · View workflow run →

[fullsend-ai-review]

Review — ✅ Approve

PR: docs(#236): add bidirectional cross-referencing guidance for problem docs
Scope: 1 file, +1 line (AGENTS.md)

Summary

Single-line addition to the problem-doc guidance section of AGENTS.md, inserting a bullet that instructs authors to search for and add backlinks from existing docs when a new problem doc covers an already-referenced topic. The change codifies a practice previously caught only during review (per issue #236).

Dimensions evaluated

Dimension	Result	Notes
Correctness	✅ No findings	Procedural guidance; internally consistent with surrounding bullets
Security	✅ No findings	No secrets, injection patterns, Unicode steganography, or permission changes
Intent & coherence	✅ No findings	Exactly matches issue #236's proposed text and placement (after line 9)
Style & conventions	✅ No findings	Follows dash-prefix, backtick-wrapped paths, em-dash, and period conventions
Documentation currency	✅ No findings	docs/problems/ exists; no inconsistencies with README.md or CONTRIBUTING.md
Cross-repo contracts	⏭ Skipped	No exported interfaces modified

Verdict

Clean, well-scoped documentation change that matches its authorization exactly. No findings above info severity.

---

Protected paths detected — this PR modifies files under one or more
protected paths. The review agent cannot approve PRs that touch these paths.
A human reviewer must approve this PR.

Protected files in this PR:

• AGENTS.md

---

Labels: PR adds documentation guidance to AGENTS.md

[guyoron1]

/fs-fix

[fullsend-ai-coder]

🤖 Finished Fix · ✅ Success · Started 5:38 PM UTC · Completed 5:43 PM UTC
Commit: d8e3df7 · View workflow run →

[fullsend-ai-coder]

🔧 Fix agent — iteration 1 (human-triggered)

No fixes needed. The review agent approved PR #274 with zero findings. The /fs-fix command was invoked without a specific instruction. The PR is a clean, single-line documentation addition to AGENTS.md (a protected path requiring human approval).

Disagreed (1):

1. no findings to address: The review agent approved this PR with zero findings across all dimensions (Correctness, Security, Intent & coherence, Style & conventions, Documentation currency). The human /fs-fix command provided no specific instruction (HUMAN_INSTRUCTION=none). There are no review findings to fix.

Tests: passed

_{Updated by fullsend fix agent}