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

Memberships

Clief Notes

38.4k members โ€ข Free

4 contributions to Clief Notes
Running ICM as a company's shared know-how โ€” where the context tree is also the ISO-audited procedure manual
Most ICM setups I see here are single-operator: one person, one agent, one context tree that's basically externalized working memory. We're running it differently โ€” as the shared know-how of a small engineering firm (~15 people: industrial automation, control-panel building, light EPC). That one shift, from personal to organizational, changes the whole problem. In a company, the context isn't just my memory โ€” it's the procedures everyone has to follow, and procedures have to be governed, auditable, and improvable by people who will never open a terminal. Here's the core of what we've landed on. One markdown source, three readers. The ICM KB โ€” plain markdown in GitHub โ€” is at the same time: - the agent's operating context (what it reads to act: load costs into the ERP, build quotes, enforce the process); - the company's procedure manual, rendered into a navigable wiki โ€” search, cross-links, the graph of how procedures interconnect โ€” which is what employees actually read; - the ISO 9001 controlled-document system, because Git already is change control: versioned, attributed, diffed, immutable โ€” stronger than the Word-on-a-shared-drive most small firms limp along with. No parallel copies, so nothing drifts. Git is the evidence vault; the wiki is the auditor's reading room. (Worth stating for this crowd: ISO 9001 mandates control โ€” identification, approval, versioning, availability of the current version โ€” it mandates no specific format. A git-backed static site clears that bar cleanly.) The agent is the abstraction layer โ€” this is what makes it survive in a company of non-technical people. Nobody learns markdown, Git, or pull requests. They talk. The agent enforces the current procedure while they work; and when someone says "step 3 is wrong, we do Z now," it turns that into a proposed change to the controlled document. The quality lead gets a plain-language summary and approves or rejects. Proposing is frictionless and open to everyone; approving is a controlled human gate. The Git/PR machinery stays invisible underneath.
0
0
ICM is awesome for one person, but what if there is two?
Been building an AI system for our agency for the last several months โ€” custom tools, automations, outreach, all structured so the AI knows what context to pull and when. We run most of it through our own website. Found Jake's content and immediately recognized what we'd been building toward. The ICM framework โ€” structured context over complicated multi-agent setups โ€” we'd been doing a version of this without knowing it had a name. Here's the thing though. Everything I've seen assumes one person running the system. We're two founders. And the team layer โ€” who owns what, how handoffs work, how you avoid overlap when the AI is already handling coordination โ€” nobody seems to be talking about that. Just getting into the classroom so maybe it's in there. Curious if anyone's figured out ICM for a small team or if that conversation is even happening yet.
2 likes โ€ข 4d
Quick context: I'm only ~2 weeks into ICM. The potential is obvious โ€” but instead of building fast and bolting the team layer on later, I want to get that part right from the start. So this isn't a "here's what worked" story. It's a plan I'm about to execute, and I'm honestly not sure it holds. That's why I'm posting. I'm designing it solo, for the two of us plus a small non-coder team across engineering, commercial and admin. Where I'm leaning โ€” separate three things people tend to lump together as "the system": 1. Reusable knowledge (the ICM context) โ†’ version-controlled, one source of truth, changes reviewed before they land. (Github) 2. Project files + binaries โ†’ file server, permissioned per department. 3. Secrets + identity โ†’ local to each person; their agent acts as them, with the permissions they already have in our ERP (Odoo) and email. The system doesn't decide who can do what โ€” our existing tools do. The part I'm least sure about is coordination (Aaron's framing helped here). My rule: the AI only ever reads and writes a local working copy โ€” every handoff and publish is a human action. After a call or field event, the agent drafts the summary, a human validates, and only then is it shared knowledge. The structure is meant to carry the discipline so I'm not relying on everyone being tidy. And for non-coders: git is the backbone, but nobody touches git โ€” the agent commits when someone clicks "validate." Still all on paper. If you've tried something like this โ€” or can see where it breaks as the team grows โ€” I'd really value the reality check before I build.
1 like โ€ข 4d
@Andre Graham` @Curtis Hays thanks for support!
GitHub is dead simple and lets you work your ICM on the go. ๐Ÿƒ๐Ÿš—โœˆ๏ธ๐Ÿš€
The last couple of contests have been pushing people to post repos on GitHub and I must say it has removed a lot of friction in my workflow. It is as simple as using a remote drive and the best part is Claude code on mobile works natively in GitHub. This means for any app, website, or ICM structure you have up there, you can open the Claude app and work right in your folder structure. Have an itching thought about that bug you want to fix while youโ€™re grocery shopping? Just a message away. The dispatch feature is nice but this is so much more natural to use and stay organized with and Iโ€™m loving it!
0 likes โ€ข 17d
Hi all, I share @Ben Bruce's concern regarding repository access. In my case, I need to grant different folder-level permissions within the structure. For example, everyone should access the root level (Claude.md), but subsequent folders should be restricted to specific departments based on their tasks. However, if Claude.md is updated, I need that change pushed to all users across all folders. Additionally, I want to minimize friction for employees. Since they are not programmers, they should not have to interact with GitHub at all; they should only use the Claude Cowork Windows app. I would like to know if this can be solved using GitHub alone, considering the following constraints: 1. Local File Server & Permissions: We are an electrical engineering and industrial automation company. We already have an on-premise file server (Windows Server 2022 with Active Directory) with department-level permissions fully established. Ideally, the second-level folders should live within those existing network directories, but Claude Cowork struggles when working directly inside network drives. 2. User Feedback & Collaboration: A critical requirement for us is that employees must be able to correct errors and suggest changes to the documentation from the app. This is fundamental for us to continuously improve our technical methodology. Can GitHub handle this type of granular access and synchronization natively under these conditions, or do I need to look into a hybrid architecture (such as local git automation scripts or submodules)? Any advice on the best technical approach would be highly appreciated.
Welcome to Clief Notes. Here's where to start.
1. Watch the intro video and introduce yourself in the intro post here 2. Start with The Foundation (free course). Concepts, folder architecture, prompting framework. Everything else builds on this. 3. Check in at the bottom of each lesson. Polls, discussion posts, other members working through the same stuff. Use them. 4. When you're ready to build real things, move to Implementation Playbooks (Level 2). When you're ready to build your own tools, Building Your Stack (Level 3). 5. Post your work. Ask questions. Help others when you can. What are you here to build?
Poll
6758 members have voted
4 likes โ€ข 17d
Hi there! Lot of expectations! Looks very prommising. Hope I can learn and then contribute.
1-4 of 4
Martin Brion
2
12points 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 1h ago
Joined May 31, 2026
Argentina
Powered by