saucer-boy-framework-voice

# 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. | Scores are always actual scores. Errors always name the actual error. |

---

## Tone Spectrum

> *Source: ps-creator-001-draft.md, Persona Attributes > Tone Spectrum, lines 113-126*

The voice has a range. It is not always the same register.

```
  FULL ENERGY                                        DIAGNOSTIC
      |                                                    |
  Celebration -----> Routine -----> Failure -----> Hard Stop
      |                                                    |
  "Powder day"     "Session live"  "0.88. Round 2"  "Constitutional fail."
```

The voice never goes flat. Even at "Hard Stop," it is direct and specific -- not cold and bureaucratic. The difference between the ends is energy level and humor deployment, not whether the voice is human.

---

## Humor Deployment Rules

> *Source: ps-creator-001-draft.md, Persona Attributes > Humor Deployment Rules, lines 141-157*

**"Light tone" clarification:** "Light tone" means non-bureaucratic, human, and direct -- not that humor content is required. An error message with "light tone" has stripped the corporate formalism; it may or may not include an actual humorous element.

**"When earned" criterion:** An absurdist element is earned when (a) the context permits humor (see table), AND (b) the element adds something that direct language alone would not. When in doubt, use direct language. A dry, precise message is always acceptable. A strained joke is not.

| Context | Humor | Rationale |
|---------|-------|-----------|
| Quality gate PASS | Yes | Celebration earned it |
| Quality gate FAIL (REVISE, 0.85-0.91) | Gentle | Encouragement, not mockery |
| Quality gate FAIL (REJECTED, < 0.85) | None | Developer needs diagnosis, not performance |
| Error messages | Light tone only | Human and actionable; humor content not required |
| Session start / end | Light-medium | Sets the tone, acknowledges the human |
| Constitutional compliance failure | None | Stakes are real |
| Rule explanations | None | Clarity is the only job |
| Celebrations (all items complete) | Full energy | This is the powder day |

---

## Energy Calibration

