ux.sgit.ai

Newsroom UX Review — newsroom.sgit.ai

Oct 11, 2026 · @Agent

Executive summary

The content and the production workflow are strong; the reader's path into them is not yet built. The site is technically clean (921 URLs crawled, no broken internal links, no script errors on the 10 articles tested), but it is organised around how the newsroom works rather than around what a visitor came to read.

A contact who clicks a link today lands on a 49,715-pixel phone homepage (about 59 screens, 845 links), an unexplained £5.00 balance chip, the version number three times, and 67 articles of roughly 4,500 words each, filed under six topics where one topic holds 35 of them. Tags are not clickable, filters are not linkable, persona links are designed but not live, and the ratings a reader gives never reach you unless they choose to send them.

Five things to fix this week, in order:

  1. One source of truth for articles. sgit.ai is serving five 11 October articles that 404 on the newsroom, and both domains declare themselves canonical for the same pages.
  2. A front page for a stranger. A one-line "what this is and who it is for", three entry doors (security leaders, builders, news people), and the long lists moved off the home page.
  3. Label the money. The chip should read "£5 free reading credit", the first penny charged should be announced, and the ratings should start unselected.
  4. Make feedback reach you. Send an anonymous one-tap rating (or a "tell Dinis" button) by default with clear consent, instead of keeping it in the browser.
  5. Ship persona links (/for/ciso and two or three others) so every contact you send arrives somewhere made for them.

Context

The newsroom is the public argument for two products, and the review judges it on whether a stranger can follow that argument. Three sites carry it:

SiteWhat it isRole for the newsroom
sgit.ai (v0.7.45)Encrypted git for humans and agents: a vault ships data, app and history as one string with a read keyThe technology every article's evidence sits in; 54 published vaults
riskmandate.ai (v1.38.8)Behaviour policies for agents in Gmail, HR, payroll, CRM, enforced in real time with alertsThe commercial product most "Agents & policy" articles argue for
newsroom.sgit.ai (v0.6.4)67 articles since 17 August 2026, written from Dinis's voice notes by an agent newsroom, with a reading meter, personas, collections and a newsletterThe front door for contacts and subscribers

The site's stated promise is "one page, one argument, with the figures, the data and the links to check it". Its design pillars, described in its own articles, are: the story as a graph, corrections that propagate, provenance as the product, and paying for reading after you read. The llms.txt is unusually honest about what runs and what is only designed, which is a real asset.

The audience you named is your contacts and first subscribers: CISOs, security and AI-governance people, builders, investors and media people. They arrive from a link, mostly on a phone, with one question and a few minutes.

Method and review panel

Every finding below comes from the live site on 11 October 2026, measured rather than recalled. I crawled newsroom.sgit.ai (921 URLs, 409 HTML pages), drove a real Chromium browser at phone (390×844) and desktop (1366×900) sizes, rendered ten articles to check images and script errors, and read the pages that explain the positioning, the meter, personas and the synthetic-user study.

The review panel was run as six distinct perspectives within this session, not as separately spawned agents; this chat cannot start sub-agents. Each role read the same evidence with its own question:

RoleQuestion it asked
ArchitectIs there one pipeline, one source of truth, and URLs that will last?
LibrarianCan a reader find everything on a subject, and is the catalogue consistent?
HistorianCan a newcomer follow the arc of ideas from August to now?
DesignerDoes the first screen and the reading page serve a stranger on a phone?
EditorIs the front page choosing for the reader, and is the voice consistent?
JournalistWould a contact understand the story, trust it, and come back?

Worth running next: the same panel as real agents in your Claude Code setup, plus a fourth synthetic-user run against v0.6.4 so the before and after can be compared.

Bugs and broken things

The site has few hard bugs; the serious ones are consistency bugs between sites and labels, which erode trust faster than a broken link.

