feat(directives): harvest 7 directives from python.md §17.1-17.7 (banned patterns + boundary exception)

This commit is contained in:
ed
2026-07-02 21:49:13 -04:00
parent 41c8678b28
commit f4dfb84681
7 changed files with 172 additions and 0 deletions
+28
View File
@@ -0,0 +1,28 @@
# ban_dict_any — v1
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §17.1 (lines 247-265).
This is the baseline encoding — the imperative-ban style currently in production.
Future variants will test alternative encodings (rationale-first, before/after, tabular) against this baseline.
**Source:** `conductor/code_styleguides/python.md:247-265`
---
### 17.1 Banned: `dict[str, Any]`
```python
# BANNED:
def process(event: dict[str, Any]) -> None:
if event.get("kind") == "tool_call":
# BANNED:
flat: dict[str, Any] = project_manager.flat_config(...)
# CORRECT:
def process(event: CommsLogEntry) -> None:
if event.kind == "tool_call":
# CORRECT (boundary only):
def _parse_wire(raw: str) -> Metadata:
return Metadata.from_dict(tomllib.loads(raw))
```