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

Memberships

Clief Notes

43.7k members • Free

18 contributions to Clief Notes
I built Jake's ICM architect skill, but for agency work
Last week, I tried out Jake's icm-architect skill, which he also posted here. There were a few legitimate issues the skill found that needed fixing, and I quickly patched those in my infrastructure. What surprised me, though, was that the structural part itself (which I built before I joined here and started learning about Jake's ICM methodology) was not only completely fine, but when applied to my use case, it was even better than what the skill suggested. Jake's skill is set up for fairly general use cases, as well as for people who don't know how to organize a specific idea or project in a way that works well for agents. After I patched the holes the icm-architect skill found, I gave it some thought and created my own version. I named it Agency ICM Builder. https://github.com/krsnczky/agency-icm-builder The difference is in what it assumes. One folder per client, and keeping them apart is rule two, not an afterthought: any learning whose client is ambiguous goes to a quarantine inbox instead of getting guessed into the wrong folder. In an agency, cross-client bleed isn't untidy, it's a liability. Expertise and state are split the same way, by construction. Departments hold what's true for a service across every client, client folders hold per-client state, and the two never mix. A few weeks ago, I posted here about my memory system, for which I created a public plugin, and this new skill complements it perfectly. You could say the memory kit is the soul/brain of my infrastructure, and this skill helps you build the body around it. Once you plug the memory kit in, you'll have a very strong foundation for your infrastructure. https://github.com/krsnczky/agency-memory-kit It won't fit everyone. If you're not doing client work at all, the client separation is dead weight and Jake's icm-architect is the better starting point. And if you want a framework with a database and orchestration code, this isn't that either. It's markdown files in folders, and that's the whole design.
1 like • 5d
Folder per client here too. In my case they end up not even living on my machine: each client gets a self-contained kit that runs in their own Claude Desktop, and the gates travel inside the folder. So the separation is mostly physical, less discipline required from me. On the full skeleton my habit goes the other way: I hold off giving something a home until it has shown up two or three times. But my clients are small Portuguese businesses, one person deciding everything, so your version probably makes more sense at agency scale than my habit does. The quarantine inbox is the bit I'm stealing.
0 likes • 16h
@Richárd Krusniczky Same instinct on the maintenance side, I just moved the seam. One canonical workspace is where the rules, the checkers and the gates actually live, and the client folders are exports from it, not copies I maintain by hand. A change happens in the source and gets re-exported, never edited in the exported kit. The reason mine have to leave my machine at all: some clients run the thing themselves in their own Claude Desktop, so the kit has to be self-contained. I learned that the boring way. A stage in one of my kits halted because it referenced a skill that lived in my global config instead of inside the folder. The halt was correct behaviour, but it only showed up once the workspace ran somewhere that wasn't my machine. Curious how you handle that case. Does anything ever leave your single infra to run in a client's own environment, or is it always you driving it?
🏆 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."
1 like • 2d
Mine is up too: github.com/jorgeccastro/it-just-says-invalid. It reads a Portuguese SAF-T invoicing file that the tax authority rejected and names the one condition that caused it. What comes back from them is that the file is invalid. No field, no line, no reason. So the whole job is working backwards from nothing. This is not my submission comment, that one comes at the end of the week. What I want before then is someone breaking it. There is a make_fixture.py in there that generates a case with a seeded defect and a decoy, so you can build one I have never seen and run the folder against it blind. Everything checks offline, Python stdlib, no key. The gate is verify.py, and the check I care about is the anchor one: every quoted excerpt has to appear verbatim at the line it cites, so a fluent claim about a line that does not say that fails mechanically instead of reading well. Two limits I would rather say out loud than have someone find. No real file has ever gone through it, since a filing is other people's tax data and I have no consent to publish one, so every fixture is synthetic. And none of the four receipts are blind, I wrote them knowing the answer key. Nine more holes are in OPEN-DEFECTS.md. Happy to do the same for yours. @Phillip Jonker @Jeff Van Leenen, the handoff one and the skill one are the two I would actually know how to break.
What Happens When an AI-created project causes Real Damage?
I’ve been thinking about what happens when an AI agent causes real financial damage. Not a harmless glitch or sloppy wording in an email. I mean an agent sends the wrong quote, invents information that ends up in a client deliverable, exposes customer data, or anything that costs someone actual money. Who is responsible? or I guess the better question is: Who is liable? That matters, of course. But I’m not sure it is the best first question. I think the first question is, What are we doing right now, before something goes wrong, to make sure we are not completely unprepared when it does? Or, since I'm not building for clients yet, the real question is what are YOU doing? Do you plan for this? Do you actually take ownership of the risk? (Legal, IT, operations, the person who built the workflow). I can see AI insurance companies popping up all over the place. 😄 I do not have any of this figured out. I suspect many of us are building faster than we are defining accountability. What are people actually doing in practice? Do you have checkpoints or review processes you trust, or are you still trying to work this out too?
0 likes • 4d
yo, showing up late here, but this question is why I build the way I do. Nothing gets to the client without my say so, and the review is a named step: the quote gets compared against the source before it leaves, not "I glanced at it". And I start every client on cheap reversible work, so by the time anything could cost real money there's already a track record of what the thing gets wrong. The insurance part I don't have figured out either, so... Got to figure that one out for myself.
2 likes • 4d
@Carla Bosteder That renewal detail is nasty, exactly the kind of thing I would have missed. Will have to check how insurers here in Portugal are handling it. Thanks Carla.
Folders DO get messy somehow
I'm running a startup incubator in Suriname and for a young "AI for geology & mining" startup I'm trying to get ICM in the mix: Workflows - for the business aspects design - design, coding and maintenance of the software (front end/back-end) - The actual AI engine running the service, setup, training, optimization, uptime etc. - Monitoring users, errors, UX - Monitoring business progress/KPI's/CAP tables for Stock Splits Anybody knows how best to structure all of this? Best practices? Oh and I manage currently 4 active startups
1 like • 5d
George and Carla covered the structure better than I would. The part I can add is what happened to mine after a few months, because it was organized and it still drifted. My registry said 21 folders, the disk had 22. And two entries were routing to things that no longer existed. I only found out when I audited it against Jake's tool. What changed on my side: each number lives in one place only, and the routing files point there instead of repeating it. And there's now a check that compares the index to what's actually on disk. I run it instead of trusting myself to notice, because clearly I don't. With 4 startups I'd probably want that check in place before the structure grows.
Local PC vs VPS for a scheduled Python pipeline handling PII
Context: I've built a Python pipeline that processes client documents through the Anthropic API on a schedule. It handles PII, so I have compliance obligations. Right now it runs manually on my PC; the next phase adds a scheduler and a webhook receiver. My problem: the plan assumes it runs on my local PC, and that's a bad fit — my internet isn't reliably stable and the machine can't be counted on to stay awake and connected through a busy season. The obvious alternative is a small VPS running everything, with my PC as the dev machine. Questions: (1) Local vs. VPS for this — what would you do? (2) If VPS, what's the minimum competent setup for handling PII? (3) Anything about running a scheduled, webhook-driven Python pipeline in production that bites people who haven't done it before? If it matters for #2 — I was leaning toward DigitalOcean, but open to other suggestions. Thank you in advance. #Rookie
0 likes • 5d
I run something like this, so just describing mine, not saying it's the right way. Small VPS does the scheduled work, my PC is where I prepare things and approve. I'm not a security guy, so my rule was to keep the public side as small as I can manage: admin goes over Tailscale, only the webhook is exposed. And every run sends a short message to Telegram. When nothing arrives, I go look. That's honestly most of my monitoring. What Leonard said about security being your responsibility is the part I wouldn't skip, with PII on the box.
1-10 of 18
Jorge Castro
4
45 points to level up
@jorge-castro-1430
IT Entrepreneur

Active 7h ago
Joined May 15, 2026
Powered by