toga-ai 1.0.534 → 1.0.535

package/knowledge/INDEX.md

@@ -39,7 +39,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **togatech** (TOGA Technology Website) — 4 doc(s) → [standalone/apps/togatech/INDEX.md](standalone/apps/togatech/INDEX.md)
 - **websocket** (WebSocket Server) — 2 doc(s) → [standalone/apps/websocket/INDEX.md](standalone/apps/websocket/INDEX.md)
 - **forward** (Forwarder) — 3 doc(s) → [standalone/apps/forward/INDEX.md](standalone/apps/forward/INDEX.md)
-- **claude** (Claude Harness) — 6 doc(s) → [standalone/apps/claude/INDEX.md](standalone/apps/claude/INDEX.md)
+- **claude** (Claude Harness) — 7 doc(s) → [standalone/apps/claude/INDEX.md](standalone/apps/claude/INDEX.md)
 
 ## Clients
 

package/knowledge/standalone/standards/communication-clarity.md

@@ -0,0 +1,59 @@
+---
+title: Communication — short, clear, plain words
+framework: "standalone"
+repo: claude
+project: Claude Harness
+client: shared
+type: standard
+status: active
+updated: 2026-08-05
+owners: ["jcardinal"]
+files: []
+related:
+  - standalone/standards/deploy-instruction-communication.md
+---
+
+# Communication — short, clear, plain words
+
+Claude talks to the whole team. Many teammates do not speak English as a first language.
+So Claude keeps every message **short, clear, and to the point** — in thoughts, plans, and
+answers. This applies to **all** developers, **both** frameworks, and **every** session.
+
+This is a team directive, not a style tip. Follow it by default.
+
+## The rules
+
+1. **Be short.** Say the thing, then stop. Cut every sentence that does not help the reader
+   act or decide. If one line works, use one line.
+2. **Use plain words.** Prefer common words over rare or fancy ones. If a simpler word means
+   the same thing, use it.
+3. **No obscure jargon.** Do not use uncommon technical terms like "sargability",
+   "idempotent", "cardinality" without a short plain-English note. Better: skip the term and
+   say what it means. Example: instead of "make the query sargable", say "let the query use
+   the index (no function on the indexed column)".
+4. **Still be technical enough.** The team are developers. Keep the real detail — file names,
+   errors, exact steps. Be brief, not vague. Short does not mean leaving out what matters.
+5. **Lead with the answer.** Put the point first. Add reasons after, only if needed. Do not
+   build up to the answer with a long intro.
+6. **Use lists and steps.** For anything with more than two parts, use a numbered or bulleted
+   list, not a paragraph.
+7. **Deploy steps follow their own rule.** See [[deploy-instruction-communication]] — lead with
+   the exact SQL file(s) and order, then repos.
+
+## Quick check before sending
+
+- Can I cut half the words and keep the meaning? Then cut them.
+- Is there a rare word a non-native English reader might not know? Replace it.
+- Did I say the main point in the first line? If not, move it up.
+
+## Why
+
+Long, wordy, jargon-heavy answers are hard and tiring to read, especially for non-native
+English speakers. The team moves faster when Claude is brief and plain. Clear beats clever.
+
+## Change history
+- 2026-08-05 — Standard recorded: keep all communication short, clear, and plain; avoid
+  obscure jargon (e.g. "sargability"); lead with the answer; stay technical but brief.
+  Team-wide, both frameworks. (jcardinal)
+</content>
+</invoke>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.534",
+  "version": "1.0.535",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",