Team & Onboarding Highlights Summary
Every highlight bullet from the 7 pages in this section, gathered on one page and grouped by the page it came from.
- A team's real capability is measured by how many people can safely change and operate a system, not by headcount
- Bus factor is the concrete question every team practice in this section answers from a different angle
- Python teams often blend software-engineering and data/analysis backgrounds, which widens the ramp curve in a specific way
- Knowledge concentrated in one person is a standing production risk, not just an HR concern
- Time-to-first-PR target five working days or less
- Pre-file access tickets before day one
- Assign one named buddy for week one
- First PR should be small, real, and merged by day five
- Internal transfers need compressed onboarding too
- Python 3.14 with uv sync from lockfile
- ruff, pytest, mypy/pyright match CI versions
- pre-commit install matches GitHub Actions
- Copy .env.example never commit .env
- Verify with uv run pytest and curl /health
- src-layout maps packages to deployable boundaries
- pyproject.toml is the source of truth for deps and tools
- CODEOWNERS points reviewers for each directory
- ADRs in docs/ explain non-obvious decisions
- One request traced beats reading every file
- ruff enforces PEP 8 plus team-selected rules in CI
- Type hints on public functions; mypy/pyright in CI when enabled
- f-strings, pathlib, and explicit exception chaining
- Conventional commits with ticket ids
- Import order: stdlib, third-party, local
- Correctness and tests before bike-shedding style
- ruff and pytest green - reviewer reruns if skeptical
- Migrations and lockfiles need explicit review
- Security: secrets, SQL injection, unsafe deserialization
- Kind, specific comments with suggested fix or question
- Onboarding doc owned and updated every sprint
- CI commands copied exactly in local pre-commit
- Small PRs with tests and ticket ids
- Buddy system for first week not optional
- Blameless postmortems update docs and checklists
Revisado por Chris St. John·Última atualização: 31 de jul. de 2026