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

39.8k members • Free

6 contributions to Clief Notes
Agents are human. PRD or die!
Agents are human. PRD or die! Ok, maybe not human, but human like. Enough to create chaos and wreak havoc. Enough to take you to the edge of insanity, if you're not careful. If you don't write a solid Product Requirements Document. Note: These are my observation after having worked with Windsurf, Cursor, and now Claude Code in both the app and in VS Code, building a web app with a Firestore set-up and some complex business logic. I'm not an AI expert, I'm not a developer, but I have about 20 years of experience working in fintech. Mainly as a product manager, managing teams of developers and business analysts, working with architects and other stakeholders. What do I mean by human like? In my experience, at this point in time, AI agents are as good or better than the best developers. For good or for worse. So, let me elaborate. On this potential issue, on confusion, my sins, and that special place in hell. As a product manager, I've worked with overloaded backlogs of items I wanted to build. I've had a million requests from stakeholders, many half baked. I've come in fresh to teams who had gone down one particular path, with a set in stone architecture, and, important, terminology and concepts that were in no way logical to the outsider. Like a company isn't a company. Say what!? Yes, once decided, something completely illogical become logical, or at least sets a standard. Even for supposedly standard terms, everyone makes assumptions based on their own experience and context. In all these cases, working with smart and dedicated people, I have experienced chaos and havoc, when we didn't take the time to define exactly what we wanted to build. That's why I say "agents are human.", or at least "agents are human-like." A) They are as good or better than good developers. B) Each time you run a session with an agent, it's like working with a new developer on the team. Without context, they will make assumptions to do the job you ask them to.
3 likes • 2h
thanks for sharing @Mira Bradshaw . Yes, totally agree, the architecture part can be challenging. I've ended up creating an architecture skill plus an ICM type document repo for things like architecture, which the "architect" references. I find that it's helpful to invoke the architect again and again in a development cycle, to avoid drift and to iterate as more details are uncovered.
1 like • 15m
Hi @Curtis Hays , thanks for your kind words - much appreciated! I'm hoping folks here might find some inspiration in this process. I will share more details of my approach over time. And, I'll share my work as well when I've completed p0 user management and a design migration. All the best!
šŸ Foundations 3.3 Check-In
Everyone gets something wrong the first time. Vote below, then drop your mistake in the comments so others can learn from it.
Poll
481 members have voted
1 like • May 22
I started working with Claude before finding this fantastic forum. I was only building a single app to start with but as I expanded to content production, I things out in too many folders. Still working on consolidating things. It’s easy for me to overthink and plan for all eventualities but that rarely works. Now I try to start simple and continue to iterate.
1 like • May 22
@Jodie Willow reduce sprawl and match workflows to what I need. Not less. Not more. Seems to be a constant effort :)
Folder structure vs Obsidian
Hi everyone, I feel like the hype around ā€œObsidian second brainā€ is not important as a good folder/file structure going through the class lessons here but everywhere I turn someone is yelling ā€œsecond brainā€ this and that. I am here to ask if Obsidian really does enhance anything particularly, asides from looking cool?… AI Performance? AI reasoning? or Is it just a duplication ? If anyone can help. I don’t wanna go down the hole… too many things to learn. šŸ˜…
3 likes • May 21
@Oreoluwa Bruce I suffer from documentation and tote taking FOMO. And I love using Obsidian. That said, I’ve started migrating my obsidian notes into my Claude projects because much of my note taking is for the courses and content I’m writing. And agent access has become just as important. So the difference right now is if a note is just for me for learning or if I use it in a workflow to outline logic I share via content or I crystallise in the app I’m building.
1 like • May 21
I have a regular job but come here for my side hustle. The structure and approach is the main thing I’ve learned here @Olivia Manson Don’t want to hijack this thread with a side conversation though. But thanks for asking.
HTML OVER .md Files
A Claude code Eng just dropped this. Anyone been doing this switch yet or will try? Curious to see what @Jake Van Clief has to say. It’s a file still just a different format. Same thing right… thoughts? Pros and cons? Here to learn and discover https://x.com/trq212/status/2052809885763747935?s=46&t=Ayzo8Ebbgb8PZhLNm057bg
HTML OVER .md Files
0 likes • May 21
This is interesting @Kevin Carrasco For now I’m fine using preview in vs code and I like being able to edit .md files via obsidian. And, I prefer to keep my markdown files no longer than 300 lines anyway, because of my own ā€œcontext windowā€ :) so I’m happy to keep files short. That’s not to say I won’t try html
0 likes • May 21
@Jodie Willow Glad you agree :) And to your point, I find that agents are less likely to miss things - compare to some of my mega files of the past. I usually combine the shorter docs with an index to help me and agents navigate the file collections. Not sure if that’s best practice but it works for me.
Im understanding about 5% of what I see here šŸ˜„
Still, I'm new here. So hopefully in a month or so I will get to 10% Anyone else feeling the same?
Im understanding about 5% of what I see here šŸ˜„
1 like • May 21
I used to feel that way about using AI @Stuart Clifford . Which is great because it means you’re learning :) I’d recommend coming up with a small project so you can put all the lessons into context. That’s at least what helps me learn. All the best!
1-6 of 6
@christian-saugmann-5664
I'm using Claude to build an app to help people learn to hunt and plan any hunt or an entire season.

Online now
Joined Mar 20, 2026
Powered by