Activity
Mon
Wed
Fri
Sun
Jun
Jul
Aug
Sep
Oct
Nov
Dec
Jan
Feb
Mar
Apr
May
What is this?
Less
More

Memberships

Clief Notes

30.5k members • Free

12 contributions to Clief Notes
Markdown Hard-Wrapping Is an Inherited Convention That Hurts LLM Workflows
If you build with Claude or any LLM as an active collaborator rather than autocomplete, this one is worth a look. TL;DR Hard-wrapping markdown at 80 characters is a 50-year-old terminal convention that LLMs now reproduce by default because their training data is full of it. In an LLM-collaborative workflow it actively hurts you: diffs balloon, grep misses matches, retrieval chunks badly, and model output drifts when half your files use the convention and half don't. The fix is to stop hard-wrapping anywhere in your project, pick semantic paragraphs (one paragraph per line) or semantic line breaks (one sentence per line) per folder based on how that folder's content gets read and edited, and let your editor handle soft-wrap for display. Treat project files as a runtime, not as documentation. The discovery I came across a Claude system prompt (https://pastebin.com/C0s47rjV) posted to Reddit, dense and content-rich but only 71 lines long, with each paragraph sitting on a single line. Then I looked at my own project files. Around 100 markdown files of decision logs, architecture specs, reference docs, and glossaries, and most paragraphs were broken across multiple lines with manual newlines at roughly 70-80 characters. Same amount of text, two to three times the line count. The system prompt was written for a machine to read. Mine were written by following an inherited convention without anyone noticing. How the convention got there The 80-column rule is roughly 50 years old. Punch cards were literally 80 columns, VT100 terminals inherited the width, and early Unix tooling assumed fixed-width displays everywhere. Email reinforced it with RFC 2822 recommending 78 characters. By the time Markdown was invented in 2004, every developer had internalized "wrap at 80" as a virtue, and Gruber wrapped his own examples that way. The spec never required it, GitHub renders unwrapped markdown identically, but the convention propagated through every README, every dotfiles repo, every "how to write good docs" tutorial.
0 likes • 6h
@Josh Harper I figured I’d include it. I hate the posts you can just tell right away. I did put some small effort in to this one lol. Or at least with AI it feels small… It’s the least I could do since it did 90% of the writing. I just directed it in chat once I felt like I ran through the theory enough. I don’t have a ICM structure set up yet with my personal voice for stuff like this, been to focused on my actual projects and haven’t needed to do any external documentation or set up other workflows yet.
1 like • 6h
@Yucky Yuckyyyy you can’t even tell with some editors. Just look at the line counts in VS code next to a text paragraph. Is there 1 line or 5, they might look the same. 5 lines make it look nice to you and me but an LLM doesn’t care about looks when it comes to text context. I have Claude author most of my md files for the project I’m working in. It lets me work though separate decisions with project wide implications.
Highest signal to nosie MD file length
What has everyone found to be their sweet spot when it comes to the line length of thier MD files? Wouldn't it be more efficient to have fewer lines in a markdown file but have them be higher quality? You would likely need to create more MD files, which will take more time. However from my understanding it's easier for LLMs to process higher quality MD files with more files than the other way around. I was wondering what everybody else thought of this.
2 likes • 8h
I just came to a realization this morning, having to do with MD files and line count. Gonna make a post about it. Here’s the TLDR Hard-wrapping markdown at 80 characters is a 50-year-old terminal convention that LLMs now reproduce by default because their training data is full of it. In an LLM-collaborative workflow it actively hurts you: diffs balloon, grep misses matches, retrieval chunks badly, and model output drifts when half your files use the convention and half don’t. The fix is to stop hard-wrapping anywhere in your project, pick semantic paragraphs (one paragraph per line) or semantic line breaks (one sentence per line) per folder based on how that folder’s content gets read and edited, and let your editor handle soft-wrap for display. Treat project files as a runtime, not as documentation. Basically I saw source prompts from anthropic and realized this thing has as much text as my Md files but it’s 2-3x less lines. So I put it to Claude and my project. It’s a mess, half my project is hard wrapped, the other half isn’t. But I didn’t know because my editor was soft wrapping everything. Only clue was the line counter.
Compact or new session?
Not sure if there is a right answer here or if it's a preference thing but my question is do ya'll compact a session or take that as a hint to wrap up current work and start a new session? I'm using VS Code and when I see the auto compact about to set off, I ask claude to update the respective .md files in the workspace to wrap up the session. Is that less efficient than just compacting? I suppose my thought process was if the .mds inside the workspace are lean enough then a new session would be more token efficient than compacting.
2 likes • 10d
I will let it compact to complete a task if it needs too. But I try to break work into manageable tasks. I usually use like 90% of the window and occasionally have to compact. At the end of every session it rewrites session-context.md so code is actually is aware of where I am in the project going into new sessions. I am always reviewing the output before I stage and push to GitHub.
Skills and Tools in ICM
Hoping to get a few questions answered on skills/tools based on the resource materials and examples from the classroom. 1. Do you guys keep a "global skills" folder at the project level (ie. for skills used for multiple workspaces)? That way you don't have to maintain the same skill in multiple places? 2. In the workspace-blueprint example, it says "skills work best when they're wired into the CONTEXT.md files. I asked Claude how to "wire" (which I assume just means making it accessible via backslash) and Claude said it needs to exist in the .claude/ folder, but I don't see this in the example. 3. The example also states "you can wire up to 15 skills per workspace". I don't see this limitation in any documentation - is this just a suggestion? If so, why? If you invoke a skill by name or md, why would you want to limit the number of skills in a workspace - if the ICM works as intended, it should only load in the specified skills.
Skills and Tools in ICM
1 like • 22d
The goal is for you not to tell Claude to use the skill in every prompt. Based on your Claude.md and subfolder context or readme it will be clear to Claude that when performing “this” task out of “this” folder or with “these” documents, that “this” skill or combination of skills are used. That means a skill can be targeted at specific tasks or even globally. .claude/skills are where skills are stored. When you package a .skill using the skill creator skill it turns it into a .md file and accompanying reference sub folder with more Md files if applicable. It does get confusing because there is a .claude in your project folder and in your program files. When using Claude desktop app it reads the skills from program files and mounts it to a little server it spins up to work. It’s where you upload them in settings inside claude desktop app. When you use code in terminal or inside of Vs code then it reads them from folders in the project. I personally have a separate skills folder in my project, that only exists for git hub repo, the canonical copy is in .claude. I have to do a sync every-time I create or update a skill, and a repackage of the skill just in case I use the desktop app. The bottom line is that Claude should know what skills to use and when, automatically. For example. I created a custom ui design skill. It’s has rules and branding among other things. When I ask Claude to create a wireframe and we work out the details or it reads my documentation. It knows automatically that when it produces the wireframe it needs to use my ui design skill to do so. I don’t have to ask it. The instructions for it to do so are set up within the workspace folder architecture. I don’t have an answer to the 15 skill limit question. Hope this helps. It truly was a nightmare getting the skill update working as I was using both the desktop apps and code in vs
Point Farming
The amount of posts that are nothing more than copy paste of other peoples work for like farming makes for another facebook or x. the fact that there are real incentives to gain points in the community only makes this worse. as someone who produces genuine novel content i find it very frustrating to see all the copy paste thats nothing but point farming.
6 likes • 22d
The worst is the totally obvious Claude copy paste. It’s kinda embarrassing. This course literally teaches you how to make Claude not sound like Claude, but reference your own voice and tone. It should be easy to generate responses that don’t sound like ai if you actually learned something here and implemented it.
1-10 of 12
Tristen Andre
3
39points to level up
@tristen-andre-4299
Artist, fabricator, designer

Active 2h ago
Joined Apr 9, 2026
Powered by