Vartovii Changelog

Release digest

Added

• System Improvements Infrastructure 🏗️ - Comprehensive automation and safety features
  • scripts/health-check.sh - Pre-push safety net (secrets, TODOs, docs, debug code, large files)
  • scripts/generate_changelog.sh - Auto-generate CHANGELOG from conventional commits
  • scripts/end_sprint.py - Sprint review automation with retrospectives
  • scripts/translate_docs.py - AI-powered EN→UK documentation translation (Gemini 2.0)
  • scripts/generate_docs_screenshots.py - Playwright auto-screenshot generator
• Documentation Reorganization 📚 - Logical structure for Ukrainian guides
  • docs/guides-ua/getting-started/ - Beginner guides (що-таке, як-запустити, як-задеплоїти)
  • docs/guides-ua/features/ - Feature-specific docs (API, Forensic Agent, Chrome Extension)
  • docs/guides-ua/infrastructure/ - Technical docs (GCP, структура проекту)
  • docs/guides-ua/reference/ - Quick references (команди)
  • docs/guides-ua/images/ - Visual assets (screenshots, diagrams)
• Workflow Enhancements ⚡ - Documentation-first development
  • Added mandatory Phase 2.5: Documentation (BEFORE COMMIT!)
  • Added Phase 2.6: Health Check (automated safety)
  • Updated .agent/workflows/dev-workflow.md with strict documentation rules

Improved

• Pre-Push Health Check 🔐 - New safeguards
  • Detects leaked secrets (API keys, .env files, credentials.json)
  • Flags critical TODOs in business logic
  • Catches debug console.log/print statements
  • Warns about large files
  • Verifies CHANGELOG updates for code changes
• Development Workflow 🔄 - New mandatory order
  • Old: Code → Test → Commit → Push → (Maybe docs)
  • New: Code → Test → Docs → Health Check → Pre-Commit → Push → Build
• Ukrainian Guides Structure 📁 - Moved from flat to categorized
  • 10 guides reorganized into 4 logical folders
  • Improved README with navigation matrix
  • Added visual documentation folder structure

Internal

• System Improvements Summary 📝 - docs/SYSTEM_IMPROVEMENTS.md
  • Comprehensive overview of all improvements
  • Before/After comparisons
  • Impact metrics (25% better docs coverage, 24x faster translations)
  • Training resources for AI agents and humans
• Updated Guides
  • docs/guides-ua/README.md - New category-based navigation
  • .agent/workflows/dev-workflow.md - Documentation-first approach
  • All Ukrainian guides moved to logical folders
• Automation Scripts
  • Conventional commit parser for changelog generation
  • Sprint plan markdown parser for retrospectives
  • Gemini 2.0 Flash integration for doc translation
  • Playwright browser automation for screenshots
• Documentation Pipeline
  • Auto-detect outdated translations (EN file newer than UK)
  • Preserve Markdown formatting in translations
  • Keep code blocks and technical terms intact

Technical notes