you need to have developer doc in src, is the only way to have the full picture in the future. The main point is to keep it in sync, the agent harness must enforce that