Skip to content

Create a repo level ETHOS.md #424

@njbrake

Description

@njbrake

It's sort of like a soul.MD except it's for a repository. The idea is to have some document that has a good description of "why does this project exist?" things like user stories or applications to really drive home why we're building what we're building. As agents write more and more of a code it's important for them to understand the reason why things are being built so that they can more appropriately to decide what to add for what not to add and how to build a good interface and UX around them.

For example, here is the user story that I want to be the really guiding principle of clawbolt:

Let's see I'm someone working in the trades like a house framer or a plumber. I start off working for a big company and for an organization and look around and see "hey, I can do this task better than most of the people that I work with and I work harder, why should I continue to work here? I should just start my own business because then I can reap all the rewards fir how hard I'm working." So they go off and they make themselves an LLC and start finding their own jobs to work, etc.. They quickly find that the reason it's so hard to have a business by yourself is because of how much work is required around all the things that don't involve just doing the thing that you're good at. One purpose of Clawbolt is specifically to help that person run their small business in a way that doesn't overwhelm them. It needs to not only just do the things that it's asked to do what it needs to know what it takes to run a successful small business like this and be able to prod the person at the appropriate times to do the things they need in order to be successful. It's not just enough for it to file invoices and estimates when asked it has to actually know when those things need to be done and helping inform the user that these things should be done and help guide it through doing whatever it needs input from the user to be able to complete.

This is the big differentiator with this project: it's not just an assistant that the user controls, it's a collaborator that works to fill in the gaps in the shortcomings of the user that they need to be able to run a successful small business in a sustainable way.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions