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

Memberships

Clief Notes

43k members • Free

19 contributions to Clief Notes
Why Ontology Makes ICM Better for AI Reasoning
Most AI workflows fail for the same reason: they treat context as a blob instead of a structure. ICM solves part of that problem by staging context through folders, markdown files, and step-by-step workflow design. But ICM becomes much more powerful when you add ontology, because ontology gives the workflow a shared semantic model: what the entities are, how they relate, and which concepts belong in each stage. That is the difference between “a well-organized prompt system” and “a structured reasoning system.” Why ontology matters Ontology is not just vocabulary. It is the relationship layer that tells an AI system how to interpret a domain. For example, in a hospital policy workflow, ontology can distinguish: - Policy - Goal - Constraint - Regulation - Requirement - Evidence - Workflow - Approval - Audit Without ontology, the model may understand these as related words. With ontology, it understands them as connected concepts with specific roles. That makes reasoning more reliable, especially when the task requires multiple hops across a domain. Why this matters in ICM ICM already helps by loading only the context needed for the current stage. Ontology makes that staging meaningful. Instead of loading everything at once, the workflow can load a scoped ontology for each step: - Intent stage: Policy, Goal, Stakeholder - Compliance stage: Regulation, Requirement, Evidence, Violation - Operations stage: Workflow, Role, Approval, Audit Now the model is not just reading context. It is traversing a domain structure in small, controlled steps. That reduces noise, improves traceability, and makes each intermediate reasoning step easier to inspect. Concrete example Imagine a demo project that analyzes a hospital AI policy. Stage 1 extracts the policy intent. Stage 2 checks compliance against regulations. Stage 3 translates the findings into operational guidance. Each stage uses a different ontology slice, but all three stages share the same semantic backbone. That means the model can move from “what is this policy trying to do?” to “does it meet the requirement?” to “how should the team implement it?” without losing meaning between steps.
1 like • 2h
@Gabriel Azoulay Great insight. I'll try to wrap my head around how to implement scope enforcement in my next iteration. It might take me a while, though, I'm only working on this on Fridays. My goal is to make the "magic" more explicit. These concepts and the way they work together aren't new, but now we can take them out of complex code patterns and mathematical formulas and express them in plain English in a human-friendly file.
0 likes • 1h
@Chandler Dufour I actually like the direction. My only question would be where you draw the line between the ontology itself and the execution layer. To me: - Objects and Properties clearly belong in the ontology. - Actions can also fit if they're modeled as relationships or capabilities of those objects. - SDKs, Tools, and Automations feel more like implementation details unless they're first-class concepts in your domain. - Versioning and Branching look more like lifecycle metadata than domain semantics, although they could absolutely be represented if governance is part of the ontology. The way I've been thinking about ontology in ICM is as the semantic backbone that helps the model understand what things are and how they're related. The workflow, tools, and execution layer then consume that semantic model rather than becoming part of it. Overall though, I think the separation between entities, behaviors, and execution is a really interesting direction.
How does the Clief Notes COmmunity keep context lean?
A priming bundle grows without anyone ever deciding to grow it. Mine reached a 106 KB markdown file going into every fresh chat before I noticed I was spending most of an opening context window on orientation the job did not need. - The files grow, the bundle never gets re-scoped - each markdown earns a few lines a week and nobody re-reads the total. - Orientation is paid per spawn - every new chat pays the full size again, whether that job touches any of it or not. - Size is checkable, relevance is not - a byte count is trivial to gate on, whether a file earns its place in this specific job is not. What I run now is a size gate rather than a curation step. The priming script assembles the bundle, checks the total, and if it is under threshold it goes. If it is over, the loop running in the background trims on its next pass rather than blocking the spawn. Crude, but it fails in the right direction, because I never get stopped from starting work and the trim happens on the loop's clock instead of mine. It is still a blunt instrument. Size is a proxy for the thing I actually care about, which is whether a given file is load-bearing for this particular job, and a byte count cannot tell me that. So this one is a question rather than a share. How are you handling it - retrieval instead of pasting, per-job bundles assembled by task type, a summarisation pass, or third-party tooling I have not looked at properly? I am more interested in what has actually held up in practice than in what should work on paper.
3 likes • 1d
Did you tried to make or concepts atomic and relation linked? That could make the priming bundle task fluid, in a way you do not sent the full 106kb every time only a partial. For stale rules im trying self-improvement, had a makeshift process but now im following the microsoft SkillOpt, is not it's original intent, but somehow most of the time works. First one works but add some hopping, second seams like its working, but not 100% sure yet.
0 likes • 2h
@Alex Brown Maintenance is hard. I just assumed there's no way around it.
How to scale the ICM method to a large multi-domain system?
Hi all, Before I get to my questions, I want to thank Jake for such a valuable resource in his ICM / F&F method. I am an AI and coding newbie, and this has definitely put me on the fast track. I knew I needed something like this, I just didn't know how to even start looking for it, and then the YouTube algorithm served it up for me. The moment I saw what Jake was teaching, I knew it was my next step in the journey. Thank you! On to my questions. I have gone through the Foundation Course, and I have the full Workspace-Blueprint template. The three-layer method (Map, rooms, tools) has become how I actually work, and I have been running it for a little while on smaller projects. Here is my situation. I am building the operating system for a multi-industry business group, and it has grown into several distinct domains: - an identity and philosophy layer: governing principles, values, and leadership and management philosophy, synthesized from a body of books and courses, - a knowledge layer: a large reference library plus custom tools that extract and organize knowledge from books and transcripts (several thousand files), - a research layer, - an operations layer: SOPs and playbooks for running the businesses, - a learning layer that captures lessons and feeds improvements back in, - a governance layer that holds the enterprise map. Right now this lives across roughly ten separate Claude projects that grew organically. Some began as tools, some as libraries, and each became its own project. Many are stages in a workflow. So, work completed in one "stage" needs to move into another. Most of this was built before I discovered Jake. I am fairly certain I need to reorganize what I have already built, and I am also considering turning some, if not all, of the skills I have created into file-based workflows. The method is taught at the scale of one folder with a few rooms, and mine is well past that, so I want to be sure I am applying it correctly rather than drifting into the "too many workspaces" problem at the project level.
1 like • 3d
This week I was able to include ICM in a big project. I spent three days trying to fit the entire project into ICM, then gave up. I then proceeded to use ICM as a small layer instead. The Problems: - LLM context weighting: the beginning and the end of the context window are more important than the middle. - Large contexts can exceed an LLM's maximum token limit. - Larger contexts mean higher costs. The Solution: I'll use your separation of concerns as an example. Identity and philosophy layer: Atomic notes + Ontology Index. This allows your harness to pick the exact pieces it needs as context for a given task. You also don't need to repeat information or manually feed context, which becomes nearly impossible when dealing with large amounts of content. Knowledge layer: If this is a large body of documents, the best solution is RAG. Yes, frontier models have larger context windows that are harder to exhaust, but if you send a 300-page PDF and the information you need is a single 200-word paragraph, you're poisoning your context. Research layer: If this is an ephemeral layer (intermediate artifacts that support a later process), let it remain ephemeral. If it's permanent, smaller pieces of content work better as file assets, while larger content is better off being vectorized. Operations layer: This is where I found ICM really shines and outperforms every other technique I've tried. Learning layer that captures lessons and feeds improvements back in: Just create a Skill whose output is saved to a specific folder in your ICM. You can then use it to continuously improve your ICM over time. (I was experimenting with this last week when I found this: https://microsoft.github.io/SkillOpt/. It's designed for self-improving Skills, but it works just as well with ICM.) Governance layer that holds the enterprise map: In my opinion, this should be a playbook within the ICM that every deliverable is required to follow. Keep in mind, however, that this is project-dependent. For some projects, a playbook will be sufficient; for others, scripts will produce better results.
0 likes • 2h
@Raymond Toulany Thanks! About the RAG setup, for most client projects I use pgvector so we don't add unnecessary complexity to their infrastructure. For personal projects, I use ChromaDB or SQLite-Vec. They're file-based, simple, and portable. For embeddings, you can use OpenAI, Gemini, or any model on Hugging Face that supports your language. Research layer: It depends on your tolerance for token usage and context size. Operations: Couldn't agree more. Governance: If the project needs to output deterministic data that will be consumed by other software, or if it has strict compliance requirements, a script is usually the more reliable approach.
Git Repo Security Skills
Stop README-shopping. Start scoring the repos you actually trust. Most of us still pick open-source like restaurants. Stars. Nice README. Maybe a glance at the last commit. That friction is real, and it's how vibe-coded slop ends up in the stack. New classroom piece is live: Git Repo Security: Why It Matters, and How We Actually Do It https://www.skool.com/cliefnotes/classroom/c7f102c7?md=43a45577d5cb4096b040770491d87b50 Why this hits us: we pull public git constantly. Agents clone third-party skills. Volunteers don't have an AppSec team. Stars are a weak signal. The article folds OpenSSF / SLSA / CISA-style checks into two portable skills so the discipline gets cheap and repeatable. How you run it (newbie path) 1. Open the article and download the zip. 2. Drop the zip into your harness (Claude Code, Cursor, OpenCode, Grok, etc.). 3. Prompt the agent like a colleague: run repo-scorecard Egonex-AI/Understand-Anything (github username/repo) or run repo-eval Egonex-AI/Understand-Anything ============================================================= Here's what you get from repo-scorecard: Scorecard: Egonex-AI/Understand-Anything Score: 9.50 / 10.00 — healthy, well-run project What's good: • Actively worked on — last update was yesterday. • Very busy recently: 355 commits in the last 90 days. • Many people involved — about 70 different contributors this year (though one person still does most of the commits). • Has a clear license, a README, and a security contact policy. • Has automatic quality checks and tests set up. • Ships tagged releases (8 tags) and keeps a fixed parts-list for its building blocks. Things to know: • No automatic updates for the building blocks it depends on. Score based on publicly visible project activity and housekeeping. It does not include a security scan of the code itself. ==============================================================
Git Repo Security Skills
1 like • 1d
@David Vogel I have a friend who's building a SaaS with a very similar concept. He's still in the pre-launch phase.
0 likes • 18h
@David Vogel I'm trying to bring him to the community
Sunday Coffee #7 ☕️
Come chat about your goals for the week! If you are new here, this is a chat room for general talk about the past week and the week ahead. Share what you’re working on and network with others! If you‘ve been here before, you know the drill. Leave a comment below. Some ideas to get the juices flowing: - What you’re working on - Something you hope to ship - Blockers you’re running into at the moment - Where you’re looking for help currently - Anything else you’d like to share Have fun and enjoy your week everyone! This week’s poll: Do you feel like you have the fundamentals down at this point or are you still learning any basics? If you feel you’re missing something, comment it below 👇
Poll
11 members have voted
2 likes • 1d
@Joseph Dodds Basically user's input is streamed concurrently with TTS output, the conversations is not turn based. I over simplified a little because I'm learning it this week and didn't get my hear around the whole concept yet. **Edit** Im learn from the kyutai.org team. they have a sample here: https://moshi-chat.kyutai.org/ but their example are glued ASR+models+TTS and as my native language isn't french or english. I'm trying to make my own.
1 like • 1d
@Gabriel Azoulay Sounds awesome! I understanding how to keep this promise feels like a great challenge to conquer. Keep us posted
1-10 of 19
Thales Teodoro
4
76 points to level up
@thales-teodoro-3654
Fullstack Developer and Digital Designer in search of knowledge

Active 33m ago
Joined Jul 14, 2026
Powered by