#SeverityBugEvidenceFix
1HighArticles live on two domains and divergesgit.ai/articles/ serves 5 articles dated 11 Oct (e.g. no-server-by-design, the-agent-is-the-reader) that return 404 on newsroom.sgit.aiPublish once to the newsroom; make sgit.ai link or redirect there
2HighBoth domains claim to be canonical for the same articlesgit.ai/articles/hope-or-enforcement.html has canonical sgit.ai; the newsroom copy has canonical newsroom.sgit.aiOne canonical (the newsroom); 301 or canonical from sgit.ai
3MediumArticle counts disagreesgit.ai says 72, newsroom home says 67, llms.txt says 66Generate every count from one manifest at build
4MediumStale edition labelHome says "Edition of 2026-10-08" above ten articles dated 10 OctDate the edition from the newest item, or label it "Editor's pick, 8 Oct"
5MediumUnbranded 404Missing pages show the default GitHub Pages errorAdd a 404.html with search and the three entry doors
6MediumContent hidden until JavaScript runsbody starts at opacity 0 and only shows on a ready class, with a 1.6 s fallbackRender visible by default; animate only enhancements
7LowAuthor tooling shown to readersEvery article ends with "Posting this article on LinkedIn?" and the cover filenameMove to an admin view or hide behind ?author
8LowFeed titled for the old sitearticles/feed.xml is titled "sgit.ai articles"Retitle "SGit Newsroom"
9LowStudy page reports a fixed bug as currentThe synthetic-user page says 51 vault images 404; all images now load (0 broken across 10 articles)Add a dated "fixed in v0.6.x" note
10LowExtensionless links in one articlefuture-of-news links to /thesis, /portugal, /economics/railsUse the full .html or trailing-slash form everywhere

Checked and fine: 0 broken internal links across 921 URLs, 0 broken images and 0 page errors on 10 rendered articles, robots.txt and sitemap.xml present, per-article canonical and Open Graph images set.

On a phone, the first screen tells a stranger how the site is built, not what it is about or why they should care. Here is what a CISO you messaged sees at 390×844:

[image: First phone screen of newsroom.sgit.ai, 11 October 2026]

  1. A header that takes two rows. The brand, an unlabelled £5.00 chip, Menu, then a GitHub button wrapped onto its own line.
  2. A "For agents /llms.txt" strip above the masthead: useful to agents, noise to a person.
  3. Three lines of metadata (edition date, counts, version) before the title.
  4. A tagline about method ("one page, one argument") with no subject: nothing says agents, AI governance, security or news economics.
  5. A second navigation bar of nine links, repeating the menu.
  6. The editor's note, written for someone who read the last two editions ("Third edition... the last two days").

The lead story appears on the second screen. Below it the page keeps going for about 59 screens: Latest, Highlights, desk notes, collections, the full 67-article list, then a "How they connect" map of every article's links. The menu holds about 60 links in nine groups, mixing reader pages (Newsletter, Collections) with builder pages (Replicate, Admin, Release history, The run log).

Opening any article charges a penny straight away, so the chip changes to £4.99 with no message. The synthetic-user study found this exact moment made a retired reader ask whether she owed money; it is still unexplained.

What the first screen should hold instead: one sentence on what this is ("Field reports on AI agents, their rules and their risks, with the evidence attached"), who writes it (Dinis Cruz, with an agent newsroom, said in the byline area rather than the footer), three doors ("I run security", "I build agents", "I work in news"), and the lead story. Everything else moves below or into the menu.

Findability and information architecture

The newsroom has 67 articles and about 300,000 words, but only one way in: a reverse-chronological list. Everything else that would help a reader find their subject exists in data but not as a page they can land on.

What exists today. Six topics as filter chips on the article list, five collections curated by the Historian, four desk notes, "builds on / continued by" links on every article, a per-article graph, and a search box that matches titles, teasers and tags.

Where it breaks.

Proposed structure. Three layers, each a real page with its own address:

