Roadmap & documented plans

This page summarises the product direction captured in the project’s docs/ folder. It is intent and design, not a release calendar. Nothing here guarantees a ship date unless the site already says it is live.

North star

CacheSphere is programming languages and developer tools in natural language — hype-light and vendor-neutral — plus a machine-readable knowledge base for people and AI agents: one trustworthy place to compare languages and ground decisions instead of scattered docs and sponsored listicles. Full framing: VISION.md in the repo.

Shipped today (real)

• Languages catalogue — 130+ languages with a consistent page shape: overview, when to use, cheatsheet, examples, pitfalls, further reading.
• Human UI — 3D globe, side-by-side compare, language detail pages, in-browser runner where it applies (e.g. JavaScript).
• Agent surface — GET /api/languages.json (MIT-licensed), stable language-detail.html?lang=…, For AI tools, /llms.txt, attribution guidance.
• Positioning — free-first core; optional pricing / waitlist; no paywall on the open catalogue; Stripe-style checkout paused until explicitly enabled.

Documented plans (not all live)

These come from VISION.md, PRODUCT_VISION.md, and v1-languages-tools-stacks.md. Treat names and APIs as design until shipped and reflected in for-agents.html / llms.txt.

Catalogue quality & resilience

• Compare — only list languages with complete-enough data; thin entries skipped, hidden, or clearly marked incomplete.
• Language detail — graceful rendering when optional fields are missing (“basic info only; more coming soon”).

Tools & stacks layers

• GET /api/ai-tools.json — curated AI/dev tools (IDEs, CLIs, platforms, frameworks); neutral JSON; affiliate links only on human pages if added later.
• GET /api/stacks.json — opinionated cheap, efficient combinations of languages + tools (replace overpriced “all-in-one” bundles with smaller setups).
• Human pages (design only until built) — e.g. tools.html, tool-detail.html, stacks.html, stack-detail.html, optional services.html for productised setup offers.

Language Advisor (human + agent)

• Website — describe what you are building → ranked language suggestions with short reasons, tags, links into the catalogue.
• POST /api/recommend-language (planned) — agent counterpart; catalogue_refs.id tied to languages.json; additive JSON; experimental until marked stable.
• Analytics (optional, future) — light, privacy-leaning page views and a few custom events on the Advisor only when explicitly built and disclosed in Privacy/Terms.

Monetisation stance (later, on top of free core)

Direction only: affiliates on human pages, one-off PDFs, productised setup, possible subscriptions for check-ins/alerts—no display ads; core catalogues stay free and agent-friendly. Possible Pro/Teams ideas in PRODUCT_VISION.md are not implemented.

Process layer (how tools enter the catalogue)

PROCESS_LAYER.md describes the chain: discovery signals (public, ToS-respecting) → verification (official docs, small experiments) → curation (relevance, minimum metadata) → opinion (best-for tasks, pricing profile) → catalogues (ai-tools.json, stacks.json). CacheSphere aims to be a curator, not a mirror of any one feed.

Current slice & guardrails

From PROCESS_LAYER.md §4 and IDEAS.md:

• In scope now — languages reference + globe/compare/detail; process doc; a small hand-maintained ai-tools.json on the order of 10–20 tools when that file ships.
• Explicitly out of scope until widened — automated scrapers/cron ingestion; large new UIs (stacks explorer, admin dashboards); Stripe/Pro wiring; marketing production pipelines.
• Parking lot (record, don’t build yet) — e.g. devlog-from-Git, richer discovery pipelines, fuller stacks UI, monetisation/marketing pushes—see the repo docs.

Draft services (future)

SERVICES_DRAFT.md sketches a productised offer such as cheap agentic dev stack setup & tune-up (solo devs replacing expensive all-in-one tools). Not live as a separate services page until the core catalogues are stable. Contact: support@cachesphere.com · see also Pricing.

Example future stack (design only)

v1-languages-tools-stacks.md §5 describes a solo cheap agentic coding stack (Python + TypeScript, modular tools, ~£0–£20/mo intent)—illustrative; not a live preset until stacks.json and pages exist.

Source of truth

Authoritative detail lives in the open-source repository under docs/ (e.g. VISION.md, PRODUCT_VISION.md, PROCESS_LAYER.md, v1-languages-tools-stacks.md, SERVICES_DRAFT.md). This page is updated when those documents change.