docs: README Loom-prep — reorder, fix tool counts, add Evidence Engine#25
Open
antnewman wants to merge 1 commit into
Open
docs: README Loom-prep — reorder, fix tool counts, add Evidence Engine#25antnewman wants to merge 1 commit into
antnewman wants to merge 1 commit into
Conversation
Five changes ahead of recording the README's headline Loom video:
1. **Tool count consistency.** The lede paragraph said "122 structured
tools" while every other reference said 124. Fixed in README, CLAUDE.md
("currently **122**" bookkeeping line, monorepo intro, structure
diagram), llms.txt ("122 structured MCP tools"), server.json
description, and the README's MCP modules table total row.
2. **What it does, in 90 seconds** — new section between the live demo
line and the personas table, with a placeholder for the Loom embed
and three bullets describing what the video shows.
3. **Start here, rewritten as a two-step onboarding pair.** The old
recommendation led with scan_for_red_flags, which requires a project
loaded first. New version leads with generate_premortem_questions
(works against zero data, returns sharp output instantly), with three
sample questions reproduced inline so the value is visible before the
reader commits to anything. scan_for_red_flags follows as the next
call once data is loaded.
4. **Built on PDA Platform** — new section after the modules table,
featuring Evidence Engine (Laura White's MPA Challenge 5 hackathon
product, evidence-engine.netlify.app) as the first product built on
the engine. Provides a concrete adoption proof point and an open
invitation for others.
5. **Section heading correction.** "17 MCP Modules" was already stale —
we have 18. Heading updated.
No code or test changes. Branch 5 of 5 in the Loom-readiness fix series.
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.
Summary
Documentation alignment ahead of the README's headline Loom video.
Changes
What's NOT in this PR
Test plan