LayerWhat it isPages
Desks (5)Who the content is for, chosen by audience not by internal topicAgent security & policy · Building with agents · Vaults & provenance · The future of news · Strategy & startups
Series and collectionsOrdered sets with a beginning, read in sequenceThe reading meter · Hope or enforcement · The agent team · World News Day · Local news as evidence
Tags (about 40, controlled)Precise subjects, each with a page listing every article and the vault it usesprompt-injection, blast-radius, behaviour-policy, key-management, wardley-maps...

Each desk page should open with "Start here: five articles in order", written by the Historian, then the series in that desk, then everything else newest first. The Librarian should own the tag vocabulary: merge near-duplicates, drop format words, and reject new tags at build time unless they are on the list.

Also add: reading time and a format label on every card; search over article bodies and abstracts (the markdown copies already exist); linkable filters (/articles/?desk=security); and a monthly archive page.

Article page and feedback

The article page has the site's best reader feature, the Five readers block, but puts it behind a wall of metadata and a 250-word italic abstract. On the lead article (about 8,000 words) a phone reader scrolls past a three-line breadcrumb, the byline with two version numbers, 12 tag pills and the abstract before reaching it.

Reorder the top of every article:

  1. Title and a one-line standfirst.
  2. Byline that says how it was made ("Dinis Cruz, written with the SGit agent newsroom"), the date and reading time. Version numbers move to the foot.
  3. The short version: the Explainer's two-minute summary, as three or four plain sentences.
  4. Links to the other reader views (the arc, the deck, the map) as one compact row.
  5. The article. Tags go to the foot, as links, capped at five.

The abstract can stay, but in roman type and collapsed after the first two sentences; long italic text is hard to read on a phone.

The feedback block works as a design and fails as a channel. Three five-point scales sit at the foot of every article:

[image: The meter and rating block at the foot of an article]

ProblemWhy it mattersFix
All three scales start on 3A reader cannot tell "not rated" from "useful", and you cannot eitherStart unselected; record only real taps
Ratings stay in the browser unless the reader sends their whole readingYou learn nothing from the first contacts you sendOne-tap send by default, with plain consent: "Send this rating to Dinis (anonymous)"
"You pay the price" under the usefulness scaleReads as a warning, not a benefit"Your rating sets what this page costs you"
Articles join your reading list automaticallyThe reader did not ask to keep itMake "Keep" a tap
No free-text boxScores tell you what, not whyOne optional line: "What would have made this more useful?"

The "Don't charge me" link is a good idea and should stay. After the scales, the end of the article should offer one next step, not seven: the next part of the series, or the next "start here" article for the reader's desk, then the newsletter.

Synthetic users: what is fixed and what is open

Of the study's findings I could re-check against v0.6.4, two are fixed and eight are still open. The third run (10 October, against v0.6.1) sent five invented readers through the site: four of five left, the average rating was 2.4 out of 5, and 31 findings were logged, six of them blocking.

Finding from the studySeverity thenStatus on 11 Oct (v0.6.4)
51 vault images missing, 10 articles affectedBugFixed: 0 broken images on 10 rendered articles
Top-up page said "simulated" while asking for moneyBlockingFixed: the page now describes one Stripe payment
No contact for a pilot on the Replicate pageBlockingOpen: still no name, email or form
Nothing shows real money movingBlockingOpen: no counts of readers, payments or revenue
How a writer gets paid is unclearBlockingOpen: the site states nothing is paid upstream yet
£5.00 chip has no labelWorth fixingOpen
First phone screen does not say what the site isWorth fixingOpen
Balance drops a penny on opening a page, with no noticeWorth fixingOpen
"Credit can go below zero" reads as a debtWorth fixingOpen: same wording on the account page
Byline names one human; AI authorship is in the footerWorth fixingOpen
Three version numbers for one siteWorth fixingOpen: three on the desktop first screen

Not re-checked: the developer-only install steps, the missing plain-language paragraph for writers' readers, and where "How the meter works" leads.

The study's five personas are a good fit for your real audience, with one gap: none of them is a CISO or a security buyer, who are most of the people you will send links to. Add that persona, run a fourth study against the next release, and publish the before-and-after scores side by side, as the homepage rebuild articles did.

Benchmarks from other news sites

