# Marcos Souza
> Product Engineer specializing in HealthTech Scale, Loop Engineering, Contract-First Architecture, and Autonomous AI Agent Tooling.

## Summary
Marcos Souza is a Software and Product Engineer who scaled ProABA (HealthTech SaaS) from day-zero creation to enterprise maturity supporting ~100 autism clinics across Brazil (+1,850 commits, 230+ merged PRs). His work emphasizes full-cycle product ownership (from triaging raw user escalations to shipping validated solutions), radical responsiveness to feedback, contract-first design (zero rework), and deterministic AI safety nets.

## Core Specializations
- **Day-Zero to Enterprise HealthTech**: Built core clinical evolution matrices, guardian collaboration portals, and official PDF reporting engines at ~100 clinics scale.
- **Full-Cycle Product Ownership & Feedback Triaging**: Receiving raw clinic escalations directly, diagnosing root causes, evaluating solutions, and delivering end-to-end fixes with zero handoff latency.
- **Loop Engineering & Workflow Automation**: Automating entire operational cycles end-to-end, including AI-driven 22-tutorial Help Center generation and duration-balanced CI/CD sharding.
- **Contract-First Product Engineering**: Validating UX flows and data contracts via interactive throwaway mockups before database schema persistence.
- **Autonomous AI Agent Tooling & Safeguards**: FastAPI agent microservices, Whisper + Claude structured clinical pipelines, and mandatory Human-in-the-Loop review queues.
- **Test Automation & Safety Containment Nets**: Playwright E2E suites with Docker ephemeral fixtures, duration-balanced test sharding, and zero-flake CI environments.

## Featured Engineering Case Studies
- [Autonomous Help Center Generation via AI Agent Skill](https://marcossouza.dev/#work): Custom AI agent skill that reads canonical Markdown scripts, navigates web apps in dev, captures step-by-step screenshots/videos, and compiles the official 22-tutorial Help Center.
- [Clinical AI Pipelines & Human-in-the-Loop Safeguards](https://marcossouza.dev/#work): Speech-to-text therapy session evolution generator with Pydantic schemas and mandatory clinician approval, reducing charting time by 75%.
- [Playwright E2E Containment Net for AI Coding](https://marcossouza.dev/#work): Automated test harness enabling fast development and AI-assisted implementation with zero regression risk (QA 1h -> 10 min).
- [Cloudflare R2 Direct Media Storage](https://marcossouza.dev/#work): Direct browser-to-cloud uploads with signed size locks in extensionHeaders, bypassing server memory with $0 egress bandwidth costs.
- [Next.js Production Resiliency & Deployment Skew Interceptor](https://marcossouza.dev/#work): Client-side routing interceptor preserving form inputs and auto-reloading during rolling production zero-downtime releases.

## Technical Writing
- [Dev.to Profile](https://dev.to/marcossouzadotdev): Tactical essays on Contract-First development, E2E harnesses for AI, and modern web architectures.
- [Contract First, Code Last](https://dev.to/marcossouzadotdev/contract-first-code-last-the-workflow-that-stopped-us-from-rebuilding-features-twice-4074): Why validating UX in throwaway mockups before coding is the highest-leverage habit in software engineering.

## Profiles & Direct Contact
- Email: marcosfromrio@protonmail.com
- WhatsApp: +55 21 97264-2433 (https://wa.me/5521972642433)
- Website: https://marcossouza.dev
- GitHub: https://github.com/marcossouzadotdev
- Dev.to: https://dev.to/marcossouzadotdev
- LinkedIn: https://linkedin.com/in/marcossouzadotdev

## Extended Context
- [Full LLM Context (Machine-Readable)](https://marcossouza.dev/llms-full.txt): Complete technical dossier, architecture post-mortems, and domain glossary.