For those interested, I've slowed work on the app in favor of refining the app's ontology in markdown form[1], building an ontology playground[2], and building a prototype[3] to show off features that the updated ontology enables. I had some major changes I wanted to make and making it work in the real app was going to be too much effort.
I'll likely be making a Show HN for one/some of these soon^TM (in the next month or two?) but they're currently still a bit early.
Seems like an interesting way to both refine and serialize thoughts about something tricky. I think it could be a really useful backbone, but I question if the interface is optimal for creating the graphs vs something more conversational and using the graphs to hold and iterate on the state. Also, I think I would want some kind of essay version as a consumer of someone else's argument rather than reading thru the graph itself.
In which direction are you supposed to read these charts? The arrows seem to point from conclusion/solution to reasoning, but the reasoning is at the top which makes me feel like I should read it first. It would be less confusing for there to be a single convention (eg “reasoning/evidence at the top with arrows flowing mostly down towards the conclusion”).
Similarly, I was confused by the use of both active and passive: eg sometimes “creates” and sometimes “created by,” with different arrow directions for each.
Thanks for the feedback, I agree. I hadn't gotten around to adding an Explore page. There haven't actually been many users so it'd be mostly my topics and topics from some small group discussions I've hosted, but would be good to have more for people to see.
I expected scores and justifications to show up all the time, not just hover, no matter the view. Did you consider styling edge types differently to replace labels?
Appreciate the feedback. I had played around with defaulting scores/justification showing vs not showing mainly because in a big diagram it can add clutter, hadn't been solid on that though.
Regarding styling edge types: Yes and I think it's a good idea. I think there are some things I haven't tried yet, but I added logic gates https://github.com/amelioro/ameliorate/issues/785 (More Actions Menu > Preferences > Edges > Use semantic arrow shapes) and there's an open ticket for using colors to convey good/bad https://github.com/amelioro/ameliorate/issues/836. Thickness is another thing that potentially could be played with, thicker being higher score? Hadn't gotten to that.
If you have a problem that's hard to think through or agree on with someone else, this app can help you make a (cause & effect) diagram to understand it better. Use numbers (scores) to show others how important you think something is (nodes) or how much you think something causes another thing (edges). You can add reasons (supports/critiques) to justify your numbers, and tradeoffs (criteria) to compare options for dealing with the problem. The app can show where you disagree with people or what people think are most important (generated views).
I might need LLM help to figure out how to explain to a 5 year old haha.
this is interesting, does it use IBIS on some level? i discovered IBIS and added it and mermaid diagrams to my app but it was a bit of a lark. i think what i pictured was similar to what you have here (and should be possible though i have not tested the IBIS > mermaid pipeline).
It's not exactly IBIS, but inspired for sure. IBIS I think is better for modeling a live discussion, it's almost an append-only structure (to model back-and-forth), whereas Ameliorate's structure (the core is concepts with cause & effect relations) is intended to have new information integrated without duplication (which can be more annoying to do live because it can involve modification rather than appending).
Ameliorate models questions and arguments, but they're more auxiliary (modeled as being _about_ a cause or effect) than in IBIS, where they're pretty central. Questions in Ameliorate are more "unknowns" than "core questions we are trying to answer".
If you see my root-level comment in this post, I mention refining the Ameliorate ontology (ameliorate-v2) which elevates questions to first-class (to address the issue where it's hard to know where to look in the diagram, without questions to identify motivation). You might also be interested in my ontology playground in that comment if you want to see an IBIS > mermaid pipeline.
[delayed]
Cool to see this posted :) I'm the creator.
For those interested, I've slowed work on the app in favor of refining the app's ontology in markdown form[1], building an ontology playground[2], and building a prototype[3] to show off features that the updated ontology enables. I had some major changes I wanted to make and making it work in the real app was going to be too much effort.
I'll likely be making a Show HN for one/some of these soon^TM (in the next month or two?) but they're currently still a bit early.
[1] https://github.com/keyserj/reasoning-tools/blob/main/amelior...
[2] https://keyserj.github.io/reasoning-tools/ontology-playgroun...
[3] https://github.com/keyserj/reasoning-tools/tree/main/amelior... (not yet deployed)
first, cool idea! i have just a grammar suggestion:
> What if it was trivial ...
what if it _were_ trivial...
( https://en.wikipedia.org/wiki/Subjunctive_mood )
Seems like an interesting way to both refine and serialize thoughts about something tricky. I think it could be a really useful backbone, but I question if the interface is optimal for creating the graphs vs something more conversational and using the graphs to hold and iterate on the state. Also, I think I would want some kind of essay version as a consumer of someone else's argument rather than reading thru the graph itself.
Really cool space to explore!
In which direction are you supposed to read these charts? The arrows seem to point from conclusion/solution to reasoning, but the reasoning is at the top which makes me feel like I should read it first. It would be less confusing for there to be a single convention (eg “reasoning/evidence at the top with arrows flowing mostly down towards the conclusion”).
Similarly, I was confused by the use of both active and passive: eg sometimes “creates” and sometimes “created by,” with different arrow directions for each.
This might be more interesting if you could read other people's discussions. As it is, it's like visiting an empty forum.
Thanks for the feedback, I agree. I hadn't gotten around to adding an Explore page. There haven't actually been many users so it'd be mostly my topics and topics from some small group discussions I've hosted, but would be good to have more for people to see.
Since you use it yourself, sharing your own topics seems like a good way to start?
Yeah. Here are some I could share https://ameliorate.app/keyserj/highlight-nodes-thread https://ameliorate.app/keyserj/edge-labels-overlap https://ameliorate.app/keyserj/voting-systems https://ameliorate.app/keyserj/use-cases. The group discussions can be found right now at https://ameliorate.app/keyserj by searching "discourse"
Maybe having an alternative "outline" view that works like hierarchical menus might be an interesting way to navigate?
I expected scores and justifications to show up all the time, not just hover, no matter the view. Did you consider styling edge types differently to replace labels?
Appreciate the feedback. I had played around with defaulting scores/justification showing vs not showing mainly because in a big diagram it can add clutter, hadn't been solid on that though.
Regarding styling edge types: Yes and I think it's a good idea. I think there are some things I haven't tried yet, but I added logic gates https://github.com/amelioro/ameliorate/issues/785 (More Actions Menu > Preferences > Edges > Use semantic arrow shapes) and there's an open ticket for using colors to convey good/bad https://github.com/amelioro/ameliorate/issues/836. Thickness is another thing that potentially could be played with, thicker being higher score? Hadn't gotten to that.
Very nice. I think this can be a good visual way to run LEAN activities like 5 Why and A3 Problem Solving.
- stupid question: i really dont understand what your product does
- mind explaining it like how you would do to a 5yr old kid
If you have a problem that's hard to think through or agree on with someone else, this app can help you make a (cause & effect) diagram to understand it better. Use numbers (scores) to show others how important you think something is (nodes) or how much you think something causes another thing (edges). You can add reasons (supports/critiques) to justify your numbers, and tradeoffs (criteria) to compare options for dealing with the problem. The app can show where you disagree with people or what people think are most important (generated views).
I might need LLM help to figure out how to explain to a 5 year old haha.
Man you could have used this a small piece of marketing with a shareable link to show people how did you reason about the product.
I can only hope this is a joke to ask for an explanation of a product that breaks down complex problems into clear pieces.
this is interesting, does it use IBIS on some level? i discovered IBIS and added it and mermaid diagrams to my app but it was a bit of a lark. i think what i pictured was similar to what you have here (and should be possible though i have not tested the IBIS > mermaid pipeline).
in any case: cool
It's not exactly IBIS, but inspired for sure. IBIS I think is better for modeling a live discussion, it's almost an append-only structure (to model back-and-forth), whereas Ameliorate's structure (the core is concepts with cause & effect relations) is intended to have new information integrated without duplication (which can be more annoying to do live because it can involve modification rather than appending).
Ameliorate models questions and arguments, but they're more auxiliary (modeled as being _about_ a cause or effect) than in IBIS, where they're pretty central. Questions in Ameliorate are more "unknowns" than "core questions we are trying to answer".
If you see my root-level comment in this post, I mention refining the Ameliorate ontology (ameliorate-v2) which elevates questions to first-class (to address the issue where it's hard to know where to look in the diagram, without questions to identify motivation). You might also be interested in my ontology playground in that comment if you want to see an IBIS > mermaid pipeline.
I think the logical direction for such a product is to make data-backed decisions using causal inference, like so:
https://basisresearch.github.io/chirho/