Great writeup!! I love the idea of the vector database with everything, including transcripts. Seems like an awesome foundation to improve prompting down the line.
Dex from Humanlayer recently gave a presentation where he argues against using folder-level documentation, as it gets out of date. The solution? Using subagents during the research phase to actually read the code itself, summarizing it into the research report. More like on-demand documentation. I will defer the details to his presentation, as he articulates it better than me. Would love to know your thoughts: https://youtu.be/rmvDxxNubIg?si=sE1Bn9DtO6JNbIvf&t=793
We do that too! The humanlayer guys are big inspirations of some of what we do at nori! We take a slightly different approach than them in that we pull more into the agent than what they do, but overall large amounts of agreement on agentic coding practice
To answer your specific question, we have both docs and the subagents that read the code. We find that the mix is beneficial right now, but its still all very greenfield. I have never really experienced that the docs fall out of sync, and I think that docs convey *intent* more than code ever could. That in turn is extremely helpful for guiding the code reading agents in their research. (Docs also capture invariants at the time they are created, which is extremely useful in large code bases. You can think of docs as a way of creating discrete lines in your code graph that are otherwise hidden but important)
Great writeup!! I love the idea of the vector database with everything, including transcripts. Seems like an awesome foundation to improve prompting down the line.
Dex from Humanlayer recently gave a presentation where he argues against using folder-level documentation, as it gets out of date. The solution? Using subagents during the research phase to actually read the code itself, summarizing it into the research report. More like on-demand documentation. I will defer the details to his presentation, as he articulates it better than me. Would love to know your thoughts: https://youtu.be/rmvDxxNubIg?si=sE1Bn9DtO6JNbIvf&t=793
We do that too! The humanlayer guys are big inspirations of some of what we do at nori! We take a slightly different approach than them in that we pull more into the agent than what they do, but overall large amounts of agreement on agentic coding practice
To answer your specific question, we have both docs and the subagents that read the code. We find that the mix is beneficial right now, but its still all very greenfield. I have never really experienced that the docs fall out of sync, and I think that docs convey *intent* more than code ever could. That in turn is extremely helpful for guiding the code reading agents in their research. (Docs also capture invariants at the time they are created, which is extremely useful in large code bases. You can think of docs as a way of creating discrete lines in your code graph that are otherwise hidden but important)