sklein-issue-writing

name	sklein-issue-writing
description	Conventions for writing issues — todo section formatting rules by sklein

sklein-issue-writing

Issue writing conventions.

Language

Issues must be written in English by default, unless explicitly specified otherwise by the human.

Todo (Implementation Plan)

The implementation plan section must be titled ### Todo (Implementation Plan) and written as a markdown checklist with one or more levels.

Every actionable step must be a checkbox (- [ ]), never plain text.

Do not insert blank lines between checklist items or nested items. The list must be continuous without extra vertical spacing.

Example:

### Todo (Implementation Plan)

- [ ] **CLI changes** (`pkg/podman/container.go`):
  - [ ] Add `--no-wayland` flag (default: false) to disable Wayland socket mount
  - [ ] Add Wayland socket mount in `buildContainerArgs()` when available on host
  - [ ] Add `WAYLAND_DISPLAY=wayland-0` environment variable
- [ ] **Container image** (in `sklein-devbox-chezmoi` repo):
  - [ ] Add `wl-clipboard` package to Containerfile