Reorganize repository: Move documentation to docs/, backup files to vault/

[Copilot]

Repository root contained 12 scattered markdown files and backup files, making navigation difficult. Consolidated documentation into docs/ and backup files into vault/.

Changes

File Moves

• Documentation (11 files) → docs/
  • ACTION_REQUIRED.md, BROKEN_LINK_AUDIT.md, DOCKER.md, HEALTH_CHECKS.md, IMPLEMENTATION_SUMMARY.md, MOBILE_RESPONSIVENESS_AUDIT.md, PERFORMANCE.md, PORTAL_COMPARISON.md, PORTAL_REDIRECT_SPEED_TEST.md, SECURITY_UPDATE.md, STRATEGIC_PRIORITY_AUDIT.md
• Backup → vault/
  • .env.example.bak

Reference Updates

• .github/copilot-instructions.md - Updated DOCKER.md path: ../DOCKER.md → ../docs/DOCKER.md
• scripts/verify-performance.sh - Updated file existence checks for PERFORMANCE.md and HEALTH_CHECKS.md to reference docs/ prefix

Result

Root:  README.md (only markdown file)
docs/: 12 documentation files
vault/: 1 backup file

Original prompt

Problem

The repository root directory is cluttered with too many files, making it difficult to navigate. Multiple documentation files and a backup file are scattered in the root instead of being organized into appropriate folders.

Task

Reorganize the repository structure to improve maintainability and navigation:

1. Move Documentation Files to docs/ folder

Move the following markdown files from root to docs/:

• ACTION_REQUIRED.md
• BROKEN_LINK_AUDIT.md
• DOCKER.md
• HEALTH_CHECKS.md
• IMPLEMENTATION_SUMMARY.md
• MOBILE_RESPONSIVENESS_AUDIT.md
• PERFORMANCE.md
• PORTAL_COMPARISON.md
• PORTAL_REDIRECT_SPEED_TEST.md
• SECURITY_UPDATE.md
• STRATEGIC_PRIORITY_AUDIT.md

2. Move Backup File to vault/ folder

Move the backup file to a new vault directory:

• .env.example.bak → vault/.env.example.bak

3. Keep at Root

The following should remain in the root directory:

• README.md
• All configuration files (.dockerignore, .eslintignore, .eslintrc.json, .gitignore, next.config.js, package.json, package-lock.json, postcss.config.js, staticwebapp.config.json, tailwind.config.ts, tsconfig.json)
• All source code directories (api/, app/, apps/, components/, lib/, public/, scripts/, types/)
• middleware.ts
• deploy.ps1

4. Update References

Scan the codebase for any references to the moved files and update the paths accordingly:

• Update README.md if it references any documentation files
• Update any import statements or file references in code
• Check documentation files for cross-references to other docs

Expected Outcome

• Clean root directory with only essential files and folders
• All documentation organized in docs/ folder
• Backup file preserved in vault/ folder
• All file references updated to new paths
• No broken links or imports

This pull request was created from Copilot chat.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.