Established news sites solve the same two problems this one has: separating fact from view, and turning an archive into places a reader can arrive. Five patterns transfer directly.

PatternWho does itWhat to take for the newsroom
A fixed article structure that splits the facts, the writer's view, counter-arguments and other perspectives into labelled sectionsSemafor's "Semaform" (Semafor, CJR review)A labelled top block on every article: The news, Our view, The evidence (vault link), Room for disagreement. Your evidence-first voice fits it naturally
Topic pages generated from tags, which grow as each article is published and act as entry points from searchCommon CMS practice (Surf New Media)Desk and tag pages built from the article manifest at release time
Evergreen hubs that keep sending readers long after the newsPublisher evergreen strategies (FIPP on Ebner)Most of your articles are evergreen; give the strongest ones an "essential reading" page per desk and refresh them by version
Audience segmentation by topic to see which subjects each audience comes forReach's portfolio work (Press Gazette)Use the ratings, once they reach you, to see which desks each persona rates highest
Short newsletter summaries leading to long readsNewsletter-first publishers (general practice)The newsletter already does this; add a one-line "why you" per item once persona links exist

Where this site is already ahead of most newsrooms: published method, version history per article, public corrections, evidence in openable vaults, and an honest list of what runs versus what is designed. The job is to put those strengths one tap away instead of on separate pages.

Panel perspectives

All six roles reached the same conclusion from different directions: the newsroom has outgrown a single front page and needs desks, an owner for each, and a feedback loop that reaches the editor.

RoleWhat they sawTop recommendationAlso
ArchitectTwo domains publishing the same articles, counts that disagree, no single manifestOne content source and manifest; sgit.ai reads the newsroom feed and links outStable URLs per desk and tag; a branded 404; checks that fail the build
Librarian12 tags per article, no tag pages, tags mixing subjects, formats and productsA controlled vocabulary of about 40 tags, each with a pageFormat and reading time as fields; full-text search over the markdown copies
HistorianThe arc since 17 August is clear in the desk notes and invisible elsewhereA "start here" path per desk, five articles in orderSeries navigation ("part 2 of 5"); a monthly "what changed" page
DesignerFirst phone screen spent on chrome, metadata and a second menuA stranger's first screen: what, who, three doors, the leadOne navigation, not two; split reader menu from builder menu; visible without JavaScript
EditorThe front page tries to show everything; the editor's note assumes a regular readerCut the home page to lead, three per desk, collections, newsletterWrite the note for a newcomer; date the edition from the newest article
JournalistStrong stories, but the news line is buried under methodA two-sentence "the news" paragraph at the top of each pieceByline that names the agent newsroom; a correction box when a version changes the claim

The one disagreement worth noting: the Architect wants the "For agents" strip kept on every page, and the Designer wants it off the first screen. Both are satisfied by moving it into the footer and the page head (as a link rel), where agents look anyway.

Publishing pipeline

The writing pipeline is mature; the release pipeline needs checks that catch reader-facing problems before readers do. Every bug in this review would have been caught by an automated check at build time.

One path from voice note to reader:

  1. Draft in the newsroom vault, as now.
  2. Classify: the Librarian assigns one desk, a format, up to five tags from the controlled list, and any series with its position.
  3. Reader views: the five readers run, and the Explainer's two-minute summary becomes the article's "short version".
  4. Manifest: one file lists every article with its fields. Counts, desk pages, tag pages, feed, llms.txt, sitemap and the sgit.ai teaser block are all generated from it.
  5. Build checks (fail the release if any fail): broken internal links and images; one canonical per article; counts match the manifest; tags on the list; edition date equals the newest article; no author-only blocks in reader pages.
  6. Stranger test: a short synthetic-user run on the front page and the newest article at phone size, scored against the last run (baseline 2.4 out of 5).
  7. Publish to newsroom.sgit.ai only; sgit.ai picks up the feed.
  8. Learn: a weekly digest of ratings and free-text replies goes to the Editor, who adjusts the front page and the next week's pitches.

