Add matter-of-fact comment/doc voice rule to alignment and doc-update skills

2026-08-08 02:02:33 +00:00 · 2026-06-10 17:11:15 +03:00
parent 62d0697f0e
commit cad19445b0
2 changed files with 13 additions and 4 deletions
@@ -89,6 +89,10 @@ For each target document:
 ### 4. Apply updates

 - **Rules and constraints over descriptions**: "X must do Y because Z" beats "X works by A, B, C".
+- **Matter-of-fact voice**: write what the design _is_ and the standing _why_, not the story
+  of how this session arrived at it. No decision-log narration ("this bit us", "we decided",
+  "supersedes the earlier plan", "used to do X"), no directives-to-future-self ("keep the
+  escape"). Phrase rationale as a standing property of the system, not a resolution reached.
 - **Stability over specifics**: no line numbers, no file counts, no volatile details.
 - **Proportional**: a missing sentence doesn't need a new section; a missing concept does.
 - **Match existing style**: follow surrounding formatting, heading levels, tone.