HackerTrans
TopNewTrendsCommentsPastAskShowJobs

tconfrey

no profile record

Submissions

Ask HN: ~25KLOC Indie project. Best practices for AI facilitated refactor?

3 points·by tconfrey·hace 9 meses·0 comments

comments

tconfrey
·hace 6 meses·discuss
Hi @cyrialize , Hopefully this is an acceptable level of self-promotion. It sounds like my browser extension, BrainTool might be useful in your workflow. It's kindof a bookmark/tab management tool. It syncs to a .org file and allows you to do things like mark tabs as a TODO, which you can then track in org-agenda etc. There's some brief descriptions and videos here: https://braintool.org/2025/09/16/Browser-Workflows-with-Brai...
tconfrey
·hace 6 meses·discuss
I've been on this bandwagon for a long time! I proposed org as an interchange format for Productivity and PKM tools several years ago [0]. Org allows me to unify my bookmark manager with the rest of my PKM as well as to-do management in a way that I don't think is possible with markdown.

That said I think that AI is changing things as it becomes best practice to document and define everything in plain text for LLM consumption. Since the default text format is markdown (due to github and PKM tool support) more and more people are exposed to it as the one true markup language. So maybe the boat has sailed and org becomes another example of the better format that doesn't win out. OTOH LLMs slurp up org content just as easily as they do markdown, maybe more so given the richer syntax. So maybe there's still room for both?

Either way I think the losers are going to be Sharepoint, Confluence, Jira etc, maybe even wikis, ie all the non standard ways people have been documenting their work to date.

Like us org folks have been saying all along, just stick with plain text!

[0] https://braintool.org/2022/04/29/Tools4Thought-should-use-Or...
tconfrey
·hace 9 meses·discuss
I've been watching this trend toward SDD. Makes sense but it feels like the process pendulum is swinging back toward the pre-agile era of functional specs and design documents. Not quite Big Design Up Front[0] but maybe increasingly working software == comprehensive documentation[1]?

Waterfall anyone?!

[0] https://en.wikipedia.org/wiki/Big_design_up_front

[1] https://agilemanifesto.org/