Home / Product / Consumer App

Affirmology Atlas - app spec (v1)

Updated Jun 16, 2026 · Affirmology_Atlas_AppSpec_v1.md

Affirmology Atlas - app spec (v1)

The app version of the system. Atlas is the app; Hermes is the assistant inside it. Built on the cloud Studio (Render + R2). Status: DESIGNED, build when Render + R2 are up.

The core idea: one app, two modes, one tap between them

1. Hermes (chat mode) - the default and dead-simple. A chatbot with FULL connection to the backend system and to every document in the jpl-knowledge github share. Voicenote or type. Ask anything, drop an idea, leave feedback, get answers about any project doc, check on the system. This is the on-the-road mode, the thing Jeff opens from his phone in the car.
2. Studio (full mode) - the complete Studio: people, structures, the composer, the library, versions, render. The full workbench. A single prominent toggle/button flips between Hermes and Studio. Hermes is the easy front door; Studio is one tap away.

What it does

• Voicenoting everywhere: record feedback, ideas, or questions by voice from the phone; transcribed; flows into the system (and into feedback where relevant).
• Hermes knows everything safe: the live system state plus all jpl-knowledge docs, so it can answer questions about the project, the agents, the charts, the studio, and the investor material (high level), and help draft on-brand.
• Team messaging: Jeff, Sol, and Colin can send app-related messages to each other, Slack-like, inside Atlas.
• Full Studio when you want it: compose, iterate scripts, render keepers, browse the library.

Cross-platform: phone AND Mac

Build Atlas as an installable PWA (progressive web app) on the cloud Studio. One codebase, one login (Cloudflare Access), installs on: - iPhone/Android home screen (feels like a native app), - Mac (Chrome/Safari "Install" / Add to Dock), - any browser. So yes, the same Atlas runs on the phone and the Mac, same account, same data.

Mobile optimization

The Studio was built mobile-first, so it should already work on a phone (test studio.affirmology.ai on the phone now). Atlas adds: a polished mobile layout, the installable PWA wrapper (manifest + service worker + icon), the Hermes chat surface as the default screen, voice capture, and the mode toggle. Mobile polish is part of this build.

How it rides the cloud

Atlas needs Render + R2 (24/7 server + durable storage) because it must be available on everyone's schedule, store voicenotes, and carry messages between people. It is the same cloud Studio, surfaced as an app with the Hermes-first, two-mode UI.

Build order (when Render + R2 are up)

1. Move the Studio to Render + R2 (the cloud step).
2. Make it an installable PWA (phone + Mac), mobile-optimized.
3. Add the Hermes chat mode (system + jpl-knowledge connected) as the default, with the one-tap toggle to full Studio.
4. Add voicenote capture and team messaging. Names: the app is Atlas; the in-app assistant is Hermes.