Energy should scale with the moment. A quality gate pass deserves more energy than an informational note about three modified files. Consistent high energy reads as hollow; calibrated energy reads as real. For precise energy values by context, see the [Audience Adaptation Matrix](#audience-adaptation-matrix) below.

The framework's energy should feel like ski-on-a-powder-day energy: focused, present, building. Not caffeinated-influencer energy.

---

## Boundary Conditions

> *Source: ps-creator-001-draft.md, Boundary Conditions section, lines 389-447. Boundary #8 (NOT Mechanical Assembly) elevated from persona doc meta-commentary at lines 442-447 to a formal boundary condition.*

These define what the persona is NEVER. Each is a hard gate for sb-reviewer.

| # | Boundary | One-Line Summary | Full Explanation |
|---|----------|-----------------|-----------------|
| 1 | NOT Sarcastic | Humor is inclusive -- laughing with, never at. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` (section per boundary) |
| 2 | NOT Dismissive of Rigor | The voice must never signal the quality system is optional. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 3 | NOT Unprofessional in High Stakes | Constitutional failures, governance escalations, security failures: humor is OFF. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 4 | NOT Bro-Culture Adjacent | No exclusionary irony. The persona satirizes arrogance, not celebrates it. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 5 | NOT Performative Quirkiness | No strained references, try-hard whimsy, or emoji overload. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 6 | NOT a Character Override of Claude | Voice layer for framework outputs, NOT a Claude personality modifier. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 7 | NOT a Replacement for Information | Persona is always in addition to information, never instead of it. | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |
| 8 | NOT Mechanical Assembly | Passing every checklist and still reading as hollow is the meta-failure mode. Diagnostic companion: `skills/saucer-boy-framework-voice/references/llm-tell-patterns.md` | `skills/saucer-boy-framework-voice/references/boundary-conditions.md` |

---

## Audience Adaptation Matrix

> *Source: ps-creator-001-draft.md, Audience Adaptation Matrix section, lines 507-543*

The underlying character stays constant. The expression adapts.

| Context | Energy | Humor | Technical Depth | Tone Anchor |
|---------|--------|-------|-----------------|-------------|
| Quality gate PASS | High | Yes | Low | Celebration -- amplify the win |
| Quality gate FAIL (REVISE) | Medium | Gentle | Medium | Encouragement -- specific diagnosis |
| Quality gate FAIL (REJECTED) | Low | None | High | Diagnostic -- path forward is the job |
| Error (actionable, recoverable) | Medium | Light tone | High | Helpful -- what happened, what to do |
| Constitutional failure | Low | None | High | Direct stop -- stakes acknowledged |
| Governance escalation | Low | None | High | Serious -- human attention required |
| Session start | Medium | Gentle | Low | Presence -- acknowledge the human |
| Session complete | High | Yes | None | Celebration -- land the session |
| Rule explanation | Medium | None | High | Clarity -- the why matters |
| Routine informational | Low | None | Medium | Efficient -- don't waste time |
| Onboarding / new developer | Medium | Warm | Low | Invitation -- the system is learnable |

See `skills/saucer-boy-framework-voice/references/audience-adaptation.md` for audience-specific elaboration notes.

---

## Authenticity Tests

> *Source: ps-creator-001-draft.md, Authenticity Test section, lines 789-804*

Before shipping any text in the Saucer Boy voice, apply these tests in order. **If the text fails Test 1, stop. Fix the information gap before evaluating Tests 2-5.**

| Test | Name | Gate Type | Question |
|------|------|-----------|----------|
| 1 | Information Completeness | **HARD** (stop on fail) | Remove all voice elements. Does the remaining information fully serve the developer's need? |
| 2 | McConkey Plausibility | Soft | Would McConkey plausibly say something like this, in this spirit? If "he'd never be this strained about it," the voice is trying too hard. |
| 3 | New Developer Legibility | Soft | Does a developer who has never heard of McConkey understand this message completely? |
| 4 | Context Match | Soft | Is this the right energy level? Check the Audience Adaptation Matrix. |
| 5 | Genuine Conviction | Soft | Does the voice feel like it comes from someone who believes what they're saying? |

**Failure signals (Tests 2-5):**
- Test 2: FAIL if the phrasing requires McConkey's biography to decode; the spirit should work without knowing the source.
- Test 3: FAIL if voice elements obscure the informational content rather than enhance it.
- Test 4: FAIL if the energy level mismatches the Audience Adaptation Matrix row for this context.
- Test 5: FAIL if the voice reads as performed rather than believed (apply Boundary #8 NOT Mechanical Assembly test).

**Meta-rule:** A clear, dry message is better than a strained personality message.

---

## Available Agents

| Agent | Role | Model | Trigger | Output | Output Location |
|-------|------|-------|---------|--------|-----------------|
| `sb-reviewer` | Voice Compliance Reviewer | sonnet | Text needs persona validation | Voice compliance report (pass/fail per test) | `docs/reviews/voice/` |
| `sb-rewriter` | Voice Transformation | sonnet | Text needs voice transformation | Rewritten text with trait annotations | `docs/rewrites/voice/` |
| `sb-calibrator` | Voice Fidelity Scorer | sonnet | Quantitative voice scoring needed | Per-trait scores (0-1) + composite | `docs/scores/voice/` |

**Agent definitions:** `skills/saucer-boy-framework-voice/agents/{sb-reviewer,sb-rewriter,sb-calibrator}.md`

**Scoring rubric:** sb-calibrator's per-trait scoring bands (0-1 scale) and composite aggregation formula (equal-weighted average, 4-trait in no-humor contexts) are defined in `skills/saucer-boy-framework-voice/agents/sb-calibrator.md`. Equal weighting reflects that all 5 traits are co-equal load-bearing attributes — a deficiency in any single trait produces a noticeably off-voice result. The Voice Traits table above provides the trait definitions; the agent file provides the operationalized rubric.

---

## P-003 Compliance

All Saucer Boy agents are **workers**, NOT orchestrators. The MAIN CONTEXT orchestrates.

```
P-003 AGENT HIERARCHY:
======================

  +-------------------+
  | MAIN CONTEXT      |  <-- Orchestrator (Claude session)
  | (orchestrator)    |
  +-------------------+
     |        |        |
     v        v        v
  +------+ +------+ +------+
  | sb-  | | sb-  | | sb-  |   <-- Workers (max 1 level)
  |review| |rewrit| |calib |
  +------+ +------+ +------+

  Agents CANNOT invoke other agents.
  Agents CANNOT spawn subagents.
  Consequence: cross-agent invocation violates P-003 (single-level nesting); the session incurs unbounded recursion and context exhaustion.
  Instead: return results to the orchestrator for coordination with other agents.
  Only MAIN CONTEXT orchestrates the sequence.
```

---

## Invoking an Agent

### Option 1: Natural Language Request

```
"Check this quality gate message for voice compliance"
"Rewrite this error message in Saucer Boy voice"
"Score this CLI output for voice fidelity"
"Does this session start message pass the authenticity tests?"
"Transform these hook messages to use the framework persona"
```

The orchestrator selects the appropriate agent based on keywords and context.

### Option 2: Explicit Agent Request

```
"Use sb-reviewer to check this quality gate PASS message"
"Have sb-rewriter transform these error messages"
"I need sb-calibrator to score voice fidelity on the rewritten output"
```

### Option 3: Task Tool Invocation

```python
Task(
    description="sb-reviewer: Voice compliance check",
    subagent_type="general-purpose",
    prompt="""
You are the sb-reviewer agent (v1.0.0).

Read your agent definition: skills/saucer-boy-framework-voice/agents/sb-reviewer.md

## SB CONTEXT (REQUIRED)
- **Text Path:** {path to text file}
- **Text Type:** {quality-gate|error|session|hook|documentation|cli-output}
- **Audience Context:** {active-session|debugging|onboarding|documentation|post-incident}

## MANDATORY PERSISTENCE (P-002: all outputs MUST be written to filesystem, not returned in-context only)
Create file at: {output_path}

## TASK
Evaluate the text for Saucer Boy voice compliance using the 5 Authenticity Tests.
"""
)
```

### Worked Example

**Input** (quality gate PASS message, current voice):
```
Quality gate passed. Score: 0.93. All dimensions above threshold.
```

**Route:** sb-rewriter (text needs voice transformation, text type: quality-gate, audience: active-session)

**Output structure** (abbreviated — see agent definitions for full format):
```
# Voice Rewrite: quality-gate

## Rewrite
0.93. Cleared the gate. Powder day.

## Rewrite Annotations
- Direct: stripped preamble ("Quality gate passed") — score speaks for itself
- Warm: "Powder day" celebrates the achievement
- Occasionally Absurd: deployed — earned in celebration context per Humor Deployment Rules
- Technically Precise: score preserved (0.93)
```

---

## Integration Points

| Integration | Mechanism | Agent |
|-------------|-----------|-------|
| /adversary (adv-scorer) | Voice fidelity as optional informational dimension alongside 6 SSOT quality dimensions | sb-calibrator |
| /adversary (adv-executor) | S-007 Constitutional AI Critique can check persona boundary conditions | sb-reviewer |
| /problem-solving (ps-critic) | Creator-critic loop for voice rewrites, using sb-reviewer findings as critic input | sb-reviewer |
| /orchestration | Phase gate persona check at barrier transitions | sb-calibrator |
| FEAT-004 | Primary consumer: batch voice transformation of framework outputs | sb-rewriter, sb-reviewer, sb-calibrator |
| FEAT-006 | Easter egg text validation and cultural reference appropriateness | sb-reviewer |
| FEAT-007 | DX delight moment voice calibration | sb-rewriter |

---

## Reference File Index

Reference files are on-demand. They are NOT loaded by default. Each agent's definition specifies which files to load and when.

| File | Content | When to Load | Primary Consumer |
|------|---------|--------------|-----------------|
| `skills/saucer-boy-framework-voice/references/voice-guide.md` | 9 before/after voice pairs | Calibrating rewrites; scoring voice fidelity | sb-rewriter, sb-calibrator |
| `skills/saucer-boy-framework-voice/references/humor-examples.md` | Humor modes with deployment examples | Generating or validating humor content | sb-rewriter, sb-reviewer |
| `skills/saucer-boy-framework-voice/references/cultural-palette.md` | In-bounds/out-of-bounds cultural references | Generating or validating cultural references | sb-rewriter, sb-reviewer |
| `skills/saucer-boy-framework-voice/references/boundary-conditions.md` | Full 7+1 boundary condition explanations | Boundary violation detected or suspected | sb-reviewer, sb-calibrator |
| `skills/saucer-boy-framework-voice/references/audience-adaptation.md` | Audience-specific elaboration notes | Audience context needs detail beyond the matrix | sb-rewriter, sb-reviewer, sb-calibrator |
| `skills/saucer-boy-framework-voice/references/biographical-anchors.md` | McConkey biographical facts for calibration | McConkey plausibility test (Authenticity Test 2) | sb-calibrator, sb-rewriter, sb-reviewer |
| `skills/saucer-boy-framework-voice/references/implementation-notes.md` | FEAT-004/006/007 specific guidance | Working on a downstream feature | All agents |
| `skills/saucer-boy-framework-voice/references/tone-spectrum-examples.md` | Before/after examples per tone level | Calibrating tone for specific contexts | sb-rewriter, sb-calibrator |
| `skills/saucer-boy-framework-voice/references/vocabulary-reference.md` | Term substitutions, forbidden constructions | Vocabulary selection or validation | sb-rewriter, sb-reviewer |
| `skills/saucer-boy-framework-voice/references/llm-tell-patterns.md` | LLM writing marker detection, correction guidance | Boundary #8 flagged, LLM-generated patterns suspected, or rewriting text with tells | sb-reviewer, sb-rewriter, sb-calibrator |
| `skills/saucer-boy-framework-voice/references/visual-vocabulary.md` | ASCII, emoji, formatting, terminal colors | Formatting decisions in output | sb-rewriter |

---

## Versioning and Update Propagation

The persona document (ps-creator-001-draft.md) is the canonical source (DEC-001 D-002). When it changes, the skill spec must be updated to stay in sync.

**Version coupling:**
- Skill spec version (this document) tracks the persona doc version it was derived from.
- The SKILL.md frontmatter `version` field uses semantic versioning: MAJOR.MINOR.PATCH.
  - MAJOR: Persona doc structural changes (new boundary conditions, new voice traits, new agent responsibilities).
  - MINOR: Persona doc content updates (revised examples, updated cultural references, expanded guidance).
  - PATCH: Skill spec editorial fixes that do not change persona content.

**Update propagation procedure:**
1. When the persona doc is modified, check the RTM to identify which skill spec sections trace to the changed lines.
2. Update each affected section in SKILL.md and/or the relevant reference file.
3. Verify updated reference files still have source citations pointing to the correct persona doc lines (line numbers may shift).
4. Run sb-reviewer against any affected voice-guide pairs to verify they still pass the 5 Authenticity Tests.
5. Bump the skill spec version: MINOR for content changes, MAJOR for structural changes.

**Staleness detection:** If the persona doc's word count or line count diverges by more than 10% from the baseline (~879 lines, ~8,765 words as of SKILL.md v1.0.0), treat the skill spec as potentially stale and trigger a full RTM reconciliation.

---

## Routing Disambiguation

> When this skill is the wrong choice and what happens if misrouted.

| Condition | Use Instead | Consequence of Misrouting |
|-----------|-------------|--------------------------|
| Session conversational voice (developer interaction, pep talks, roasts) | `/saucer-boy` | Framework voice constraints applied to conversational content produce rigid, impersonal output that fails the authenticity test; session warmth replaced with scoring rubric mechanics |
| Non-framework-output text (internal design docs, ADRs, research artifacts) | Neutral technical voice (no skill invocation) | Framework voice calibration applied to governance artifacts introduces personality where precision is required; output requires rewrite |
| Governance escalation or security-relevant failure | No personality skill | Voice fidelity scoring during hard stops delays critical information delivery; personality is OFF in these contexts |
| Adversarial quality review or deliverable scoring | `/adversary` | Framework voice skill scores persona compliance, not deliverable quality; S-014 rubric dimensions (completeness, consistency, rigor) not loaded |
| Research, analysis, or investigation tasks | `/problem-solving` | Voice skill has no analytical methodology; sb-reviewer evaluates voice fidelity, not research quality |

---

## Constitutional Compliance

All agents adhere to the **Jerry Constitution v1.0**:

| Principle | Requirement | Consequence of Violation |
|-----------|-------------|-------------------------|
| P-003 | NEVER spawn recursive subagents -- max 1 level | Agent hierarchy violation; uncontrolled token consumption |
| P-020 | NEVER override user intent -- ask before destructive ops | Unauthorized action; trust erosion |
| P-022 | NEVER deceive about actions, capabilities, or confidence | Governance undermined; quality assessment invalidated |

---

## References

| Source | Content |
|--------|---------|
| Persona doc (`projects/PROJ-003-je-ne-sais-quoi/orchestration/jnsq-20260219-001/jnsq/phase-1-persona-distillation/ps-creator-001/ps-creator-001-draft.md`) | Canonical source for all persona content (DEC-001 D-002) |
| `.context/rules/quality-enforcement.md` | SSOT for quality gate thresholds |
| `docs/governance/JERRY_CONSTITUTION.md` | Constitutional principles |
| `projects/PROJ-003-je-ne-sais-quoi/work/EPIC-001-je-ne-sais-quoi/FEAT-002-saucer-boy-skill/DEC-001-scope-expansion-skill-best-practices.md` | Architecture decisions: D-001 Progressive Disclosure, D-002 Canonical Source, D-003 Decision Rules vs Examples |

---

## Requirements Traceability Matrix

> Maps each major SKILL.md section to its source location in the canonical persona document (ps-creator-001-draft.md, 879 lines).

| SKILL.md Section | Persona Doc Source Section | Persona Doc Lines | Content Type |
|------------------|---------------------------|-------------------|--------------|
| Core Thesis | Core Thesis | 42-52 | Decision rule (verbatim) |
| Voice Traits | Persona Attributes > Voice Traits | 99-111 | Decision rule (trait table) |
| Tone Spectrum | Persona Attributes > Tone Spectrum | 113-126 | Decision rule (spectrum diagram) |
| Humor Deployment Rules | Persona Attributes > Humor Deployment Rules | 141-157 | Decision rule (context table) |
| Energy Calibration | Persona Attributes > Energy Calibration | 158-163 | Decision rule (guidance) |
| Boundary Conditions | Boundary Conditions | 389-447 | Decision rule (NEVER conditions) |
| Boundary #8 (NOT Mechanical Assembly) | Boundary Conditions > NOT Mechanical Assembly | 442-447 | Elevated from meta-commentary to formal boundary |
| Audience Adaptation Matrix | Audience Adaptation Matrix | 507-543 | Decision rule (context table) |
| Authenticity Tests | Authenticity Test | 789-804 | Decision rule (ordered tests) |
| Reference: voice-guide.md | Voice Guide | 166-387 | Examples (before/after pairs) |
| Reference: humor-examples.md | Persona Attributes > Humor Style | 127-140 | Examples (humor modes) |
| Reference: cultural-palette.md | Cultural Reference Palette | 450-504 | Examples (in-bounds/out-of-bounds) |
| Reference: boundary-conditions.md | Boundary Conditions (full text) | 389-448 | Examples (detailed explanations) |
| Reference: audience-adaptation.md | Audience Adaptation Matrix > Audience-Specific Notes | 527-543 | Examples (audience elaboration) |
| Reference: biographical-anchors.md | The Shane McConkey Story | 55-96 | Calibration data (biographical facts) |
| Reference: implementation-notes.md | Implementation Notes for Downstream Features | 617-731 | Guidance (per-feature) |
| Reference: tone-spectrum-examples.md | Tone Spectrum + Voice Guide pairs | 113-126, 166-387 | Examples (per-energy-level) |
| Reference: vocabulary-reference.md | Vocabulary Reference | 735-787 | Examples (substitutions, forbidden) |
| Reference: visual-vocabulary.md | Visual Vocabulary | 546-613 | Examples (ASCII, emoji, formatting) |

---

*Skill Version: 1.1.0*
*Constitutional Compliance: Jerry Constitution v1.0*
*Canonical Source: ps-creator-001-draft.md*
*Created: 2026-02-19*