docs: Add comprehensive documentation for AI agent efficiency

[Copilot]

This PR adds comprehensive documentation to help future AI agents navigate the WrongSecrets codebase more efficiently, reducing exploration time and maintaining consistency with existing patterns.

New Documentation Added

Architecture Overview (docs/ARCHITECTURE_OVERVIEW.md)

• Project Structure: Clear package organization with responsibilities for challenges/, oauth/, asciidoc/, etc.
• Testing Patterns: Documentation of 74+ test files organization, unit/integration/E2E test structure
• Build Process: Maven → Docker workflow with version management and build commands
• Configuration Reference: Comprehensive table of key configuration files and their purposes

Development Patterns (docs/DEVELOPMENT_PATTERNS.md)

• Challenge Implementation: Detailed patterns for Challenge interface vs FixedAnswerChallenge abstract class
• Configuration Management: Environment-specific configuration and runtime detection patterns
• Workflow Patterns: GitHub Actions structure and common CI/CD conventions
• Code Quality: Checkstyle, PMD, pre-commit hooks, and naming conventions

Enhanced Existing Documentation

Quick Start for Contributors (CONTRIBUTING.md)

Added a comprehensive quick start section featuring:

• 5-minute setup guide with essential commands
• Essential reading list pointing to new documentation
• Development workflow and common commands
• Quick tips for challenge development

Debugging Commands (docs/VERSION_MANAGEMENT.md)

Enhanced with detailed troubleshooting guidance:

• Version verification and build testing procedures
• CI/CD debugging techniques and health checks
• Troubleshooting version mismatches and build failures

Benefits for AI Agents

• Reduced Exploration Time: Clear project structure eliminates need to discover package organization
• Pattern Recognition: Documented code patterns help maintain consistency with existing challenges
• Quick Onboarding: 5-minute setup gets agents productive immediately
• Debugging Reference: Comprehensive commands for common version and build issues

The documentation follows existing project conventions and provides essential context that was previously only discoverable through extensive code exploration.

Fixes #2116.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[commjoen]

@copilot can you fix https://github.com/OWASP/wrongsecrets/actions/runs/16538480124/job/46778150393?pr=2117 please?

[Copilot]

@copilot can you fix https://github.com/OWASP/wrongsecrets/actions/runs/16538480124/job/46778150393?pr=2117 please?

Fixed the pre-commit formatting issues in commit 5384f38. The workflow was failing due to trailing whitespace and missing final newlines in the documentation files. These formatting issues have been resolved.