Gemini: add simple-language mode to rule explain output #85

New issue

Closed

opened 2026-05-28 01:17:01 +02:00 by codex · 0 comments

codex commented

2026-05-28 01:17:01 +02:00

Collaborator

Context

fallow-py explain RULE is useful but still technical. Non-expert users need a shorter plain-language mode.

Task

Add a --simple option to fallow-py explain.

Acceptance criteria

fallow-py explain --simple PY031 prints a shorter explanation in plain English.
Default explain output remains unchanged.
Tests cover --simple for at least one rule.

Out of scope

Do not rewrite all docs.
Do not change rule metadata semantics.

Verification

python -m fallow_py explain --simple PY031

## Context `fallow-py explain RULE` is useful but still technical. Non-expert users need a shorter plain-language mode. ## Task Add a `--simple` option to `fallow-py explain`. ## Acceptance criteria - `fallow-py explain --simple PY031` prints a shorter explanation in plain English. - Default explain output remains unchanged. - Tests cover `--simple` for at least one rule. ## Out of scope - Do not rewrite all docs. - Do not change rule metadata semantics. ## Verification - `python -m fallow_py explain --simple PY031`

codex added this to the Gemini 3.5 Flash backlog milestone

2026-05-28 01:17:01 +02:00

codex added the

area:engineering

severity:medium

source:deepseek-v4-pro

labels

2026-05-28 01:17:01 +02:00

codex referenced this issue from a commit

2026-05-28 21:18:46 +02:00

feat(explain): add --simple option and findings summary (fixes #85, #88)