docs(readme): position Cortex within the four-piece stack - #340
Merged
Conversation
The companion-projects block listed four repos as a flat set of links, which said what they are but never why a reader would install one. It also omitted prd-spec-generator entirely. Reframes them by the problem each solves — what an agent forgets (Cortex), can't see (automatised-pipeline), can't verify (prd-spec-generator), and how it reasons (zetetic-team-subagents) — and adds a comparison table that names the nearest related work for each, including where a neighbour is stronger (codebase-memory-mcp covers 158 languages; spec-kit/BMAD/Kiro generate specs this one verifies rather than replaces). Every count in the table verified against the repos: 97 genius patterns (agents/genius/*.md minus INDEX), 11 problem-shaped skills, 9-file PRD. check_doc_claims.py green. Co-Authored-By: Claude Opus 5 <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.
What changed
The Companion projects block was a flat list of four links. It said what each repo is, never why a reader would install one — and it omitted
prd-spec-generatorentirely.This reframes them by the problem each solves:
and adds a
The rest of the stacksection: one row per sibling with the problem, when to install it, and the nearest related work — including where a neighbour is stronger.Why name competitors
Claiming a niche nobody else occupies is not credible and does not survive a reader who knows the space. Each row states the honest delta instead:
codebase-memory-mcpcovers 158 languages; automatised-pipeline is narrower, but qualifies every impact answerexactorlower-boundrather than presenting a possibly-incomplete list as complete.spec-kit,BMAD, and Kiro generate specs. prd-spec-generator verifies them — it runs as a CI gate over their output rather than replacing them.wshobson/agentsorganise agents by role; these are organised by problem shape.Verification
Every count in the table was checked against the repos rather than carried over from prose:
agents/genius/*.mdminusINDEX→ 97skills/minus_index/_templateand the 8 category dirs → 11python3 scripts/check_doc_claims.pyexits 0.Docs only — no code, no version sites touched.
🤖 Generated with Claude Code