docs: close soft residuals — docs/README parity + MkDocs standard

- site_description = README SEO one-liner (YAML-safe)
- edit_uri: edit/main/docs/
- docs badge + Features/Development/Metrics from README when missing
- rewrite repo-relative links to GitHub absolute for strict builds

Author: 88plug

docs/index.md

@@ -251,3 +251,26 @@ build with Material for MkDocs (`mkdocs build --strict`).
 [FSL-1.1-ALv2](https://github.com/88plug/project-prospector/blob/main/LICENSE)
 © 2026 [88plug](https://github.com/88plug) — Functional Source License; converts
 to Apache 2.0 two years after each release.
+
+## Features
+
+| Feature | What it does |
+| --- | --- |
+| Two-pass multi-agent sweep | Catalog clusters in parallel, then blind-spot agents for coverage |
+| Novelty / leverage ranking | S–D tiers on idea quality, not finish state or LOC |
+| Idea / LIVE / dormant tags | Separates insight quality from execution state on every entry |
+| Evidence-anchored rationale | Paths, commit counts, and numbers verified against disk |
+| Time window + scope | Relative cutoffs, theme/dir roots, and path exclusions honored by every agent |
+| Read-only by design | Inspect only — never edits, moves, deletes, commits, or starts services |
+| Alternative lenses | Initiative clustering, momentum, kill list, authorship, loss-risk |
+| Complements total-recall | One-shot ranked census, not a persistent operator memory profile |
+
+## Development
+
+Local clone for development only:
+
+```text
+git clone https://github.com/88plug/project-prospector
+/plugin marketplace add ./project-prospector
+/plugin install project-prospector@88plug
+```

mkdocs.yml

@@ -1,8 +1,5 @@
 site_name: Project Prospector
-site_description: >-
-  A Claude Code skill that catalogs and ranks everything you've built or
-  sketched on a machine — parallel read-only agents, blind-spot pass, tiered
-  ranking by idea-novelty and leverage.
+site_description: 'Discover, catalog, and rank everything you''ve built or sketched on a machine — a Claude Code multi-agent skill for filesystem project discovery with tiered novelty and leverage ranking.'
 site_url: https://88plug.github.io/project-prospector/
 repo_url: https://github.com/88plug/project-prospector
 repo_name: 88plug/project-prospector