Josh Ponelat

@robj3d3 Been tinkering with this, execution will be the main thing!

Startup idea: Speak with AI in your headphone while going for a walk I want to be able to brainstorm and chat with AI while I go for a walk without looking at my phone I get the best mental clarity and ideas on walks it would be AMAZING

Goodness, vibe coding can be frustrating. Two steps forward, five backwards.

@boyney123 That’s a cool flex 💪😄

How cool is this! The first time I have ever seen EventCatalog mentioned in a Job post! It's the small wins that matter 🚀❤️

@_catwu That's a cool UI trick! Nice.

4/ @-mention files for context Just use @-filename to pull files and directories into context instantly - no need to navigate or specify paths. Claude Code automatically includes the right file.

We've recently shipped a fresh batch of Claude Code features to improve your workflow! These updates make Claude Code faster, more visual, and easier to control. Here's what's new:

@aidandcunniffe It’s a better package manager cli name to be fair

how it's going

direct manipulation

@levelsio i always put an empty 8gb file in the server root. in case something happens you have quick relief to fix things

@code_star Gonna keep an eye on this thread, thanks ! I’m building a journaling app based on time view. Even without AI it’s super useful to record your work

I’m sure someone has done this, but has anyone tried making like a daily work log / diary to dump your thoughts ands and progress at the end of the day and try querying an LLM first thing in the morning to build a priory queue / check list for the day?

Are you almost agentic? I wrote something up on it... open.substack.com/pub/ponelat/p/…

# the nightmare bicycle imo, the most important idea in product design is to avoid the "nightmare bicycle". imagine a bicycle where the product manager said "people don't get math so we can't have numbered gears - we need to have labeled buttons for gravel mode, downhill mode, ..." this is a hypothetical "nightmare bicycle" that Andy diSessa imagines in his book Changing Minds. as he points out: it would be terrible! we'd lose the intuitive understanding of how to use the gears to solve any situation we encounter. which mode do you use for gravel + downhill?? turns out, anyone can understand numbered gears totally fine after a bit of practice. people are capable! along the same lines - one of the worst misconceptions in product design is that a microwave needs to have a button for every thing you could possibly cook: "popcorn", "chicken", "potato", "frozen vegetable" bla bla bla. you really don't! you can just have a time (and power) button. people will figure out how to cook stuff. good designs expose systematic structure; they lean on their users' ability to understand this structure and apply it to new situations. we were born for this. bad designs paper over the structure with superficial labels that hide the underlying system, inhibiting their users' ability to actually build a clear model in their heads.

@boyney123 @addyosmani That’s so cool! Does look like a super power 🦸‍♂️

Think I just unlocked some super power with EventCatalog. Using WebLLM (thanks for the demo @addyosmani), you can now talk to your architecture. All local and private. This is amazing.

@topSimpa Business first. User second. Product/API third. It's a tradeoff. How much energy you spend considering these, vs how much time you have to build it. Account for as much as you can, knowing that you're likely wrong (we all are) and that testing will help prove things.

Are the functional and non functional requirements suppose to be accounted for in the API design before considering the business requirements

@jponelat I am currently reading your book Designing APIs with swagger and OpenAPI recommend by @OyabureZakari . The insight it given me for the new project I am working on is mind blowing, It like I found the missing pieces. I have some questions in the thread

@topSimpa Functional requirements are what the thing will do. If the business requirement is to "get more users". Then the functional req might be "build a box that makes people laugh when they push a button". It's a thing, users can interact with it. It is functional.

Is there a difference between the functional requirements and business requirements of an application? at what stage is the business requirements supposed to be considered, is it at the stage where the initial requirements are stated.

@topSimpa Yes there is a difference. The business requirements are how this thing will impact the business. Is it meant to get more users, engage them more? How will this translate into more money ultimately. The initial requirements should definitely consider this.

@topSimpa @OyabureZakari Thanks for the feedback @topSimpa ! @LukasRosenstock wrote the section on Function/non-Functional, but I'll throw in my thoughts...

@heynibras As someone who's played around with walking-and-talking, it can actually be super exhausting to work while on foot. Not every walk should be productive! I'm playing around with prototypes to bring order to notes, an Infinite Journal, if you will :)

i want to voice journal daily and have a clean record of it. any recommendations for tools or apps? i use claude but that doesn’t feel clean — too many other chats. could do something like reflect notes but want to know if there any other reccs first

Bret Victors principle of Immediate Connection, drives much of my thinking today, had to write about it… blog.ponelat.com/p/why-arent-we… @Dynamicland1

now this is a side project

My first post on Substack! Just something to get going with... Marketing jargon on landing pages open.substack.com/pub/ponelat/p/…

Fun!