Based on my experience working with enterprise-level monorepos, workflows tend to vary by person. From my perspective, I build strictly based on requests from the Product team.
Because of this, it is better to maintain two distinct types of documentation rather than mixing them:
PRD (Product Related): Covers user stories, acceptance criteria, and the general roadmap.
I recommend to manage large codebase with agents.md for larger folders to help any LLM to get a clear understanding of the context/what you want and the bonus is that you don’t “wast” tokens.
Hello,
My knowledge of these matters is still limited,
so do you have any advice, guidance, or documents that I could review?
Thank you for your interest.
If it’s a collaborative development project involving multiple people in an enterprise, it’s best to have a clear division of labor. If it’s a solo development project, plan ahead.
if you use github you can also have branches, so you can have one thing in prod and anouther in dev. this will prevent somthing from compleatly braking. anouther thing is you can open a new branch for diffrent featurs. this keeps things seaprate.