Release notes for two audiences. The release history is engineering-facing. Readers need a short "What's new on the site" line in the newsletter instead, and the version badges can leave the reader pages.

Scaling the desk. As output grows past a few articles a day, give each desk a standing editor role (an agent with a policy) that owns its start-here list and its weekly round-up. The Historian then works across desks, which is what it does best already.

Since v0.6.4: what v0.7.1 changed

v0.7.1 closed the biggest content bug and shipped persona links; the first screen is unchanged. Checked on 11 October against the live site.

ItemStatus in v0.7.1
11 October articles missing from the newsroomFixed: all six are live, the count is now 73
Persona links (/persona/founder/ and four others)Shipped, with an index page, copyable links and links.json for agents
PaymentsReal Stripe top-up live since 11 October, per the publishers page
"Edition of 2026-10-08" above articles from 10 and 11 OctoberStill open
Version shown three times on the first screen (v0.7.1)Still open
Unlabelled £5.00 chip, "For agents" strip above the masthead, two menusStill open
Founder persona page says "the picks above" but no picks rendered in a phone browserNew: check the landing view renders without a prior visit

The direction: a publication with a heart

Treat the newsroom as a publication first and a demo second: it should read as professionally as any major news site, with a clear subject, a named author and a stated purpose. Today the masthead describes a method ("one page, one argument") and the menu is half about how the site is built.

Name the heart. The content already has one: practical thinking on AI, agents and the next generation of software and publishing, by Dinis Cruz, written with the SGit and RiskMandate agentic teams. Candidate framings for the masthead line:

Split the site in two. One shared design, two clearly separate areas:

AreaPurposeWhat goes there
The publicationGet read, get returned to, get recommendedFront page, personas, desks, articles, collections, newsletter, desk notes, your reading
The workshop (how it is built)Show the method so anyone can copy itDesign and thesis pages, how the newsroom runs, replicate, the meter's design, World News Day, the archive, release history, admin, synthetic-user studies

The top menu carries the publication; the workshop gets one menu item and its own front page. Builder links leave the reader's first screen.

Write a purpose page ("Why this exists"), linked from the masthead and every byline. It should say plainly:

The goal of the next phase is the path from first click to a conversation:

  1. Arrive through a persona link someone sent.
  2. Read the first article and rate it.
  3. Come back: a new pick, the newsletter, or the reading board.
  4. Ask: what is missing, a new version of an article, a topic.
  5. Act: try sgit, talk about RiskMandate, or put their agents on a problem.

Every page should be judged by which step it moves a reader to next.

Personas as the core primitive

The homepage should become one persona among many: "The newsroom", the neutral one. Every persona, including that one, is the same front-page template filled from a persona file, so the founder's front page looks and works like the main site, customised to the founder.

What the persona pages do today. The index is clear and the five cards are well written. Each persona page is a list of seven starting articles plus an explanation of how the link works. Opening it adds the persona to the reader's browser without asking. It has no story, no opinion, no sections and no next step, and the picks it refers to did not render on a phone.

Anatomy of a persona mini-site:

PartWhat it holdsFounder example
MastheadPersona name and one line on who it is for"For founders: what to build, charge, secure, and when to stop"
The storyThe situation the content was written for, in a paragraphA founder with a working prototype, early users and an investor meeting in a month
Dinis's noteAn opinion, first person: why these, in this order"If we have met, this is what I would want you to read first"
Start hereThe ordered queue, three to seven articlesThe current seven, re-ordered as a path
SectionsFive or six desks specific to the personaSee below
Your boardThe reader's Kanban for this personaNew · Reading · Follow-up · Done
What is missing?One question, sent through the append lane"What would you like me to write for founders next?"
Other readersLinks to the other personasSecurity lead, AI builder, board member

Founder sections, filled from articles that already exist:

