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

321 members • Free

Clief Notes

45.8k members • Free

14 contributions to Clief Notes
How I'm Scaling My CLAUDE.md Setup
I started with a single CLAUDE.md, but as my work grew, it turned into a nested structure, three separate root maps, each routing to its own set of workspaces underneath it, rather than one flat list of projects. My setup: - Personal root map — Routes across everything in my own life and ventures: personal admin, side projects, a festival film concept, everything that's mine, not the company's. - Company capabilities registry — Routes across every AI-driven pipeline the company runs: report builders, a document builder, a video production pipeline, each one its own workspace with its own state. - Company corporate file structure — Routes across the actual document filing system for the whole organization, broken into numbered departments (executive/strategy, finance, standards and templates, and so on), each department getting its own scoped context. What each context includes: - Personal root map — Where each life area or venture actually lives, and a firm rule that company work never gets stored here, it only passes through on its way to the company structure. - Company capabilities registry — Current state of every capability (what's live, what's dormant, what's still pending a decision), plus a routing table so a request for "the video pipeline" or "the cost report" goes straight to the right workspace without guessing. - Company corporate file structure — One CONTEXT.md per department, describing only what belongs in that department and nothing else, plus a generated register acting as the master index across all of them. I'm structuring it this way so each level only has to know about the level directly beneath it, not everything in the whole system at once, which keeps every session focused and fast. This follows the principles of: One fact, one location — Department-level rules live only in that department's CONTEXT.md, never duplicated into the root map or into another department. If a rule changes, it changes in exactly one file.
1 like • 2d
I went in the same direction with my company. Its a multi repo with diferent read and write access for diferent roles in that company. On governance repo read only for all except me (I can write on it) so I can keep ICM metodolgy and Quality Procedures in check.
1 like • 2d
@Jeff Van Leenen Happy to. Short version of what worked for me: - The governance repo being read-only for everyone but me was the best call. Methodology and quality procedures live in one place, so nobody can "fix" them locally and drift away from the standard. - Keeping the shared layer agnostic. My biggest early mistake was baking specific rules into the apps/scripts. Now the base tooling and templates know nothing about any particular workflow — each subrepo adds its own data and rules on top. Things get more specific the deeper you go, never at the root. That's what makes the same base reusable across every flow. - Keeping the repos text-only. Binaries (PDFs, spreadsheets, photos) live on a file server that mirrors the exact same folder tree, and each folder has a small .md index describing what's there. Git stays light and the agent knows what a file is without opening it. What didn't work at first: exactly what you're testing — the routing maps. A new folder without its routing row silently breaks the map above it. What fixed it for me: the agent proposes the routing row in the same session that creates the folder, and I just approve it. It no longer depends on my memory.
Is anyone commercializing ICM as a Product or SaaS?
I am running an ICM knowledge base for my engineering company using GitHub, VS Code, and Claude Code. The efficiency gains in our workflows have been massive, and I see a clear opportunity to offer this to other regional companies as a new business unit. ​However, this dev-centric stack creates too much friction to be presented directly as a product to non-technical clients. ​The model I envision starts with heavy consulting to align the client's processes and culture. Once maturity is reached, it transitions into a managed service: issue tracking, periodic context pruning, and ad-hoc consulting for new agentic features. ​Has anyone here successfully commercialized this philosophy? I am particularly interested in how you package the delivery and abstract the technical friction (like the IDE and repo management) for the end user. Are there platforms already solving this?
1 like • 2d
@Leo Saraiva great insight! Thanks so much!
1 like • 2d
@Junmarvi Tampac I guess you're a bit like me. I'm creating a lot of value within the company I work for because I know the domain deeply, and everyone trusts me. Right now, users are working with VS Code, Claude Code, and GitHub to keep everything in sync and manage read/write permissions. But I don't think that approach will scale across multiple clients. So I'm starting to think about how to deliver value to other clients with the smallest possible app and then build on top of it, as @Leo Saraiva suggested. The thing is, many of the apps I've already developed for my company are essentially productized and waiting for the next implementation. From the beginning, I designed them to be as vendor-agnostic as possible, with interchangeable data models and plugins that can be adapted from one use case to another. That's why it's tempting to think about bringing them together into a complete platform—a sort of "toolbelt" of applications.
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!
0 likes • 2d
READY
From EPC Operations to AI-Directed Engineering
Hey Clief Notes fam! 👋 I’m Junmarvi from the Philippines, currently based in the UAE. I work in materials and operations in the EPC industry, with a Computer Science background. Over time, I’ve moved deeper into AI-directed engineering—designing and shipping production-ready systems, workflows, internal tools, and structured workspaces for agents, context, verification, and standards. My goal now is to keep expanding what I can build, connect with more serious builders, and create opportunities that will eventually allow me to return home to the Philippines and continue this work with my family. Right now, I’m focused on improving how I orchestrate AI across architecture, implementation, security, testing, deployment, and long-term maintainability—while building a stronger network around real-world AI engineering. .
1 like • 2d
Can you please tell us more about the architecture and infraestructure you are using?
Rule of thumb on how many words?
Hi everyone. Is there any rule of thumb on how many words in every layer of an ICM workflow? Im trying to narrow it down in a large repo with many canonical things that apply for every workflow and I have 1263 words in layer 0 and a context routing of 871 words.
1 like • Jul 6
@Bryce McKinley Thank you so much! I was just wondering if there is a way to adding comments that get ignored by LLMs. But as far as I know, they take everything as context no matter what
0 likes • Jul 7
@Johnny L ​Yes. It was Claude itself that bloated everything. So I have to read the whole thing myself and start removing things that belong to other stages. And then I explained asked him to reorder the information in its proper placer.
1-10 of 14
Martin Brion
4
33 points to level up
@martin-brion-9809
Electronic Eng & Ingenia Managing Partner. Implementing an AI workflow to transform our firm and later drive Industry 4.0 value for clients.

Active 14h ago
Joined May 31, 2026
Argentina
Powered by