docs: README по требованиям к оформлению и демо-сервисы examples/ (#19)

- README: цели и задачи, что реализовано, развёртывание (локально за 5 минут
  и полный стек), переменные, команды и данные, используемые API,
  ограничения и лимиты, что не сделано, структура репозитория
- examples/: hello (healthy + материал для grep/агента), crash (💥 и 🔁),
  cpu_hog (🔥), unhealthy (🩺), syntax_error/lint_fail для коммита,
  вопросы агенту и атаки; make demo-up / demo-down в том же Compose-проекте
- make local-proxy: read-only Docker API для `make run`
- ARCHITECTURE: краш при restart-политике и гистерезис алертов

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

pyproject.toml

@@ -40,7 +40,8 @@ packages = ["app"]
 [tool.ruff]
 line-length = 120
 target-version = "py312"
-extend-exclude = [".claude", "docs"]
+# broken on purpose: commit demos (examples/README.md)
+extend-exclude = [".claude", "docs", "examples/syntax_error.py", "examples/lint_fail.py"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "B", "UP", "SIM", "ASYNC", "RUF"]