In general, sudocode aims to preserve some of this implementation/planning state (context-as-code) in your codebase so it isn't lost in your chat logs. Keeping this context in your repo makes it accessible to coding agents long after code changes were made, so it functions as a sort of episodic memory for your codebase.
The big problem of ai generated docs for me is that it takes time to read and understand whether they are correct or not. Same with human written docs, which is why you need spec reviewers.
I assume the purpose of sudocode is to help me reduce the time to review and manage specs. How can sudocode help me solve the trust problem here while i don't want to spend so much time reading and managing specs? Solving the spec generation is one part, but the other big problem to solve here is to help speed up the spec review/validation process.
In this case, what sudocode aims to preserve is the human intent that might be lost in agent chat logs, etc. It then provides utilities to turn those specs into implementation plans (issues). And specs in this case are mutable and designed to be iterated on (just like code).
Or with a physics analogy, the code is the position of a particle while the specs capture velocity information. You can iteratively work on changing the velocity which will then change the position (code changes).
As for the spec review burden, the sudocode provides an interface for coding agents to provide bi-directional feedback onto the original spec, so you can fire off a few coding agents and see how they performed relative to your specified requirements. You can let the execution of the coding agents speak for themselves!
arcticampic•1h ago