refactor: no comments left - one-line module docstrings, contracts on public fields only; jobs/job.py; example config and README

src/beaver_gateway/agents/prompts.py

@@ -1,12 +1,7 @@
 """System prompt assembly from a list of source files.
 
-The gateway holds no prompt text: an agent names its granules (paths from
-``config.py``) and :func:`assemble` concatenates them in that order, so the
-result is byte-for-byte identical for every session of the same agent as
-long as the files are. A source is a path, or a ``(tag, path)`` pair whose
-content is wrapped in ``<tag>...</tag>`` - the markup lives here, the vault
-keeps plain markdown. Each granule's hash is logged at assembly so a
-drifted prompt can be traced to the file that changed.
+:func:`assemble` concatenates an agent's granules in order. A source is a
+path, or a ``(tag, path)`` pair whose content is wrapped in ``<tag>...</tag>``.
 """
 
 from __future__ import annotations
@@ -27,6 +22,7 @@ PromptSource = str | Path | tuple[str, str | Path]
 
 
 def assemble(sources: Iterable[PromptSource]) -> str:
+    """Concatenate ``sources`` in order into one system prompt."""
     parts: list[str] = []
     for source in sources:
         tag, raw = source if isinstance(source, tuple) else (None, source)