docs: sync methodology FAQ + README layout with shipped surface

- Methodology FAQ #8: "periodic refresh" → "webhook-driven rescoring on
  every push" to match tasks/0.6.0/01-webhook-rescoring.md and
  lib/roadmap.ts.
- README Layout: add /about, /action, /skill, /package, /llms.txt pages
  and expand /api summary (score / badge / package endpoints) — all
  shipped across 0.3.0–0.5.0.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hsnice16

README.md

@@ -137,13 +137,18 @@ Run the unit tests with `bun run test` (uses `node --test` + `tsx`; requires Nod
 app/          Next.js App Router — pages + API + SEO
   layout.tsx       root layout, root metadata (OG + Twitter cards)
   page.tsx         leaderboard
-  repo/[id]/       repo detail (includes generateMetadata for shareable titles)
+  repo/[id]/       repo detail (generateMetadata + per-repo OG image)
   methodology/     how scoring works today
   roadmap/         upcoming versions (from lib/roadmap.ts)
   changelog/       what's shipped (from lib/changelog.ts)
-  api/             repos + repo/[id] JSON routes
+  about/           independent project, no vendor affiliation (footer-linked, E-E-A-T)
+  action/          PR-diff GitHub Action explainer + install snippet
+  skill/           agent-skill explainer + install command
+  package/         registry → repo lookup (form + per-package state pages)
+  api/             /repos, /repo/[id], /score, /badge/<host>/<owner>/<name>, /package/<registry>/<name>
   robots.ts        /robots.txt — allows "/", blocks "/api/"
   sitemap.ts       /sitemap.xml — static routes + every repo
+  llms.txt/        markdown manifest for LLM crawlers
   globals.css      Tailwind import + @theme tokens
 components/   React components (Tailwind-styled)
 lib/

app/methodology/page.tsx

@@ -47,7 +47,7 @@ const FAQ = [
   },
   {
     q: "How often is the data refreshed?",
-    a: "Manually for now — repositories are re-scored when the seed list changes or the rubric is updated. Automated periodic refresh is planned for v0.6.0.",
+    a: "Manually for now — repositories are re-scored when the seed list changes or the rubric is updated. Webhook-driven rescoring on every push is planned for v0.6.0.",
   },
   {
     q: "Which forges are supported?",