Skip to content

v1.2.0 — Voice & Tone + Design Preferences

Choose a tag to compare

View all tags
@superbasicstudio superbasicstudio released this 16 Feb 23:08
v1.2.0
027c648

Two new templates that give you fine-grained control over how Claude talks and how Claude designs. Framework now ships 10 templates.

What's new

🎙️ Voice & Tone template (_VOICE-AND-TONE.md)

Loaded as step 1 in the session load order — Claude's personality is established before it reads anything else.

Control every aspect of how Claude communicates:

  • Personality settings — Formality, confidence, warmth, humor, and energy level (table format, pick your settings)
  • Attitude — Define the working relationship vibe: pair-programmer, terse expert, patient teacher, whatever fits your style
  • Vocabulary control — Set technical level, sentence length, contractions, and specific words/phrases to use or avoid
  • Banned phrases — Pre-populated with common annoyances: "Certainly!", "Great question!", "As an AI...", "leverage", "robust", etc.
  • Response structure — Lead with answer or context? Code first or prose first? Bullets or paragraphs? Length by context type
  • Code comment style — Frequency, format, TODO conventions, docstring policy
  • Commit message format — Conventional commits, freeform, imperative mood — your call
  • Error communication — How blunt or diplomatic to be, how to handle uncertainty, how to disagree with you
  • Contextual adjustments — Different tones for debugging vs. exploring vs. urgent fixes vs. code review

Every section is customizable with <!-- CUSTOMIZE --> comments and [placeholder] values.

🎨 Design Preferences template (_DESIGN-PREFERENCES.md)

Enforces visual design rules across all UI work:

  • Lighter hover colors only — NEVER darken on hover. Scoped to interactive elements only (buttons, links, clickable cards) — no hover effects on static content like headings or paragraphs
  • Accessibility (MANDATORY) — WCAG AA contrast minimums, keyboard navigation, screen reader support, semantic HTML, prefers-reduced-motion respect
  • Typography — Hierarchy, readability guidelines (16px minimum, 1.5+ line height, 45-75 char line length), responsive units
  • Flat iconography — Tasteful, minimal, single-color icons to reinforce content/categories/steps. No 3D, no decoration-only icons. Always paired with labels
  • UX principles — Consistent spacing scale, progressive disclosure, forgiving inputs, visible feedback on all interactions

📋 Updated session load order

0. _SHORT-TERM-MEMORY.md    ← IF EXISTS (resume interrupted work)
1. _VOICE-AND-TONE.md       ← READ FIRST — personality and language style
2. _GOLDEN-RULES.md         ← BINDING rules — MUST FOLLOW every session
3. _TODOS.md                ← Pending work
4. _LESSONS-LEARNED.md      ← Avoid past mistakes
5. _LONG-TERM-MEMORY.md     ← Persistent knowledge
6. _CONVERSATION-PREFERENCES.md  ← Output formatting
7. _DESIGN-PREFERENCES.md   ← Visual design and UX rules
8. _GOLDEN-RULES.md         ← Re-read (prevent context decay)
9. CLAUDE.md                ← Full project context
10. BEGIN conversation

Voice & Tone is now step 1 — it colors everything Claude says and does for the rest of the session. Golden Rules moved to step 2 as the BINDING enforcement layer that must be consumed and followed every session.

Other changes

  • CLI --full mode now installs 10 templates (up from 8)
  • Anchor Files Reference table updated with FIRST priority for voice/tone and BINDING for golden rules
  • All tests updated and passing (10/10)
  • PII scan confirms zero personal information in any template

Install / Upgrade

# New project
npx claude-anchor --full

# Existing project — add just the new templates
npx claude-anchor --full          # Won't overwrite existing files

# Full refresh — overwrite everything
npx claude-anchor --full --force

All 10 templates

# File Purpose
1 CLAUDE.md Project context + session load order
2 _VOICE-AND-TONE.md Personality, attitude, language style
3 _GOLDEN-RULES.md Immutable security/behavior constraints
4 _TODOS.md Priority-based task tracking
5 _LESSONS-LEARNED.md Past mistakes with root cause + prevention
6 _CONVERSATION-PREFERENCES.md Output formatting and display
7 _DESIGN-PREFERENCES.md Visual design, accessibility, UX rules
8 _LONG-TERM-MEMORY.md Persistent knowledge (NEVER delete)
9 _SHORT-TERM-MEMORY.md Session context (delete when done)
10 _SYSTEM_ARCHITECTURE.md Technical diagrams and system design

Two repos, two tools, complementary not competitive:

Assets 2
Loading