# AstroMatrix Reports

> 33 internal reports on the AstroMatrix astrology app (iOS, Android, web): product and UX audits, the chart-affinity matching engine, growth and retention, engineering and release notes, and content quality. Each page has an HTML version and a plain-text version (index.txt).

## Start here

What AstroMatrix is, how it fits together, and where the truth lives.

- [AstroMatrix Orientation](https://astromatrix-reports.pages.dev/orientation/index.txt) (2026-09-11): One page to orient from. It collates and reconciles the scattered docs — it introduces no new findings, and every claim points at the doc that owns ([HTML](https://astromatrix-reports.pages.dev/orientation/))
- [AstroMatrix Orientation Map](https://astromatrix-reports.pages.dev/orientation-map/index.txt) (2026-09-11): Nothing here is new information — it's the existing docs, arranged. The confusion has ([HTML](https://astromatrix-reports.pages.dev/orientation-map/))
- [AstroMatrix Ground Truth](https://astromatrix-reports.pages.dev/ground-truth/index.txt) (2026-09-11): One bet, three document lanes, one roadmap. Everything scattered across those sessions is one of those three lanes describing the same company from a different angle — here they are reconciled against what the code… ([HTML](https://astromatrix-reports.pages.dev/ground-truth/))
- [What AstroMatrix Knows](https://astromatrix-reports.pages.dev/what-astromatrix-knows/index.txt) (2026-09-11): A code-level stock-take of everything the product currently stores, observes or could derive about a person — and how much of a User Knowledge Profile is already sitting in production, ([HTML](https://astromatrix-reports.pages.dev/what-astromatrix-knows/))
- [The AstroMatrix Playbook](https://astromatrix-reports.pages.dev/the-astromatrix-playbook/index.txt) (2026-09-11): What the product actually is, what it has that nobody else does, what it's missing, how it makes money, and the four places new users could come from. One document, no ([HTML](https://astromatrix-reports.pages.dev/the-astromatrix-playbook/))
- [The AstroMatrix Archive](https://astromatrix-reports.pages.dev/the-astromatrix-archive/index.txt) (2026-09-12): Seven separately published briefings on the same company, written across 10–11 September 2026, merged into one indexed document. Nothing was summarised away. Where two of them contradict each other — and several do, on… ([HTML](https://astromatrix-reports.pages.dev/the-astromatrix-archive/))
- [AstroMatrix Quick Wins](https://astromatrix-reports.pages.dev/quick-wins/index.txt) (2026-09-11): Everything here is plausibly under half a day. Anything bigger was deliberately left out — the last section says what, and ([HTML](https://astromatrix-reports.pages.dev/quick-wins/))
- [The Matrix Question](https://astromatrix-reports.pages.dev/the-matrix-question/index.txt) (2026-09-11): The Matrix is the most-reached screen in the app after Home, and the second best at bringing people back. It is also the same screen every single time you open it. This is about closing that ([HTML](https://astromatrix-reports.pages.dev/the-matrix-question/))

## Product & UX

How people experience the app, and what gets in their way.

- [How AstroMatrix Explains Itself](https://astromatrix-reports.pages.dev/how-astromatrix-explains-itself/index.txt) (2026-10-24): Screen-level diagnosis · production 11.1.8 (build 300100101) · ([HTML](https://astromatrix-reports.pages.dev/how-astromatrix-explains-itself/))
- [Why AstroMatrix Feels Incomplete](https://astromatrix-reports.pages.dev/why-astromatrix-feels-incomplete/index.txt) (2026-10-24): Perception test · production 11.1.8 (build 300100101) · ([HTML](https://astromatrix-reports.pages.dev/why-astromatrix-feels-incomplete/))
- [Chart Journey Brief](https://astromatrix-reports.pages.dev/chart-journey-brief/index.txt) (2026-10-24): Developer brief · 2026-10-21 · register FEATURE-38, ([HTML](https://astromatrix-reports.pages.dev/chart-journey-brief/))
- [Timeline & Journey Status](https://astromatrix-reports.pages.dev/timeline-journey-status/index.txt) (2026-10-03): Bet 4 and FEATURE-26 are both committed and pushed to new-ui. Neither is shipped: the agreed state is pushed → awaiting device verification → shipped only after a list and grid ([HTML](https://astromatrix-reports.pages.dev/timeline-journey-status/))
- [UI/UX Audit Worklist](https://astromatrix-reports.pages.dev/ui-ux-audit-worklist/index.txt) (2026-10-17): UI/UX audit: connected problem groups and the Flutter ([HTML](https://astromatrix-reports.pages.dev/ui-ux-audit-worklist/))
- [Matrix Screen Audit](https://astromatrix-reports.pages.dev/matrix-screen-audit/index.txt) (2026-09-11): A full read of MatrixScreen — what it does, who calls it, and eight findings from tracing its code against the support and analytics record. Four are filed; four are corrections to claims already in the ([HTML](https://astromatrix-reports.pages.dev/matrix-screen-audit/))
- [Demand Hidden by Design](https://astromatrix-reports.pages.dev/demand-hidden-by-design/index.txt) (2026-09-02): What 74,613 accounts reveal about reachability, friction, and the next AstroMatrix ([HTML](https://astromatrix-reports.pages.dev/demand-hidden-by-design/))
- [Store Copy Pre-Flight](https://astromatrix-reports.pages.dev/store-copy-pre-flight/index.txt) (2026-09-11): Every claim in the ASO package checked against the shipped Flutter client, the Go ephemeris engine, the live paywall and the live web. The copy craft is sound and all 32 character counts are exact — what stops it are… ([HTML](https://astromatrix-reports.pages.dev/store-copy-pre-flight/))

## Affinity & matching engine

Scoring how chart factors relate, within one chart and between people.

- [Astro Affinity Brief](https://astromatrix-reports.pages.dev/astro-affinity-brief/index.txt) (2026-10-05): Astro affinity — what was built, how it was tested, what it may ([HTML](https://astromatrix-reports.pages.dev/astro-affinity-brief/))
- [Chart Affinity API](https://astromatrix-reports.pages.dev/chart-affinity-api/index.txt) (2026-09-22): Finding related factors inside one person’s chart — across natal, progressed, draconic and transit — rather than between two people. Every figure below is measured against the live CalculateHoroscopes API and the… ([HTML](https://astromatrix-reports.pages.dev/chart-affinity-api/))
- [Affinity Audit Pack](https://astromatrix-reports.pages.dev/affinity-audit-pack/index.txt) (2026-09-22): Twenty chart factors and the factors the engine considers to carry the same signature. For review by an astrologer or a second ([HTML](https://astromatrix-reports.pages.dev/affinity-audit-pack/))
- [Affinity Audit Pack Two](https://astromatrix-reports.pages.dev/affinity-audit-pack-two/index.txt) (2026-09-22): Twenty randomly drawn chart factors and what the engine considers to carry the same signature. A second pass, after the first audit’s findings were acted ([HTML](https://astromatrix-reports.pages.dev/affinity-audit-pack-two/))
- [Affinity Audit Pack Three](https://astromatrix-reports.pages.dev/affinity-audit-pack-three/index.txt) (2026-09-22): Twenty randomly drawn chart factors and what the engine considers to carry the same signature. A third and final pass, after both audits’ findings were acted on. Fresh seed, no overlap with either earlier ([HTML](https://astromatrix-reports.pages.dev/affinity-audit-pack-three/))
- [Aspect Match Pools](https://astromatrix-reports.pages.dev/aspect-match-pools/index.txt) (2026-09-22): What the symbolism engine considers related to ten natal aspects — the candidate set behind “connect with others who have this”. Every row scored on genes alone, no shared-concept credit, same chart layer family ([HTML](https://astromatrix-reports.pages.dev/aspect-match-pools/))

## Growth & retention

Who stays, who leaves, and what the numbers say.

- [AstroMatrix Retention Audit](https://astromatrix-reports.pages.dev/retention-audit/index.txt) (2026-10-20): The strongest pattern is that users who come back are the ones using astrology that changes with time: the Moon, forecasts, today's transits, and their own chart read against them. They come back within the first two or… ([HTML](https://astromatrix-reports.pages.dev/retention-audit/))
- [Signal Check](https://astromatrix-reports.pages.dev/signal-check/index.txt) (2026-09-07): This week's traffic report reads as growth. It isn't. Here's the real split, why it's not a new problem, and the two access decisions blocking a clean ([HTML](https://astromatrix-reports.pages.dev/signal-check/))
- [Adaptive Persistence Framework](https://astromatrix-reports.pages.dev/adaptive-persistence-framework/index.txt) (2026-09-02): Adaptive Persistence Framework — Computational Experiment Report · ([HTML](https://astromatrix-reports.pages.dev/adaptive-persistence-framework/))
- [September Ledger](https://astromatrix-reports.pages.dev/september-ledger/index.txt) (2026-09-28): September took two real hits — a mispriced lifetime SKU on Apple and an ([HTML](https://astromatrix-reports.pages.dev/september-ledger/))

## Engineering & releases

Builds, hotfixes, backend contracts and how AI sessions are run.

- [Flutter Work Assignment](https://astromatrix-reports.pages.dev/flutter-work-assignment/index.txt) (2026-10-17): AstroMatrix · Flutter UI/UX worklist · 2026-10-16 · ([HTML](https://astromatrix-reports.pages.dev/flutter-work-assignment/))
- [11.1.7 Hotfix Manifest](https://astromatrix-reports.pages.dev/hotfix-11-1-7-manifest/index.txt) (2026-10-17): What a maintenance release would change, platform by ([HTML](https://astromatrix-reports.pages.dev/hotfix-11-1-7-manifest/))
- [AstroMatrix 11.0.1 Release Checks](https://astromatrix-reports.pages.dev/release-checks-11-0-1/index.txt) (2026-09-14): Every check below traces to a specific commit that has not yet reached a user. Tap a box once for pass, twice for fail. Progress is shared — Mark sees what you ([HTML](https://astromatrix-reports.pages.dev/release-checks-11-0-1/))
- [AI Session Audit — astromatrix-nodejs](https://astromatrix-reports.pages.dev/ai-session-audit-nodejs/index.txt) (2026-10-11): This audit covers every Claude Code session on this repo from 2026-08-01 to 2026-10-11: 80 transcripts, 1.0 GB, ~3,960 human messages from Mark. Nothing in the repo or the database was changed to produce ([HTML](https://astromatrix-reports.pages.dev/ai-session-audit-nodejs/))
- [The /erase Contract](https://astromatrix-reports.pages.dev/the-erase-contract/index.txt) (2026-08-19): What the node side must hold to while the Flutter delete fix rolls out — and the one guarantee that, if broken, deletes user data permanently and ([HTML](https://astromatrix-reports.pages.dev/the-erase-contract/))

## Content & support

Interpretation quality and customer correspondence.

- [Content Quality Audit](https://astromatrix-reports.pages.dev/content-quality-audit/index.txt) (2026-09-10): Engagement time on /horoscopes/* pages, split three ways — category, planet/point, and individual page — to separate a template-wide problem from a genuine content-quality defect. 259 individual pages run at under half… ([HTML](https://astromatrix-reports.pages.dev/content-quality-audit/))
- [Correspondence Audit](https://astromatrix-reports.pages.dev/correspondence-audit/index.txt) (2026-08-19): Data audit · club.astromatrix.org · updated after backend ([HTML](https://astromatrix-reports.pages.dev/correspondence-audit/))