Research
What the outside world already does — competitors, vendors, precedent, feasibility studies. Every claim carries a source, and every document says what it could not verify.
Real Wise — internal documentation
Everything the team has worked out about what we are building and why. Private — the site sits behind Cloudflare Access, so nothing here is reachable without an emailed sign-in code.
What is in here
Section titled “What is in here”Analysis
What we worked out ourselves — architecture decisions, scope, module design. Documents whose direction was later reversed carry a banner naming what shipped instead; they are kept because they record why we did not.
The team
Section titled “The team”Publishing a document
Section titled “Publishing a document”The repo holds far more than this site does. A document is published by renaming it:
product/researches/15-architectural-plan-extraction.mdproduct/researches/15-architectural-plan-extraction.docs.md ← publishedThe .docs.md marker is the whole opt-in. It is stripped from the published address, so the marker
never shows up in a URL. Everything without it stays internal.
Adding a new section is one entry in sidebar in apps/docs/astro.config.mjs, pointing at the
directory it should list.
Adding a page that is not markdown
Section titled “Adding a page that is not markdown”Anything needing its own HTML, CSS and JavaScript goes in src/pages/ as an .astro file —
src/pages/status.astro is a working example, styles and script included. It renders inside the
same Starlight shell as everything else.