docs: add ignite positioning and schema guidance

[0xjcf]

Summary

• Add a dedicated When to choose Ignite / Comparisons docs page and sidebar entry.
• Link the overview page to the decision guide.
• Expand agent-facing getSchema guidance across headless runtime, command metadata, and agent runtime docs.
• Record FAS task scope/closeout metadata.

Verification

• fas validate-task
• pnpm lint:md
• pnpm --filter docs-site run check:docs
• pnpm docs:build
• pnpm --filter docs-site run check:contrast (passed with scoped Chromium escalation)
• .fas/scripts/verify.sh --full
• coderabbit review --agent -t committed --base beta -c AGENTS.md (0 issues)

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f603795f-4093-4269-a579-5e90d9bbe114

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fas/docs-accuracy-ux-positioning

---

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.02%. Comparing base (2f86faa) to head (05f3f3d).
⚠️ Report is 5 commits behind head on beta.

Additional details and impacted files

@@            Coverage Diff             @@
##             beta      #88      +/-   ##
==========================================
- Coverage   91.25%   91.02%   -0.24%     
==========================================
  Files          33       34       +1     
  Lines        1830     1972     +142     
  Branches      498      540      +42     
==========================================
+ Hits         1670     1795     +125     
- Misses        150      167      +17     
  Partials       10       10              

Flag	Coverage Δ
unittests	91.02% <ø> (-0.24%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.