docs(xish): add CLAUDE.md + processor flow overview docs#1370
Merged
rafegoldberg merged 4 commits intonextfrom Mar 13, 2026
Merged
docs(xish): add CLAUDE.md + processor flow overview docs#1370rafegoldberg merged 4 commits intonextfrom
rafegoldberg merged 4 commits intonextfrom
Conversation
rafegoldberg
requested review from
davinhazard,
eaglethrost,
kevinports and
maximilianfalco
erunion
reviewed
Mar 11, 2026
| These are all things that can't be handled as proper unified plugins (parser extensions or MDAST transformers) because the problems occur at a level below — or orthogonal to — the tokenizer. The parser would either misparse or reject the input before any transformer gets a chance to act. So the raw markdown string is patched first, and then artifacts of that patching (like the snake_case mapping) are cleaned up by corresponding transformers later in the pipeline. | ||
|
|
||
|
|
||
| ``` |
Member
There was a problem hiding this comment.
Something I've been thinking about lately, and not something you need to address, is that Jest shipped a change recently to reduce their output when it's run by an LLM in jestjs/jest@3f17932. I wonder what the impact of the whitespace and ASCII tables within these Claude files are towards our token usages, and if rewriting them as Mermaid diagrams would cut that down at all.
eaglethrost
reviewed
Mar 12, 2026
eaglethrost
reviewed
Mar 12, 2026
eaglethrost
reviewed
Mar 12, 2026
Contributor
|
Thanks for setting this up @rafegoldberg ! Have some suggestions to add on |
see https://github.com/readmeio/markdown/pull/1370/changes#r2921682554 Co-authored-by: Dimas Putra Anugerah <63914983+eaglethrost@users.noreply.github.com>
kevinports
approved these changes
Mar 13, 2026
see #1370 (comment) Co-authored-by: Dimas Putra Anugerah <63914983+eaglethrost@users.noreply.github.com>
rafegoldberg
deleted the
docs/xish/add-claude-md+processor-flow-overview-docs
branch
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
4 participants
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.
🧰 Changes
CLAUDE.mdfileMDXish Processor Overview.mdfile for Claude🧬 QA & Testing
Run Claude Code in your local clone; does it read from the
CLAUDE.mdfile correctly?