hartleybrody
Joined 15 years ago
Joined 15 years ago
I have been using it for a few weeks, and it significantly improves the quality of the docstrings and code comments, as well as the readability of spec docs.
I have also added a few key bullet points to my AGENTS.md and have found the results to be very effective and generating plans and code that looks like something I would have written:
-----------
## planning, design and spec docs
- the highest design goal is simplicity -- in our systems and our mental model -- even if if means edge cases are unaddressed and could potentially fail
- please practice "ya ain't gunna need it" (YAGNI) do not add unnecessary guardrails
- do not plan to add caching, many layers of unnecessary abstraction or other premature optimizations
- look for places where adding or clarifying an invariant would simplify the code or the overall system
please specifically try to avoid:
- redundant calculations or duplicated work
- duplicated conditionals or state-machine logic
- storing state that can be derived from other state, which could drift and become out of sync over time
- leaky abstractions across layers of the application
- multi-line comments explaining a variable name or a single statement. well chosen names and design should makes these unnecessary, as the code is self-documentingThere's a browser extension that reads the content of the article on the page (only when you activate it, using least privilege browser APIs for content scripts) and then narrates the article for you. You get a custom podcast RSS URL that works in (almost) any podcast player, and then you can take articles with you to catch up while driving, walking the dog, etc. All the typical podcast audio controls you're used to like speed settings, skipping, and no new apps to download or learn.
It has genuinely been a big benefit and allowed me to keep up with articles I'd never normally have time to read, plus it allows me to reduce my screen time. My wife also uses and loves it. There have been some interesting bugs in the narration like originally pronouncing "24/7" as "twenty-four sevenths" but I am working through different strategies to get more accurate narration from arbitrary long-form text.
With apologies for the ".AI" domain, it was a bit of an impulse buy: https://earcast.ai/
Seems completely different. See also, this discussion:
Serious question: what should have been said on this call to do that? There was a lot of "I'm sorry you feel that way" seeming to come from the HR representative, but it seemed to miss the mark.
The HTMX and alpine libs were intended to be sprinkled onto existing web apps (my usual python/flask stack), whereas Phoenix would be for building all new projects.
https://hnbadges.netlify.app/?user=hartleybrody