docs(agents): rewrite the agent guide with product goals and hard-won invariants

docs(agents): rewrite the agent guide with product goals and hard-won invariants #19