fix(docs): repair broken links across README, docs, and templates

[mehmetdemircs]

TL;DR

Audit of every URL in the repo found 9 broken links across 7 files plus 2 README links that worked only via redirect. All fixed; doc-only changes; pre-commit gate clean (fmt + clippy + 1869 tests passed).

Summary

All URLs below are clickable in the preview — click both Before and After to verify yourself.

🔴 Group 1 — Broken (404 or wrong content)

README.md — supported-agents docs

• ❌ Before · 404 · https://www.rtk-ai.app/guide/getting-started/supported-agents
• ✅ After · 200 · https://www.rtk-ai.app/docs/getting-started/supported-agents/

README.md — configuration docs

• ❌ Before · 404 · https://www.rtk-ai.app/guide/getting-started/configuration
• ✅ After · 200 · https://www.rtk-ai.app/docs/getting-started/configuration/

src/hooks/init.rs (×2) and .rtk/filters.toml — filter template header

• ❌ Before · page 200, anchor dead · https://github.com/rtk-ai/rtk#custom-filters (no ## Custom Filters heading exists in the README)
• ✅ After · 200 · https://github.com/rtk-ai/rtk/blob/HEAD/src/filters/README.md

docs/guide/index.md — ARCHITECTURE.md link

• ❌ Before · 404 · https://github.com/rtk-ai/rtk/blob/master/ARCHITECTURE.md (file actually lives at docs/contributing/ARCHITECTURE.md)
• ✅ After · 200 · https://github.com/rtk-ai/rtk/blob/HEAD/docs/contributing/ARCHITECTURE.md

scripts/check-installation.sh (×3) — install one-liner

• ❌ Before · 200 but text/html · https://github.com/rtk-ai/rtk/blob/master/install.sh (GitHub's HTML wrapper page, not the script — fails when piped to sh)
• ✅ After · 200 text/plain · https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh

.claude/agents/technical-writer.md — Linux binary install snippet

• ❌ Before · 404 · https://github.com/rtk-ai/rtk/releases/download/v0.16.0/rtk-linux-x86_64 (asset name never existed; releases ship .tar.gz tarballs)
• ✅ After · replaced with the official install.sh one-liner

.claude/skills/ship/SKILL.md — release verification snippet

• ❌ Before · 404 · https://github.com/rtk-ai/rtk/releases/download/v0.17.0/rtk-macos-latest (asset name never existed)
• ✅ After · 200 · https://github.com/rtk-ai/rtk/releases/download/v0.17.0/rtk-aarch64-apple-darwin.tar.gz

🟢 Group 2 — Worked via redirect, now canonical

README.md — troubleshooting link

• 🔁 Before · 301 → /docs/resources/troubleshooting/ · https://www.rtk-ai.app/guide/troubleshooting
• ✅ After · 200 direct · https://www.rtk-ai.app/docs/resources/troubleshooting/

README.md — docs landing link

• 🔁 Before · 301 → /docs/ · https://www.rtk-ai.app/guide
• ✅ After · 200 direct · https://www.rtk-ai.app/docs/

---

Doc-only changes — no runtime behavior altered. The only Rust file touched is src/hooks/init.rs, and only the URL inside two const &str template comments (the headers written by rtk init into a new .rtk/filters.toml or ~/.config/rtk/filters.toml).

Test plan

• cargo fmt --all --check — clean
• cargo clippy --all-targets — 0 warnings
• cargo test — 1869 passed, 0 failed, 6 ignored
• HTTP status verified for every URL via curl -sS -L -o /dev/null -w '%{http_code}' --max-time 12 <url>
• Content-type verified for install.sh (text/html vs text/plain) to confirm /blob/ vs raw.githubusercontent.com distinction
• All ✅ After URLs return 200 (or 200 direct for the canonical/redirect cases)
• All ❌ Before URLs return 404 (or wrong content-type for install.sh)
• Manual rtk <command> output inspection — N/A, no filter logic changed

Pre-commit gate raw output

$ cargo fmt --all --check
(clean)

$ cargo clippy --all-targets
Finished `dev` profile [unoptimized + debuginfo] target(s) in 24.34s
(0 warnings)

$ cargo test
test result: ok. 1869 passed; 0 failed; 6 ignored; 0 measured; 0 filtered out