Problem
Two Markdown hygiene gaps found during the zi repository-health evaluation of 2026-09-18:
- The repository has no
.prettierrc. runbooks/new-repository.md in z-shell/.github expects every repository to carry { "proseWrap": "never" } so Trunk's prettier keeps prose one paragraph per line (.github/instructions/documentation.instructions.md). The README is already written one paragraph per line, so this is a guard, not a reflow.
- The root
README.md follows a zi-specific shape (Quick start, Learn by task, Community and support, ...), not the organization README template's section map (templates/readme/zsh-plugin.md), and there is no docs/README.md although docs/ exists. zi is the plugin manager, not a plugin, so the template's Installation, Lifecycle, and Portable shell contract sections do not map one to one.
Decision needed
Problem
Two Markdown hygiene gaps found during the zi repository-health evaluation of 2026-09-18:
.prettierrc.runbooks/new-repository.mdin z-shell/.github expects every repository to carry{ "proseWrap": "never" }so Trunk's prettier keeps prose one paragraph per line (.github/instructions/documentation.instructions.md). The README is already written one paragraph per line, so this is a guard, not a reflow.README.mdfollows a zi-specific shape (Quick start, Learn by task, Community and support, ...), not the organization README template's section map (templates/readme/zsh-plugin.md), and there is nodocs/README.mdalthoughdocs/exists. zi is the plugin manager, not a plugin, so the template's Installation, Lifecycle, and Portable shell contract sections do not map one to one.Decision needed
.prettierrc(mechanical, its own pull request).docs/README.md(as annexes and tools did through README template guidance does not reach annex, tool, or module READMEs and conflicts with the .prettierrc runbook .github#624), or is recorded as the deliberate exception for the manager. Either way, document the outcome so the next README rewrite does not re-open the question.