SectionStarting articles
Ship the productFor a startup, the most important question is whether they miss it · Price it, then give it away
CommercialiseThe SaaS apocalypse will be decided by inertia · Send an agent, not a spreadsheet · Pay after you read
Licensing and open sourceOpen source is not free · An open AI governance framework, and what its licence let us build
Quality and when to stopKnowing when to stop · Every mistake added a rule · Agency is not a yes
Secure your agentsWho are you protecting against? · Hope or enforcement · Footprint and blast radius
Sell your agentsTen hard questions for RiskMandate · The Mandate Stack

The persona file (kept in a vault, as the persona link brief proposes) holds: id, name, one-line description, story, Dinis's note, sections with their article lists, start-here order, and the "what is missing" question. The neutral newsroom persona has the same fields, written by the Editor. Personas for a single person (a founder you met last week) use the same file in a private vault, readable only by whoever has the link.

Ask before adding. Opening a link should show the persona and offer "Read as Morgan" and "Keep Morgan", rather than silently adding it to the reader's browser.

Reader primitives on the article

An article should know its relationship to the reader, and show it in a right-hand column that acts as the reader's own metadata for the piece. The reading meter already tracks part of this; the rest is new.

The primitives:

PrimitiveWhat it recordsHow it is set
RecommendedWhich persona recommended it, and whyPersona file, or Dinis's note
StatusNew, Reading, Follow-up, DoneAutomatic from scroll depth, overridable by the reader
ProgressShare read, as the meter measures it nowAutomatic
HighlightsSelected passages, Medium-styleSelect text, tap Highlight
NotesThe reader's own observations, on a highlight or the whole articleTyped in the side column
RatingUsefulness, more like this, level of detailThe existing scales, unselected by default
Questions askedWhat the reader asked the article, and the answersTalk to the article, below
Request"I need a new version of this" or "write about X"One tap, sent through the append lane

The side column (a bottom sheet on a phone) shows, top to bottom: why this was recommended and for which persona, progress and status, your highlights and notes, your rating, "Ask this article", and the next article on your board.

The reading board. Each persona gets a small Kanban board with four columns: New, Reading, Follow-up, Done. Opening an article moves it to Reading; reaching the end moves it to Done unless the reader drags it to Follow-up. New articles that match the persona arrive in New, which gives a returning reader a reason to come back. The board sits on the persona's front page and in the account.

Talk to the article. With a local model in the browser (Gemini Nano in Chrome, and the MVP described in A model in the tab), the reader can ask the page to condense itself, explain a term, answer a question or suggest related reading. Nothing leaves the device. Every exchange is logged with the article's other primitives, so the reader's notes, highlights and questions build into one record.

Where it is kept. In the browser's storage now, like the meter. Later, in the reader's own encrypted vault, which also solves the problem of a persona on a laptop and another on a phone. Exporting it should be one click, as the meter's JSON export is today.

Feedback lanes and the publishers page

The write-only encrypted lanes that carry subscriptions and reading shares are the right channel for all reader feedback; they just need to be used for more, and to give the reader a receipt.

Use the lanes for:

The lane only answers "ok" by design, so the browser should keep its own receipt ("Sent to Dinis, encrypted, 11 Oct") in the side column. On the newsroom side, the list agent files each item, the Editor gets a weekly digest, requests become pitches on the board, and anyone who left an email gets a reply when their article ships.

The publishers page should move to newsroom.sgit.ai/publishers/. It is the best pitch on either site: a one-paragraph summary, a five-minute tour, a table of what is live, an honest list of what is not done, and a direct ask. Move it, redirect the sgit.ai address, and:

Roadmap: now, next, later

The order follows one rule: fix what breaks trust first, then build the doors, then grow the newsroom. The gate between phases is a synthetic-user run that beats the last score.

Now (this week): trust and first impressions

Gate: fourth synthetic-user run, with a CISO persona added, scores above 2.4.

Next (2 to 4 weeks): findability

Gate: first 20 real contacts sent persona links; at least half leave a rating.

Next, added 11 Oct: the publication and persona mini-sites

Gate: ten founders sent the founder link; track how many return within a week and what they ask for.

Later (next quarter): grow the newsroom