feat: update AI instructions and documentation for clarity and completeness