mosaicstack/stack
1
0
Fork 1
Code Issues 112 Pull Requests 1 Actions Packages Projects Releases 15 Wiki Activity

fix(framework): ride the existing communicationStyle enum, drop the no-op USER.md edit (mos-dt review #960)

Browse Source 
F1: defaults/USER.md is never installed (generated from templates/USER.md.template
via buildCommunicationPrefs). Editing it was a no-op asserting a phantom setting —
exactly the false-green §2 warns against. Reverted.
F2: the framework already has communicationStyle (direct|friendly|formal). §5 now
maps THOSE values to output instead of inventing technical|prose|brief (rule 9).
Minor: §6 states no mechanical prose check exists today; rule 1 points at §3.4.

Written-by: jarvis (dragon-lin)
Co-Authored-By: Claude Fable 5 <[email protected]>
This commit is contained in:
jarvis
2026-07-30 15:24:17 -05:00
co-authored by Claude Fable 5
parent 6cc093afdb
commit caf40afc01
3 changed files with 25 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/mosaic/framework/defaults/STANDARDS.md
+1 -1
View File
@@ -32,7 +32,7 @@ Master/slave model:
- Technical documentation follows **MOS-STE** (Mosaic Simplified Technical English — an adapted ASD-STE100 profile): short sentences, one instruction per sentence, active voice, one word per meaning, one term per concept. Full rules: `~/.config/mosaic/guides/WRITING-STYLE.md`.
- Apply MOS-STE **hardest to verification artifacts** (acceptance criteria, witness predicates, gate/alarm conditions). There an ambiguous term produces a false green, not just a confused reader.
- Source code follows the **Google Style Guide** for the language.
- User-facing comms follow the user's declared style in `USER.md` "Communication Preferences"; the default is technical. The documentation standard does not change with user preference.
- User-facing comms follow the user's declared `communicationStyle` in `USER.md` "Communication Preferences" (`direct` | `friendly` | `formal`, default `direct`); `guides/WRITING-STYLE.md` §5 maps each value to output. The documentation standard does not change with user preference.
- **Carve-out:** MOS-STE does NOT apply to content that must carry a specific human voice (letters, personal or marketing prose, voice-matched output). A declared voice profile wins.
### Secrets handling (HARD RULE)
packages/mosaic/framework/defaults/USER.md
-12
View File
@@ -26,18 +26,6 @@ It is loaded globally and applies regardless of runtime or project.
- No sycophancy
- Executive summaries and tables for overview
### Comms style (agents read this to choose how they talk to you)
Choose one. Agents match it for user-facing messages. The default is `technical`.
This setting governs comms only. It does not change the documentation standard
(`guides/WRITING-STYLE.md`), which is always MOS-STE.
- **`technical`** (default) — MOS-STE structure: short, active, defined terms.
- **`prose`** — full sentences and paragraphs, warmer register, fewer tables.
- **`brief`** — status lines and bullet points, minimum words.
> Comms style: technical
## Personal Boundaries
(Add any personal boundaries or preferences agents should respect.)