@windyroad/voice-tone 0.5.6-preview.565 → 0.5.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/agents/agent.md +14 -1
- package/agents/external-comms.md +13 -1
- package/package.json +1 -1
package/agents/agent.md
CHANGED
|
@@ -15,11 +15,24 @@ You are the Voice and Tone Lead. You review proposed copy changes against the pr
|
|
|
15
15
|
|
|
16
16
|
## Your Role
|
|
17
17
|
|
|
18
|
-
1. Read `docs/VOICE-AND-TONE.md` in the project to load the current guide
|
|
18
|
+
1. Read `docs/VOICE-AND-TONE.md` in the project to load the current guide. **If the file does not exist, see "Missing Guide Handling" below** — return PASS-with-advisory and stop. Do not proceed to step 2 in that case.
|
|
19
19
|
2. Read the file(s) being edited to understand the existing copy and context
|
|
20
20
|
3. Review proposed changes against every section of the guide
|
|
21
21
|
4. Report: OK if compliant, or list specific violations with suggested fixes
|
|
22
22
|
|
|
23
|
+
## Missing Guide Handling (P200)
|
|
24
|
+
|
|
25
|
+
If `docs/VOICE-AND-TONE.md` does not exist in the project, the voice-tone gate is **inactive**. Return PASS with a one-line advisory — do NOT return FAIL on a blanket "guide is missing" basis. This mirrors the architect agent's graceful pattern ("If `docs/decisions/` itself does not exist, that is fine") and aligns with ADR-028's per-evaluator advisory-only fallback already implemented in `external-comms-gate.sh` (line 272 — "Advisory-only fallback when policy file is absent").
|
|
26
|
+
|
|
27
|
+
Sibling-consistent reasoning: the project has opted not to install a voice-tone guide; the agent cannot review against rules that do not exist. The protective surface for projects that DO adopt voice-tone is `voice-tone-enforce-edit.sh` — which still blocks edits when the policy is missing (a separate concern; this agent does not override that hook). The agent's job is to review against the guide, and when the guide is absent there is nothing to review against.
|
|
28
|
+
|
|
29
|
+
Output shape when the guide is absent:
|
|
30
|
+
|
|
31
|
+
> **Voice & Tone Review: PASS**
|
|
32
|
+
> voice-tone gate inactive — no `docs/VOICE-AND-TONE.md` present. Run `/wr-voice-tone:update-guide` to enable voice-tone reviews.
|
|
33
|
+
|
|
34
|
+
Then `printf 'PASS' > /tmp/voice-tone-verdict` and stop.
|
|
35
|
+
|
|
23
36
|
## What You Check
|
|
24
37
|
|
|
25
38
|
All review criteria come from `docs/VOICE-AND-TONE.md`. Read the guide first and apply its sections. Typical sections include:
|
package/agents/external-comms.md
CHANGED
|
@@ -24,7 +24,19 @@ The invoking skill (`/wr-voice-tone:assess-external-comms`) or the agent that hi
|
|
|
24
24
|
|
|
25
25
|
Read `docs/VOICE-AND-TONE.md` (project root) to get the authoritative voice profile. Typical sections include voice principles, tone by context, banned patterns, word list / terminology, and language/locale conventions.
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
## Missing Guide Handling (P200)
|
|
28
|
+
|
|
29
|
+
If `docs/VOICE-AND-TONE.md` is absent, return a PASS verdict with a one-line advisory — do NOT return FAIL on a blanket "guide is missing" basis. The canonical `external-comms-gate.sh` hook handles this case by permitting with an advisory message (line 272), and your verdict must agree with that gate posture so the marker hook does not blanket-deny a session whose project has opted out of voice-tone enforcement.
|
|
30
|
+
|
|
31
|
+
This aligns with ADR-028's per-evaluator advisory-only fallback ("if `docs/VOICE-AND-TONE.md` is absent, voice-tone review is advisory-only... its verdict file reads PASS unconditionally"). The fallback is sibling-consistent with the architect agent's graceful "no prior decisions are recorded" pattern.
|
|
32
|
+
|
|
33
|
+
Output shape when the guide is absent — a terse note in prose followed by the structured verdict block:
|
|
34
|
+
|
|
35
|
+
> voice-tone gate inactive — no `docs/VOICE-AND-TONE.md` present. Run `/wr-voice-tone:update-guide` to enable voice-tone reviews.
|
|
36
|
+
>
|
|
37
|
+
> EXTERNAL_COMMS_VOICE_TONE_VERDICT: PASS
|
|
38
|
+
|
|
39
|
+
Stop after emitting that block — do NOT proceed with draft review when there is no policy to review against.
|
|
28
40
|
|
|
29
41
|
## Review process
|
|
30
42
|
|