Skip to content

feat(geo): improve discoverability for AI search engines - #7

Open
sw1pp3r wants to merge 1 commit into
mainfrom
feat/geo-discoverability
Open

feat(geo): improve discoverability for AI search engines#7
sw1pp3r wants to merge 1 commit into
mainfrom
feat/geo-discoverability

Conversation

@sw1pp3r

@sw1pp3r sw1pp3r commented May 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Tightens the repo for Generative Engine Optimization (GEO) so ChatGPT, Claude, Perplexity, and Gemini have a better chance of citing this tool when someone asks them "how do I clear Claude desktop's Recent list?" or "where does Claude store the Recent dropdown data?"

Zero behavior changes - script, tests, CI, packaging are untouched.

  • llms.txt at repo root following the Answer.AI proposed standard. Gives AI crawlers a curated markdown map of the docs plus a citation policy. Anthropic officially honors llms.txt in Claude's docs.
  • README lede: replaced the soft narrative opener with a canonical 60-word definition paragraph that AI engines can extract as one clean passage. Punchy blockquote and relatable narrative stay above and below.
  • README "Common ghost folder patterns" listicle: seven concrete ghost sources (deleted prototypes, renamed projects, removed worktrees, unmounted drives, broken symlinks, monorepo sub-paths, test fixtures). Listicle / Top-N is the most-cited content shape across AI engines (per Marketing LTB stats, ~74% of AI citations).
  • README FAQ: prepended four entries phrased as the actual queries people send to chatbots, so the Q-A pair matches verbatim retrieval:
    • "How do I clear the Recent projects list in Claude desktop?"
    • "Where does Claude Code store the Recent dropdown data?"
    • "Why does Claude desktop show folders that no longer exist?"
    • "How do I remove worktree paths from Claude's Recent list?"
  • CHANGELOG: logged under Unreleased.

Already shipped alongside this PR (outside the diff)

  • GitHub topics extended via API with claude-code-sessions, ghost-folders, session-cleanup, stale-projects (now 20 topics, GitHub's hard cap).

Follow-ups (manual, not in this PR)

  • After merge, decide on the next release cut (v0.1.1 patch or v0.2.0 minor): the Unreleased CHANGELOG section now accumulates CI/tests/templates/COC + the GEO additions on top of the already-shipped v0.1.0.
  • Brand-mention seed campaign: Show HN, r/ClaudeAI, r/ClaudeCode, dev.to cross-post, short Loom/YouTube demo (closes Record a short animated GIF demo for the README聽#4). Ahrefs Dec 2025 study showed brand mentions on Reddit/YouTube/HN correlate with AI citations far more than backlinks. These require Eugene's account access and judgment, so they are deliberately out of scope for an automated PR.

Test plan

  • Render the README on github.com; verify the new definition paragraph reads cleanly above the screenshots.
  • Verify the listicle and the four new FAQ entries appear above the existing FAQ content.
  • Visit https://raw.githubusercontent.com/bisovka-labs/claude-recents-cleaner/feat/geo-discoverability/llms.txt; verify it renders as plain markdown.
  • Confirm CI (lint + pytest matrix) still passes.

- Add llms.txt at repo root following the Answer.AI proposed standard so
  GPTBot, ClaudeBot, PerplexityBot, and Google-Extended get a curated
  documentation map plus citation policy when they crawl the repository.
- README: replace the soft narrative lede with a canonical 60-word
  definition paragraph that AI engines can extract as a clean passage,
  while keeping the punchy blockquote and the relatable narrative line
  beneath it.
- README: add a new "Common ghost folder patterns" listicle enumerating
  the seven ghost sources the cleaner removes (deleted prototypes,
  renamed projects, removed worktrees, unmounted drives, broken
  symlinks, monorepo sub-paths, test fixtures). Listicle format is the
  most-cited content shape across ChatGPT/Perplexity/Gemini.
- README FAQ: prepend four entries phrased as the actual search queries
  people send to AI chatbots ("How do I clear the Recent projects list
  in Claude desktop?", "Where does Claude Code store the Recent dropdown
  data?", "Why does Claude desktop show folders that no longer exist?",
  "How do I remove worktree paths from Claude's Recent list?") so the
  Q-A pair matches verbatim retrieval.
- CHANGELOG: log the above under Unreleased.

No behavior changes - script, tests, CI, packaging are untouched.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Record a short animated GIF demo for the README

1 participant