docs: align README with omadia.ai brand and de-slop the copy#375
Merged
Conversation
Four issues flagged on the README: AI-tell prose (em-dashes everywhere), an
off-brand hero claim, a weak intro paragraph, and a banner that did not match
omadia.ai.
- Banner: replace the mid-teal "Lagoon" splash with the on-brand treatment from
omadia.ai — dark navy (#03121D), white wordmark, cyan light-arc (#6FC8D6),
and the official "An Agentic OS for professionals" tagline (cropped from the
site's og image)
- Claim + intro: drop the generic "spin up a team of agents" line; lead with
the trust/audit differentiator in the site's voice (steer, audit, prove;
data stays in the house; checked before it ships; config, not code)
- De-slop: remove all 38 em-dashes and marketing tells ("the moat", "table
stakes", "built in, not bolted on", "confidently wrong", "the answer to…");
reflow term/definition lists onto colons and short declarative sentences
- Merge stays: single Why table, inline pitch video, demo gif in First run
No technical claim changed; code blocks, the architecture diagram, and all
links are untouched.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The banner baked the "An Agentic OS for professionals" tagline in Days One. On omadia.ai only the wordmark is Days One; the claim line is the body font. - Re-crop the banner to wordmark + light-arc only (drop the baked tagline) - Render the claim as a markdown heading below the banner, so it picks up GitHub's default font instead of Days One Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The wordmark-only banner (no baked tagline) was already committed correctly, but GitHub's image proxy kept serving the previous banner (with the Days One tagline) from cache at the unchanged path. Rename to a fresh URL so the correct banner is fetched. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addresses four pieces of review feedback on the README.
1. Banner now matches omadia.ai
The previous mid-teal "Lagoon" splash was off-brand. Replaced with the site's actual treatment — dark navy
#03121D, white wordmark, cyan light-arc#6FC8D6, plus the official tagline "An Agentic OS for professionals" (sourced from the site's own og image and cropped to a 3.2:1 banner).2. Hero claim is on-brand and sharper
Dropped the generic "Spin up a team of AI agents that does the work…" (not used on any other channel, and it describes any framework). The hero now leads with omadia's actual differentiator — trust/audit — in the website's voice.
3. Intro paragraph rewritten
Removed the marketing-AI intro and replaced it with copy that mirrors omadia.ai: steer, audit, and prove · data stays in the house · checked before it ships · config, not code.
4. De-slopped
No technical claim was changed; every code block, the architecture diagram, and all links are untouched. Builds on #373 and #374.
🤖 Generated with Claude Code