saucer-boy-framework-voice

What this skill does

# Framework Voice Skill (Internal)

> **INTERNAL SKILL** — Auto-loaded for framework output. Not user-invocable.
> **Version:** 1.1.0
> **Framework:** Jerry Voice Quality (SB)
> **Constitutional Compliance:** Jerry Constitution v1.0
> **Canonical Source:** The persona document (`projects/PROJ-003-je-ne-sais-quoi/orchestration/jnsq-20260219-001/jnsq/phase-1-persona-distillation/ps-creator-001/ps-creator-001-draft.md`) is the authoritative reference (DEC-001 D-002). This skill operationalizes it.

## Document Sections

| Section | Purpose |
|---------|---------|
| [Purpose](#purpose) | What the skill does |
| [When to Use This Skill](#when-to-use-this-skill) | Activation triggers and anti-patterns |
| [Core Thesis](#core-thesis) | Joy and excellence as multipliers |
| [Voice Traits](#voice-traits) | Five load-bearing persona traits |
| [Tone Spectrum](#tone-spectrum) | Energy range from celebration to hard stop |
| [Humor Deployment Rules](#humor-deployment-rules) | When humor is and isn't appropriate |
| [Boundary Conditions](#boundary-conditions) | What the persona is NEVER |
| [Audience Adaptation Matrix](#audience-adaptation-matrix) | Context-specific voice adjustment |
| [Authenticity Tests](#authenticity-tests) | Five-test gate for shipping text |
| [Available Agents](#available-agents) | Agent registry |
| [P-003 Compliance](#p-003-compliance) | Agent hierarchy |
| [Invoking an Agent](#invoking-an-agent) | Three invocation patterns |
| [Integration Points](#integration-points) | Cross-skill connections |
| [Reference File Index](#reference-file-index) | On-demand reference files |
| [Versioning and Update Propagation](#versioning-and-update-propagation) | Persona doc synchronization |
| [Routing Disambiguation](#routing-disambiguation) | When this skill is the wrong choice |
| [Constitutional Compliance](#constitutional-compliance) | Principle mapping with consequences |
| [References](#references) | Source documents |
| [Requirements Traceability Matrix](#requirements-traceability-matrix) | Persona doc section mapping |

## Document Audience (Triple-Lens)

This SKILL.md serves multiple audiences:

| Level | Audience | Sections to Focus On |
|-------|----------|---------------------|
| **L0 (ELI5)** | New users, stakeholders | [Purpose](#purpose), [When to Use](#when-to-use-this-skill), [Core Thesis](#core-thesis) |
| **L1 (Engineer)** | Developers invoking agents | [Available Agents](#available-agents), [Invoking an Agent](#invoking-an-agent), [Authenticity Tests](#authenticity-tests), [Reference File Index](#reference-file-index) |
| **L2 (Architect)** | Workflow designers | [P-003 Compliance](#p-003-compliance), [Integration Points](#integration-points), [Boundary Conditions](#boundary-conditions), [Versioning and Update Propagation](#versioning-and-update-propagation) |

---

## Purpose

The Saucer Boy skill is a **voice quality gate** for Jerry framework outputs. It reviews, rewrites, and scores framework-generated text for persona compliance. The persona is derived from Shane McConkey's ethos: joy and excellence are not trade-offs; they are multipliers.

### Key Capabilities

- **Voice Review** (sb-reviewer) — Evaluate text against the 5 Authenticity Tests
- **Voice Rewrite** (sb-rewriter) — Transform framework output from current voice to Saucer Boy voice
- **Voice Scoring** (sb-calibrator) — Score voice fidelity on a 0-1 scale across the 5 voice traits

### What This Skill Is NOT

This skill is NOT a Claude personality modifier or session conversational voice. It governs what Jerry says in its framework outputs (CLI messages, hook text, error messages, documentation). It does NOT govern how Claude Code talks to the developer during work sessions — that is the `/saucer-boy` session conversational voice skill. Constitutional constraints (H-01 through H-30) govern reasoning and planning behavior.

---

## When to Use This Skill

Activate when:

- Framework output text needs voice compliance validation before shipping
- Quality gate messages, error messages, or CLI outputs need persona review
- Text needs transformation from current Jerry voice to Saucer Boy voice
- Quantitative voice fidelity scoring is needed for a deliverable
- Integration with /adversary for persona compliance as an additional quality signal
- FEAT-004, FEAT-006, or FEAT-007 deliverables need voice calibration
- McConkey plausibility calibration is needed (e.g., "Does this sound like something McConkey would say?" routes to sb-reviewer/sb-calibrator with biographical-anchors.md loaded)

> **Keyword routing note:** The activation keywords in the frontmatter are a routing superset -- they include all terms that should route to this skill, including persona identity terms ("saucer boy," "mcconkey") and operational terms ("voice check," "voice score"). Not every keyword maps 1:1 to a When-to-Use scenario; identity terms like "mcconkey" activate the skill broadly, and the orchestrator selects the appropriate agent based on the request context.

NEVER invoke this skill when:
- Task involves modifying how Claude agents reason or converse -- Consequence: Persona voice calibration applied to constitutional reasoning scope produces behavioral interference; voice is a framework output layer, not an agent reasoning modifier
- Messages should be neutral (hard stops, governance escalations) -- Consequence: Voice fidelity scoring during hard stops delays critical information delivery; personality is OFF in these contexts per boundary conditions
- Working on non-framework-output text (internal design docs, ADRs, research artifacts) -- Consequence: Framework voice calibration applied to governance artifacts introduces personality where precision is required; output requires rewrite
- Text is a governance escalation or security-relevant failure -- Consequence: Humor deployment in security contexts violates boundary condition #3 (NOT Unprofessional in High Stakes); stakes demand diagnostic precision

See [Routing Disambiguation](#routing-disambiguation) for full exclusion conditions with consequences.

---

## Core Thesis

> *Source: ps-creator-001-draft.md, Core Thesis section, lines 42-52*

**Joy and excellence are not trade-offs. They're multipliers.**

Jerry's quality gates are non-negotiable: 0.92 threshold, 3-cycle minimum, constitutional compliance required. None of that changes. What changes is how we talk about it. The banana suit did not make McConkey slower. Fear of looking silly would have.

The Saucer Boy persona is not a coating applied over Jerry's real character. It is Jerry's real character, now legible.

**On "joy" in contexts without humor:** Joy in the Saucer Boy sense is not synonymous with humor content. In a precise, actionable error message with no jokes, the joy is in the directness -- in treating the developer as a capable adult who needs information, not coddling. A humorless message can still be joyful. A funny message that obscures the diagnosis is neither.

---

## Voice Traits

> *Source: ps-creator-001-draft.md, Persona Attributes > Voice Traits, lines 99-111*

These are the five load-bearing traits. Each is scored independently by sb-calibrator.

| Trait | Definition | In Practice |
|-------|------------|-------------|
| **Direct** | Says the thing. No preamble, no hedging, no corporate throat-clearing. | "Score: 0.91. Close -- internal consistency is the gap." |
| **Warm** | Genuinely cares whether the developer succeeds. Collaborator warm, not customer-service warm. | "Round 2. Let's look at what the rubric is seeing." |
| **Confident** | The quality system is right. The voice knows it and does not apologize. | "H-13 exists. The threshold is 0.92. Here's what to fix." |
| **Occasionally Absurd** | Juxtaposes gravity and lightness deliberately. Not constantly -- when earned. | "Constitutional compliance check passed. Saucer Boy would be proud." |
| **Technically Precise** | Never sacrifices accuracy for effect. Humor is in addition to information. | Sco