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

45.7k members • Free

56 contributions to Clief Notes
Have You Talked to the Clief Notes Agent Yet?
We officially launched the new Clief Notes Agent, and I wanted to check in with you. Have you had a chance to talk to it yet? If you have, I’d love to hear how it went. And if you’ve run into any questions, confusion, or issues getting started, drop them in the comments below. The goal is to make it easier to find what you need, know what to focus on next, and get more out of everything already inside Clief Notes. So, How’s your experience been so far?
2 likes • 1d
First thing I asked it was a question more about community activity/post/comment content so it couldn’t answer. I realize now that it’s outside its scope. Was just curious if anyone/how many members have done all the comps so far :)
The Clief Notes AI is live 📣
It’s live. Starting today, everyone in Clief Notes has access to the new Clief Notes AI. The easiest way to use it? Don’t overthink it. Ask it the question you would normally ask me. “Where should I start?” “What should I focus on next?” “Where did you talk about [topic]?” It’ll use what’s already inside Clief Notes to help answer you and point you toward the right lesson or resource when there’s something worth going deeper on. The goal isn’t to give you another AI tool to play with. It’s to make everything already inside this community easier to actually use. If you want Access to it Comment "READY" and we'll send you access to it!
2 likes • 4d
Ready
🏆 WEEKLY COMP #10: THE DIAGNOSTICIAN 🏆
🎟️ PRIZE: FREE SEAT IN THE LYCEUM 🎟️ Pick your cohort. Technical, Business, or Creator. Your call. 📋 THE CHALLENGE Build a folder-based AI diagnostician that reads something broken and tells you WHY it's broken. Not how to fix it. Why it failed. This week's deliverable is one diagnostician folder that someone could drop into a Claude project and use to figure out why something in their world isn't working. 🎯PICK YOUR DOMAIN The domain is yours. Pick something specific. Pick a failure you've actually seen happen. A few sparks to get you thinking: - 📉 Why a landing page isn't converting - 📧 Why cold emails to a specific buyer aren't getting replies - 📋 Why a product spec keeps getting pushed back by engineering - 📄 Why a resume isn't getting callbacks in a specific industry - 🚪 Why users drop off at one step of an onboarding flow - 💸 Why a pricing page isn't converting trials - 🎥 Why a YouTube video underperformed the channel average - 🤝 Why a sales deal stalled after the demo - 📱 Why an app's retention craters in week two The more specific, the better. "Diagnoses marketing problems" is too broad. "Diagnoses why cold emails to enterprise IT buyers get opened but never answered" is right. 🗂️THE METHODOLOGY If this is your first comp, welcome. Here's what you need to know: This week (and every week) you're learning interpretable context methodology. Folders as architecture. Each file does one job well. Your diagnostician is a folder with five things: - 📄 identity.md (who the diagnostician is, what they diagnose) - 📐 rules.md (how they diagnose: what they look at, how they separate cause from symptom) - 💬 examples.md (2-3 example diagnoses showing the reasoning) - 📚 reference/ (common failure modes, diagnostic frameworks, benchmarks) - 📖 README.md (how to use it, what to feed it) Drop the folder into a Claude project. Claude becomes the diagnostician. Reusable. Shareable. Portable. 🔥 THE ANGLE THIS WEEK A diagnostician is NOT an editor. Last comp was The Editor. That one critiques craft. It looks at a draft and says "this part is weak, go fix it."
3 likes • 15d
https://github.com/alydperri/ld-intake-diagnostician L&D Intake Diagnostician When a training project fails, teams usually blame the build or the requester. Often the flaw was in the intake — visible before anything got made. This tool reads a dead project’s paper trail and names the one cause that mattered most, shows the evidence, and explains why the runner-up causes lost. No fixes, no advice, just why it died. Built for LXDs and enablement designers, from the mined judgment of an expert L&D leader. Try it in two minutes: the repo’s test-cases folder has two fake projects with an answer key.
2 likes • 14d
@Arne-Per Heurberg Not dense at all, that's on my phrasing! I’m so deep in it I didn’t realize my description wasn’t the most accessible. I’ll edit the post to make it more clear. It's a diagnostician folder for L&D teams. You feed it the paper trail of a training project that failed (the intake form, emails, completion numbers) and it names the root cause of the failure. "Ruled-out neighbors" was shorthand for how it reasons: like a differential diagnosis in medicine, it doesn't just name one cause, it names the two or three adjacent causes that almost fit and shows the evidence for why they lost. And "no prescription" means it stops at the diagnosis: it tells you why the project died, never what to do about it. That's the line between a diagnostician and a consultant. There's a test-cases folder in the repo with two fake project bundles + an answer key if you want to try it.
🏆 COMP #9 RESULTS: THE EDITOR🏆
📦 EVERY ENTRANT GETS A FEEDBACK FILE 📦 🔍 HOW WE READ THESE Every repo was cloned and pinned to the last commit that was public at the deadline, so nobody was judged on work that landed after the clock. Six repos had later commits. We read the earlier ones. Then we read file by file. Identity, rules, examples, the reference layer, the code. Every self-test in the field was executed on our machine, not taken on trust. And for five folders we did the thing the brief describes: dropped the folder in, wrote a draft that appears nowhere in the repo, worked it through as the specialist, then ran the entrant's own checker on what came back. All five passed their own gate. The landing pages were the doorway. The judging happened inside the folders. 📦 COMP #9: THE EDITOR - THE VAULT 📚 WHAT THE FIELD TAUGHT Three lines split forty-two builds: ✅ Enforcement moved into code. Comp #8's lesson landed hard. Nine entries ship a checker you can run without an API key. Across forty-two rules files, the phrase "use good judgment" appears zero times. ✅ The disguised ask is the real test. Almost everyone refuses "just rewrite it." The builds that went furthest anticipated the request wearing a disguise: ask me questions and assemble it, give me two options, tell me what it should say instead. ✅ The examples file is where methodology broke. Six entries shipped an examples.md larger than their rules.md, holding voice, philosophy and calibration that belonged in identity or reference. Last cycle it was the empty memory. This cycle it was the overloaded examples file. 📦 COMP #9: THE EDITOR - THE VAULT 🥇 THE WINNER @Marcelo Michelsohn. The FICC editor, a proposal editor for one municipal culture fund in Campinas, Brazil. Here is why. Three real proponents ran it on real proposals, with consent, on 22 July, inside the fund's live submission window with money on the line. The method was written down before the rounds ran, so the receipts could not be shaped afterward. Inputs are preserved byte for byte, outputs pasted verbatim, and the errors are still in the transcripts because the method said to leave them there.
0 likes • 15d
Congrats everyone! And thanks again for the feedback Jake and team, really helpful.
🏆 WEEKLY COMP #9: THE EDITOR 🏆
🎟️ PRIZE: FREE SEAT IN THE LYCEUM 🎟️ Pick your cohort. Technical, Business, or Creator. Your call. 🎯 PICK YOUR DOMAIN The domain is yours. Pick something specific. Pick something you'd actually use. A few sparks to get you thinking: - 💻 Code review editor for a specific language and level (junior TypeScript, senior Python) - 📊 Pitch deck editor for pre-seed founders - 🎨 Grant application editor for arts nonprofits - 📄 Resume editor for career switchers into tech - 📰 Op-ed editor for policy publications - 🎙️ Podcast script editor for interview shows - ⚖️ Legal brief editor for civil litigation - 📋 Product spec editor for early-stage PMs - 🎓 Academic paper editor for one specific field The more specific, the better. "Writing editor" is too broad. "Op-ed editor for tech policy publications targeting a policy audience" is right. 🗂️ THE METHODOLOGY If this is your first comp, welcome. Here's what you need to know: This week (and every week) you're learning interpretable context methodology. Folders as architecture. Each file does one job well. Your editor is a folder with five things: - 📄 identity.md (who the editor is, what work they review) - 📐 rules.md (how they critique) - 💬 examples.md (what good critique looks like) - 📚 reference/ (style guides, checklists, frameworks the editor uses) - 📖 README.md (how to use it) Drop the folder into a Claude project. Claude becomes the editor. Reusable. Shareable. Portable. 🔥 THE ANGLE THIS WEEK An editor is NOT a rewriter. An editor doesn't do the work for you. An editor surfaces what's weak and pushes you to fix it. That distinction is the whole assignment this week. When someone hands the editor a draft, the editor shouldn't produce a "fixed" version. The editor should point at the three lines that don't work, explain why, and hand it back to the writer to solve. ✍️ Generic feedback like "consider strengthening your intro" is a fail. Specific feedback like "your intro assumes the reader already knows what a Series A is, but this pub is read by generalists, so lead with the stakes instead of the jargon" is what a real editor does.
3 likes • Jul 18
@Mira Bradshaw thanks Mira! Going in with your lessons from my coach build plus last comp’s feedback from Jake and team. Hoping I show a noticeable improvement this round.
2 likes • 27d
Promo Doc Editor Repo: https://github.com/alydperri/promo-doc-editor Landing Page: https://alydperri.github.io/promo-doc-editor/ A promotion document editor for managers writing promotion cases and for anyone providing promotion feedback. Reviews drafts against a 23-rule rubric — cites the specific passage, names the rule it violates, and tells you what to fix. Never rewrites. Plug in your company's values and leveling guide for org-specific critique, or use it out of the box. Built from years of focus groups with managers, hundreds of real promotion documents, and the patterns that separated cases that landed from cases that didn't. ************** ETA: If I had more time, (besides way more testing) I’d explore a more visual display of the feedback, with interactive highlights on your full draft vs. just a list. Bonus if you could edit and resubmit all from one place, but that’s a whole app and time wasn’t my friend. I’m getting better at ICM in general though - was more confident about my choices in this build. Though there are still things I’m not sure of based on feedback I got from Jake’s ICM skill vs. other feedback and observations. May just be some of these aren’t hard rules, more style choices. Slowly but surely more is clicking. These comps really help me get reps ins. Thanks again for doing them! ETA2: FYI/disclosure - I just noticed there were two files (my templates) I had moved locally and re-uploaded the full folder to github yesterday, but those two also stayed in the old location on github, so I had them in two places on github. I just went in and deleted them from the repo. Hope that's ok! This is my lesson to properly connect Claude Code/VS Code to github so I'm not manually uploading and missing something silly like this next time. I assumed the full folder upload overwrote everything but nope that's not how it works. Duh. Github newb fail 😅
1-10 of 56
Alyshia Perri
5
287 points to level up
@alyshia-perri-2746
Learning systems designer/dev. Cat lady. Trekkie.

Active 4m ago
Joined Mar 31, 2026
Powered by