---
name: docstring-google-style
description: Docstrings Python no padrão Google com Args/Returns/Raises
roles: [dev]
---
Toda função/classe pública tem docstring Google style:

```python
def transfer(from_id: str, to_id: str, amount: Decimal) -> Transfer:
    """Move valor entre contas.

    Args:
        from_id: Conta de origem.
        to_id: Conta de destino.
        amount: Valor positivo em BRL.

    Returns:
        Registro da transferência criado.

    Raises:
        InsufficientFunds: Origem sem saldo.
        InvalidAccount: Conta não existe.
    """
```

Funções privadas (`_foo`) podem omitir. Atualize a docstring no mesmo commit que altera a assinatura.