docs(#343): add backlink guidance for new problem docs

[fullsend-ai-coder]

Add a bullet to the problem-doc section of AGENTS.md requiring authors to search existing docs for references to their topic and add reciprocal backlinks in the same PR. This codifies the practice demonstrated in PR fullsend-ai#3064, where the maintainer had to manually add backlinks from agent-architecture.md, code-review.md, and autonomy-spectrum.md to a new flapping-convergence.md doc.

---

Closes #343

Post-script verification

• Branch is not main/master (agent/343-backlink-guidance)
• Secret scan passed (gitleaks — a2afa8b179a351845733c680b839a39a82304db6..HEAD)
• Pre-commit hooks passed (authoritative run on runner)
• Tests ran inside sandbox

[fullsend-ai-review]

🤖 Finished Review · ✅ Success · Started 6:47 AM UTC · Completed 6:53 AM UTC
Commit: a2afa8b · View workflow run →

[fullsend-ai-review]

Review — PR #381

Verdict: ✅ Approve

Summary

This PR adds a single bullet point to the "How to work in this repo" section of AGENTS.md, requiring authors of new problem docs to search existing docs for references to the topic and add reciprocal backlinks in the same PR. The change codifies a practice that was previously handled ad-hoc by maintainers.

Dimensions evaluated

Dimension	Result
Correctness	✅ No issues — new guidance is internally consistent with existing AGENTS.md content (complements the "create new file and link from README" rule, mirrors the ADR "same PR" pattern)
Security	✅ No issues — no secrets, no injection patterns, no permission changes
Intent & coherence	✅ Authorized via issue #343 (filed by repo owner). Scope matches exactly. The guardrails concern (bot modifying AGENTS.md) is mitigated: the change adds constraint rather than loosening it, and CODEOWNERS still requires human approval to merge
Style & conventions	✅ Follows existing format — imperative mood, backtick-wrapped paths, logical placement after the "create new file" bullet
Documentation currency	✅ No staleness — referenced path docs/problems/ exists, no conflicts with other docs
Cross-repo contracts	⏭ Skipped — no exported interfaces modified

No findings above the severity threshold.

---

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 modifies AGENTS.md documentation guidance

[guyoron1]

/fs-fix

[fullsend-ai-coder]

🤖 Finished Fix · ✅ Success · Started 8:00 AM UTC · Completed 8:05 AM UTC
Commit: a2afa8b · View workflow run →

[fullsend-ai-coder]

🔧 Fix agent — iteration 1 (human-triggered)

No changes made. The review agent approved this PR with no findings. The human /fs-fix command included no specific instruction. There are no review findings to fix.

Disagreed (1):

1. no actionable review findings: The review agent approved this PR with verdict 'Approve' and stated 'No findings above the severity threshold.' The review body file is empty. The human triggered /fs-fix without a specific instruction. There are no review findings to address and no human instruction to follow. The PR's single change to AGENTS.md (a protected path) was reviewed and approved by the review agent.

Tests: passed

_{Updated by fullsend fix agent}