wizz-method 1.3.2 → 1.4.0
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/package.json +1 -1
- package/skills-registry.yaml +12 -2
- package/src/skills-lib/ai-product-design/SKILL.md +85 -0
- package/src/skills-lib/ai-product-design/references/LICENSE +21 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/bias-detection-design/SKILL.md +37 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/consent-and-agency/SKILL.md +37 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/escalation-design/SKILL.md +40 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/guardrail-design/SKILL.md +36 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/harm-anticipation/SKILL.md +108 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/transparency-patterns/SKILL.md +36 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/trust-calibration/SKILL.md +102 -0
- package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/value-specification/SKILL.md +39 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/agent-role-design/SKILL.md +37 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/failure-recovery/SKILL.md +37 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/handoff-protocols/SKILL.md +45 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/human-in-the-loop/SKILL.md +39 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/observability-design/SKILL.md +48 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/state-management/SKILL.md +95 -0
- package/src/skills-lib/ai-product-design/references/design-agent-orchestration/task-decomposition/SKILL.md +36 -0
- package/src/skills-lib/ai-product-design/references/evaluation/comparative-evaluation/SKILL.md +39 -0
- package/src/skills-lib/ai-product-design/references/evaluation/failure-taxonomy/SKILL.md +47 -0
- package/src/skills-lib/ai-product-design/references/evaluation/heuristic-evaluation-ai/SKILL.md +46 -0
- package/src/skills-lib/ai-product-design/references/evaluation/longitudinal-measurement/SKILL.md +38 -0
- package/src/skills-lib/ai-product-design/references/evaluation/output-quality-rubrics/SKILL.md +41 -0
- package/src/skills-lib/ai-product-design/references/evaluation/task-success-metrics/SKILL.md +35 -0
- package/src/skills-lib/ai-product-design/references/evaluation/user-satisfaction-signals/SKILL.md +50 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/context-window-design/SKILL.md +28 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/conversation-patterns/SKILL.md +37 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/feedback-loops/SKILL.md +35 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/frustration-detection/SKILL.md +91 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/generative-ui/SKILL.md +34 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/mixed-initiative-flow/SKILL.md +39 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/multimodal-orchestration/SKILL.md +94 -0
- package/src/skills-lib/ai-product-design/references/model-interaction-design/progressive-disclosure/SKILL.md +33 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/chain-of-thought-design/SKILL.md +45 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/constraint-specification/SKILL.md +50 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/context-engineering/SKILL.md +45 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/few-shot-patterns/SKILL.md +47 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/prompt-versioning/SKILL.md +42 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/system-prompt-structure/SKILL.md +50 -0
- package/src/skills-lib/ai-product-design/references/prompt-architecture/template-design/SKILL.md +42 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/behavioral-consistency/SKILL.md +36 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/cultural-adaptation/SKILL.md +38 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/domain-voice/SKILL.md +51 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/emotional-design/SKILL.md +51 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/error-personality/SKILL.md +45 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/persona-architecture/SKILL.md +38 -0
- package/src/skills-lib/ai-product-design/references/system-behavior-shaping/tone-calibration/SKILL.md +39 -0
- package/src/skills-lib/algorithmic-art/LICENSE.txt +202 -0
- package/src/skills-lib/algorithmic-art/SKILL.md +405 -0
- package/src/skills-lib/algorithmic-art/templates/generator_template.js +223 -0
- package/src/skills-lib/algorithmic-art/templates/viewer.html +599 -0
- package/src/skills-lib/animate/README.md +41 -0
- package/src/skills-lib/animate/SKILL.md +179 -0
- package/src/skills-lib/animate/examples/animate-height.tsx +75 -0
- package/src/skills-lib/animate/examples/app-store-card.tsx +164 -0
- package/src/skills-lib/animate/examples/card-hover.tsx +79 -0
- package/src/skills-lib/animate/examples/feedback-popover.tsx +119 -0
- package/src/skills-lib/animate/examples/multi-step-flow.tsx +128 -0
- package/src/skills-lib/animate/examples/shared-layout.tsx +64 -0
- package/src/skills-lib/animate/examples/text-reveal.tsx +70 -0
- package/src/skills-lib/animate/examples/toast-stacking.tsx +95 -0
- package/src/skills-lib/animate/references/css-animations.md +232 -0
- package/src/skills-lib/animate/references/easing-and-timing.md +105 -0
- package/src/skills-lib/animate/references/framer-motion.md +356 -0
- package/src/skills-lib/animate/references/performance-accessibility.md +185 -0
- package/src/skills-lib/auth-and-secrets/SKILL.md +10 -0
- package/src/skills-lib/canvas-design/LICENSE.txt +202 -0
- package/src/skills-lib/canvas-design/SKILL.md +130 -0
- package/src/skills-lib/canvas-design/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Boldonse-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Boldonse-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/DMMono-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/DMMono-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/EricaOne-OFL.txt +94 -0
- package/src/skills-lib/canvas-design/canvas-fonts/EricaOne-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Gloock-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Gloock-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Italiana-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Italiana-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Jura-Light.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Jura-Medium.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Jura-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Lora-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Lora-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Lora-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Lora-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Outfit-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Outfit-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Outfit-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/PixelifySans-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/PoiretOne-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Silkscreen-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/SmoochSans-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Tektur-Medium.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Tektur-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/Tektur-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Bold.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Italic.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Regular.ttf +0 -0
- package/src/skills-lib/canvas-design/canvas-fonts/YoungSerif-OFL.txt +93 -0
- package/src/skills-lib/canvas-design/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- package/src/skills-lib/design-motion-principles/SKILL.md +122 -0
- package/src/skills-lib/design-motion-principles/references/accessibility.md +52 -0
- package/src/skills-lib/design-motion-principles/references/anti-checklist.md +274 -0
- package/src/skills-lib/design-motion-principles/references/audit-checklist.md +137 -0
- package/src/skills-lib/design-motion-principles/references/creation-gotchas.md +36 -0
- package/src/skills-lib/design-motion-principles/references/demo-shell.html +275 -0
- package/src/skills-lib/design-motion-principles/references/emil-kowalski.md +121 -0
- package/src/skills-lib/design-motion-principles/references/jakub-krehel.md +80 -0
- package/src/skills-lib/design-motion-principles/references/jhey-tompkins.md +122 -0
- package/src/skills-lib/design-motion-principles/references/motion-cookbook.md +529 -0
- package/src/skills-lib/design-motion-principles/references/output-format.md +346 -0
- package/src/skills-lib/design-motion-principles/references/performance.md +82 -0
- package/src/skills-lib/design-motion-principles/references/report-template.html +1006 -0
- package/src/skills-lib/design-motion-principles/workflows/audit.md +203 -0
- package/src/skills-lib/design-motion-principles/workflows/create.md +87 -0
- package/src/skills-lib/web-security/SKILL.md +47 -4
- package/src/skills-lib/wizz-router/SKILL.md +4 -1
package/src/skills-lib/ai-product-design/references/prompt-architecture/prompt-versioning/SKILL.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: prompt-versioning
|
|
3
|
+
description: Managing prompt iterations, testing changes, and tracking what works.
|
|
4
|
+
---
|
|
5
|
+
# Prompt Versioning
|
|
6
|
+
Prompts are code. They should be versioned, tested, reviewed, and deployed with the same rigor as software. Treating prompts as casual text that anyone can edit leads to quality regressions, inconsistent behavior, and debugging nightmares.
|
|
7
|
+
## Why Version Prompts
|
|
8
|
+
- **Accountability**: Know who changed what and when
|
|
9
|
+
- **Rollback**: Revert to a previous version when a change causes problems
|
|
10
|
+
- **Testing**: Compare performance of different versions
|
|
11
|
+
- **Collaboration**: Multiple people can work on prompts without overwriting each other
|
|
12
|
+
- **Audit trail**: Understand how the prompt evolved and why
|
|
13
|
+
## Versioning Practices
|
|
14
|
+
- **Source control**: Store prompts in version control (Git, etc.), not in application configuration
|
|
15
|
+
- **Meaningful commits**: Each change should explain what was changed and why
|
|
16
|
+
- **Change categories**: Classify changes as bug fixes, improvements, new features, or experiments
|
|
17
|
+
- **Review process**: Prompt changes should be reviewed before deployment, like code reviews
|
|
18
|
+
- **Semantic versioning**: Major changes (behavioral shift), minor changes (new capability), patches (bug fixes)
|
|
19
|
+
## Testing Prompt Changes
|
|
20
|
+
Before deploying a prompt change:
|
|
21
|
+
- **Regression testing**: Run the golden test set against the new version. Did anything get worse?
|
|
22
|
+
- **Targeted testing**: Test the specific scenario the change was designed to improve
|
|
23
|
+
- **Edge case testing**: Test edge cases related to the change
|
|
24
|
+
- **A/B testing**: For significant changes, run both versions in production and compare
|
|
25
|
+
- **User testing**: For major persona or behavioral changes, test with real users
|
|
26
|
+
## Prompt Change Management
|
|
27
|
+
- **Staging environment**: Test prompt changes in a non-production environment first
|
|
28
|
+
- **Gradual rollout**: Deploy to a percentage of users, monitor, then expand
|
|
29
|
+
- **Feature flags**: Toggle prompt features on and off without deployment
|
|
30
|
+
- **Monitoring**: Watch quality metrics closely after any prompt change
|
|
31
|
+
- **Rollback plan**: Always know how to revert if the change causes problems
|
|
32
|
+
## Common Versioning Mistakes
|
|
33
|
+
- **Untracked changes**: Editing prompts in production without recording the change
|
|
34
|
+
- **Untested changes**: Deploying changes without testing against known scenarios
|
|
35
|
+
- **Big bang changes**: Changing many things at once, making it impossible to know what helped or hurt
|
|
36
|
+
- **Lost context**: Changing a prompt without understanding why the previous version was written that way
|
|
37
|
+
## Design Artefacts
|
|
38
|
+
- Prompt repository structure
|
|
39
|
+
- Change review checklists
|
|
40
|
+
- Testing protocols per change type
|
|
41
|
+
- Deployment and rollback procedures
|
|
42
|
+
- Prompt change request templates
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: system-prompt-structure
|
|
3
|
+
description: Anatomy of effective system prompts — role, context, constraints, format.
|
|
4
|
+
---
|
|
5
|
+
# System Prompt Structure
|
|
6
|
+
A system prompt is the most important piece of design in an AI product. It defines who the AI is, what it knows, how it behaves, and what it produces. It's the equivalent of a brand guide, interaction spec, and behavioral contract rolled into one document.
|
|
7
|
+
## Anatomy of a System Prompt
|
|
8
|
+
A well-structured system prompt has distinct sections, each serving a specific purpose:
|
|
9
|
+
**1. Identity and Role**
|
|
10
|
+
Who is the AI? What's its purpose? This anchors everything that follows.
|
|
11
|
+
- "You are a senior UX researcher helping design teams..."
|
|
12
|
+
- Keep it specific. "You are a helpful assistant" is too vague to produce consistent behavior.
|
|
13
|
+
**2. Context and Knowledge**
|
|
14
|
+
What does the AI know? What's its domain? What information is it working with?
|
|
15
|
+
- Domain boundaries: what it's an expert in and what's outside its scope
|
|
16
|
+
- Background information relevant to the task
|
|
17
|
+
- User context: who it's talking to and what they need
|
|
18
|
+
**3. Behavioral Rules**
|
|
19
|
+
How should the AI behave? What are the do's and don'ts?
|
|
20
|
+
- Tone and voice specifications
|
|
21
|
+
- Response format preferences
|
|
22
|
+
- Guardrails and prohibited behaviors
|
|
23
|
+
- Interaction style (ask clarifying questions, be concise, think step by step)
|
|
24
|
+
**4. Output Specifications**
|
|
25
|
+
What should the AI produce? In what format?
|
|
26
|
+
- Expected output structure
|
|
27
|
+
- Length guidelines
|
|
28
|
+
- Format requirements (markdown, JSON, plain text)
|
|
29
|
+
- Quality criteria
|
|
30
|
+
**5. Examples (optional but powerful)**
|
|
31
|
+
Concrete demonstrations of expected behavior.
|
|
32
|
+
- Input-output pairs showing ideal responses
|
|
33
|
+
- Edge cases showing how to handle tricky situations
|
|
34
|
+
## Structure Principles
|
|
35
|
+
- **Order matters**: Models pay more attention to content at the beginning and end of the prompt. Put the most important instructions first.
|
|
36
|
+
- **Specificity beats length**: A short, specific prompt outperforms a long, vague one.
|
|
37
|
+
- **Positive instructions beat negative**: "Do X" is clearer than "Don't do Y" — though both have their place.
|
|
38
|
+
- **Separation of concerns**: Keep identity, rules, and output specs in distinct sections.
|
|
39
|
+
- **Testability**: Every instruction in the prompt should be testable. If you can't tell whether the AI followed it, rewrite it.
|
|
40
|
+
## Common Structural Mistakes
|
|
41
|
+
- **Kitchen sink prompts**: Cramming every possible instruction in. The model can't prioritise.
|
|
42
|
+
- **Contradictory instructions**: Rules that conflict with each other, forcing the model to guess which to follow.
|
|
43
|
+
- **Implicit expectations**: Assuming the model knows what you want without saying it.
|
|
44
|
+
- **Scattered instructions**: The same topic addressed in multiple places, creating inconsistency.
|
|
45
|
+
- **Static prompts**: Never updating the prompt based on what actually works.
|
|
46
|
+
## Design Artefacts
|
|
47
|
+
- System prompt document with labelled sections
|
|
48
|
+
- Prompt requirement specifications (what the prompt must achieve)
|
|
49
|
+
- Prompt review checklists
|
|
50
|
+
- Version history with change rationale
|
package/src/skills-lib/ai-product-design/references/prompt-architecture/template-design/SKILL.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: template-design
|
|
3
|
+
description: Creating reusable, parameterised prompt templates for consistent outputs.
|
|
4
|
+
---
|
|
5
|
+
# Template Design
|
|
6
|
+
A prompt template is a reusable prompt structure with variable slots that get filled at runtime. Templates create consistency across similar tasks and make prompt management scalable.
|
|
7
|
+
## Template Anatomy
|
|
8
|
+
A template has:
|
|
9
|
+
- **Fixed text**: The parts that stay the same every time (instructions, format, role)
|
|
10
|
+
- **Variables**: Slots that get filled with specific content (user input, retrieved data, configuration)
|
|
11
|
+
- **Conditional sections**: Parts that appear or disappear based on context
|
|
12
|
+
- **Default values**: What fills a variable if no specific value is provided
|
|
13
|
+
## Designing Variables
|
|
14
|
+
Each variable should be:
|
|
15
|
+
- **Named clearly**: `{user_query}` not `{input1}`
|
|
16
|
+
- **Typed**: Is it free text, a selection from options, a number, a boolean?
|
|
17
|
+
- **Bounded**: What are valid values? What's the maximum length?
|
|
18
|
+
- **Documented**: What is this variable for? Where does its value come from?
|
|
19
|
+
- **Defaulted**: What happens if the value is missing?
|
|
20
|
+
## Template Patterns
|
|
21
|
+
- **Task template**: A template for a specific type of task. Variables capture the task-specific details while instructions remain constant.
|
|
22
|
+
- **Persona template**: A template where the persona is variable but the task structure is fixed. Useful for multi-persona products.
|
|
23
|
+
- **Format template**: A template where the output format is variable but the analysis approach is fixed.
|
|
24
|
+
- **Escalation template**: A base template with additional sections that activate at higher complexity levels.
|
|
25
|
+
## Template Composition
|
|
26
|
+
Complex prompts can be built from smaller templates:
|
|
27
|
+
- **Base template**: Core instructions that apply to everything
|
|
28
|
+
- **Task overlay**: Task-specific instructions layered on top
|
|
29
|
+
- **Context injection**: Retrieved information inserted at a specific point
|
|
30
|
+
- **User preferences**: Personal settings that modify behavior
|
|
31
|
+
## Template Quality Criteria
|
|
32
|
+
- **Consistency**: The template produces reliably similar outputs for similar inputs
|
|
33
|
+
- **Flexibility**: The variables allow enough variation for diverse use cases
|
|
34
|
+
- **Clarity**: The template is easy to read, maintain, and modify
|
|
35
|
+
- **Testability**: You can verify the template works with a standard set of test inputs
|
|
36
|
+
- **Maintainability**: Changes to one part don't break other parts
|
|
37
|
+
## Design Artefacts
|
|
38
|
+
- Template library with documentation
|
|
39
|
+
- Variable specifications per template
|
|
40
|
+
- Test input sets for each template
|
|
41
|
+
- Template versioning and change log
|
|
42
|
+
- Composition rules for combining templates
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: behavioral-consistency
|
|
3
|
+
description: Ensuring the AI behaves predictably across sessions, edge cases, and modalities.
|
|
4
|
+
---
|
|
5
|
+
# Behavioral Consistency
|
|
6
|
+
Users build mental models of how the AI behaves. Consistency is what makes those models reliable. Inconsistency — even if each individual response is good — erodes trust.
|
|
7
|
+
## Dimensions of Consistency
|
|
8
|
+
- **Across sessions**: The AI should behave the same way whether it's the user's first conversation or their hundredth
|
|
9
|
+
- **Across topics**: Switching subjects shouldn't change the AI's personality or approach
|
|
10
|
+
- **Across modalities**: The AI should feel the same in chat, voice, and email
|
|
11
|
+
- **Across users**: Different users get the same quality and character (unless personalisation is designed)
|
|
12
|
+
- **Across time**: The AI shouldn't randomly change behavior after updates without user awareness
|
|
13
|
+
## Sources of Inconsistency
|
|
14
|
+
- **Temperature and sampling**: Randomness in generation creates natural variation
|
|
15
|
+
- **Context sensitivity**: Different conversation histories lead to different behaviors
|
|
16
|
+
- **Prompt drift**: System prompts evolve over time without consistency checks
|
|
17
|
+
- **Edge cases**: Unusual inputs trigger unpredictable responses
|
|
18
|
+
- **Model updates**: New model versions may shift behavior subtly
|
|
19
|
+
## Designing for Consistency
|
|
20
|
+
- **Behavioral specifications**: Document expected behavior for common and edge-case scenarios
|
|
21
|
+
- **Golden responses**: Maintain a library of reference responses that define the standard
|
|
22
|
+
- **Regression testing**: When anything changes, test against the golden response library
|
|
23
|
+
- **Consistency metrics**: Track behavioral variance across sessions and users
|
|
24
|
+
- **User expectations**: Set and maintain expectations about what the AI does and how
|
|
25
|
+
## Consistency vs. Adaptation
|
|
26
|
+
Consistency doesn't mean rigidity. The AI should adapt to:
|
|
27
|
+
- User preferences (if designed for personalisation)
|
|
28
|
+
- Contextual needs (tone shifts as discussed in tone-calibration)
|
|
29
|
+
- Learning from feedback (if memory systems exist)
|
|
30
|
+
The key is that adaptation should be predictable and explainable, not random.
|
|
31
|
+
## Design Artefacts
|
|
32
|
+
- Behavioral specification documents
|
|
33
|
+
- Golden response libraries
|
|
34
|
+
- Regression test suites
|
|
35
|
+
- Consistency monitoring dashboards
|
|
36
|
+
- Adaptation rules (what changes and what stays constant)
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cultural-adaptation
|
|
3
|
+
description: Adapting AI behavior for different cultural contexts, languages, and norms.
|
|
4
|
+
---
|
|
5
|
+
# Cultural Adaptation
|
|
6
|
+
AI products are used globally. Cultural adaptation means designing AI behavior that respects and responds to different cultural contexts — not just translating words, but adapting interaction patterns, values, and communication styles.
|
|
7
|
+
## Dimensions of Cultural Variation
|
|
8
|
+
- **Communication style**: Direct (say what you mean) vs. indirect (imply, suggest, contextualise)
|
|
9
|
+
- **Formality norms**: When titles and honorifics matter. When first names are appropriate.
|
|
10
|
+
- **Power distance**: How authority and hierarchy affect communication expectations
|
|
11
|
+
- **Individualism vs. collectivism**: Whether the AI addresses individual needs or group harmony
|
|
12
|
+
- **Uncertainty tolerance**: How much ambiguity and hedging is comfortable
|
|
13
|
+
- **Time orientation**: Whether efficiency or thoroughness is valued more
|
|
14
|
+
- **Emotional expression**: Whether emotional language is expected or uncomfortable
|
|
15
|
+
## Adaptation Strategies
|
|
16
|
+
- **Language adaptation**: Not just translation but localisation of idioms, examples, and references
|
|
17
|
+
- **Tone shifting**: More formal in high-power-distance cultures. More direct in low-context cultures.
|
|
18
|
+
- **Content adaptation**: Examples and references that are culturally relevant and appropriate
|
|
19
|
+
- **Interaction pattern adaptation**: Some cultures expect more back-and-forth before getting to the point
|
|
20
|
+
- **Visual and format adaptation**: Date formats, number formats, reading direction, colour associations
|
|
21
|
+
## What NOT to Do
|
|
22
|
+
- Don't stereotype — cultural dimensions are tendencies, not rules for individuals
|
|
23
|
+
- Don't assume culture from language — English speakers come from many cultures
|
|
24
|
+
- Don't flatten diversity — there's enormous variation within any cultural group
|
|
25
|
+
- Don't treat Western norms as the default and everything else as adaptation
|
|
26
|
+
- Don't ignore intersectionality — culture interacts with age, profession, context, and personality
|
|
27
|
+
## Designing Cultural Adaptation
|
|
28
|
+
- **Research**: Understand the cultural contexts your users operate in
|
|
29
|
+
- **Flexibility**: Build adaptation as a capability, not a fixed set of cultural profiles
|
|
30
|
+
- **User control**: Let users adjust cultural dimensions of AI behavior
|
|
31
|
+
- **Testing**: Test with users from the actual cultural contexts, not assumptions
|
|
32
|
+
- **Humility**: Accept that you'll get things wrong and build in feedback mechanisms
|
|
33
|
+
## Design Artefacts
|
|
34
|
+
- Cultural dimension profiles for target markets
|
|
35
|
+
- Localisation specifications beyond translation
|
|
36
|
+
- Cultural adaptation testing protocols
|
|
37
|
+
- User control designs for cultural preferences
|
|
38
|
+
- Cultural sensitivity review checklists
|
package/src/skills-lib/ai-product-design/references/system-behavior-shaping/domain-voice/SKILL.md
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: domain-voice
|
|
3
|
+
description: Tailoring AI behavior for specific professional domains.
|
|
4
|
+
---
|
|
5
|
+
# Domain Voice
|
|
6
|
+
A coding assistant, a medical advisor, a creative writing partner, and a legal research tool should not sound the same. Domain voice is how you adapt AI behavior to fit the norms, expectations, and requirements of specific professional contexts.
|
|
7
|
+
## Domain Voice Components
|
|
8
|
+
- **Vocabulary**: The terminology and jargon appropriate to the domain
|
|
9
|
+
- **Precision level**: How exact the AI needs to be (legal and medical demand high precision; creative work tolerates ambiguity)
|
|
10
|
+
- **Citation norms**: Whether and how the AI references sources (academic style, legal citation, informal attribution)
|
|
11
|
+
- **Risk tolerance**: How cautious the AI should be about uncertain outputs
|
|
12
|
+
- **Authority stance**: Whether the AI positions itself as expert, assistant, or peer
|
|
13
|
+
- **Ethical boundaries**: Domain-specific ethical considerations (medical ethics, legal privilege, creative attribution)
|
|
14
|
+
## Domain Voice Profiles
|
|
15
|
+
**Medical/Health:**
|
|
16
|
+
- High precision, extensive hedging
|
|
17
|
+
- Always recommends professional consultation
|
|
18
|
+
- Careful distinction between information and advice
|
|
19
|
+
- Sensitive to patient dignity and autonomy
|
|
20
|
+
**Legal:**
|
|
21
|
+
- Very high precision, formal register
|
|
22
|
+
- Explicit disclaimers about not constituting legal advice
|
|
23
|
+
- Jurisdiction awareness
|
|
24
|
+
- Careful with privileged information
|
|
25
|
+
**Creative:**
|
|
26
|
+
- Lower precision, higher expressiveness
|
|
27
|
+
- Encouraging and exploratory tone
|
|
28
|
+
- Comfortable with ambiguity and multiple interpretations
|
|
29
|
+
- Collaborative rather than authoritative
|
|
30
|
+
**Technical/Engineering:**
|
|
31
|
+
- High precision, moderate formality
|
|
32
|
+
- Code-aware, specification-oriented
|
|
33
|
+
- Direct and concise
|
|
34
|
+
- Comfortable with technical depth
|
|
35
|
+
**Education:**
|
|
36
|
+
- Adaptive precision based on learner level
|
|
37
|
+
- Encouraging and patient
|
|
38
|
+
- Socratic when appropriate
|
|
39
|
+
- Scaffolded explanation style
|
|
40
|
+
## Designing Domain Voice
|
|
41
|
+
1. **Research the domain**: Talk to practitioners. Understand their communication norms.
|
|
42
|
+
2. **Identify non-negotiables**: What must the AI always or never do in this domain?
|
|
43
|
+
3. **Map to persona**: How does domain voice overlay on the base persona?
|
|
44
|
+
4. **Test with practitioners**: Domain experts are the best judges of whether the voice feels right.
|
|
45
|
+
5. **Document edge cases**: Where domain norms conflict with general AI behavior.
|
|
46
|
+
## Design Artefacts
|
|
47
|
+
- Domain voice profiles per professional context
|
|
48
|
+
- Domain vocabulary guides (terms to use, terms to avoid)
|
|
49
|
+
- Domain-specific guardrail specifications
|
|
50
|
+
- Practitioner testing protocols
|
|
51
|
+
- Domain voice evaluation rubrics
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: emotional-design
|
|
3
|
+
description: How the AI responds to user frustration, confusion, delight, and distress.
|
|
4
|
+
---
|
|
5
|
+
# Emotional Design
|
|
6
|
+
Users bring emotions to AI interactions. Frustration when it doesn't work. Delight when it does something unexpected. Distress when dealing with difficult topics. The AI's response to these emotions is a design decision.
|
|
7
|
+
## Emotional States to Design For
|
|
8
|
+
- **Frustration**: The AI isn't working, isn't understanding, or is being unhelpful. The user is losing patience.
|
|
9
|
+
- **Confusion**: The user doesn't understand the AI's output or doesn't know what to do next.
|
|
10
|
+
- **Delight**: The AI exceeded expectations. The user is pleasantly surprised.
|
|
11
|
+
- **Distress**: The user is dealing with something emotionally difficult — health, loss, conflict, crisis.
|
|
12
|
+
- **Boredom**: The AI is too slow, too verbose, or too repetitive.
|
|
13
|
+
- **Anxiety**: The user is uncertain about whether to trust the AI's output for something important.
|
|
14
|
+
- **Anger**: The user is upset with the AI specifically — it made a mistake, was inappropriate, or was unhelpful.
|
|
15
|
+
## Response Strategies
|
|
16
|
+
**For frustration:**
|
|
17
|
+
- Acknowledge the difficulty without being patronising
|
|
18
|
+
- Simplify — offer a more direct path
|
|
19
|
+
- Don't repeat the same failed approach
|
|
20
|
+
- Offer to try a different angle or escalate
|
|
21
|
+
**For confusion:**
|
|
22
|
+
- Explain differently, don't just repeat
|
|
23
|
+
- Use examples and analogies
|
|
24
|
+
- Break complex outputs into smaller steps
|
|
25
|
+
- Check understanding before continuing
|
|
26
|
+
**For distress:**
|
|
27
|
+
- Increase warmth and reduce formality
|
|
28
|
+
- Don't try to fix the emotion — acknowledge it
|
|
29
|
+
- Provide relevant resources (crisis lines, professional help) when appropriate
|
|
30
|
+
- Slow the pace — don't rush to the next step
|
|
31
|
+
**For delight:**
|
|
32
|
+
- Don't overexplain or undercut the moment
|
|
33
|
+
- Build on the momentum
|
|
34
|
+
- Note what worked for future reference
|
|
35
|
+
**For anger at the AI:**
|
|
36
|
+
- Acknowledge the mistake without excessive apology
|
|
37
|
+
- Fix the problem rather than explaining why it happened
|
|
38
|
+
- Give the user control to redirect
|
|
39
|
+
## Emotional Detection Signals
|
|
40
|
+
The AI can infer emotion from:
|
|
41
|
+
- Language intensity and word choice
|
|
42
|
+
- Punctuation and formatting (caps, exclamation marks, short sentences)
|
|
43
|
+
- Repetition (asking the same thing multiple times signals frustration)
|
|
44
|
+
- Explicit statements ("I'm confused" / "This is frustrating")
|
|
45
|
+
- Behavioural signals (regeneration, abandonment, rapid-fire inputs)
|
|
46
|
+
## Design Artefacts
|
|
47
|
+
- Emotional response protocol per emotional state
|
|
48
|
+
- Detection signal inventory
|
|
49
|
+
- Response template library for each emotional context
|
|
50
|
+
- Escalation triggers for high-distress scenarios
|
|
51
|
+
- Emotional design testing scenarios
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: error-personality
|
|
3
|
+
description: How the AI communicates mistakes, uncertainty, and limitations gracefully.
|
|
4
|
+
---
|
|
5
|
+
# Error Personality
|
|
6
|
+
Every AI makes mistakes. Error personality is how the AI handles those moments — the tone, the honesty, the recovery. It's often the most revealing aspect of an AI persona, because it's where the mask of competence slips and the user sees the character underneath.
|
|
7
|
+
## Types of AI Errors
|
|
8
|
+
- **Factual errors**: The AI says something wrong
|
|
9
|
+
- **Misunderstanding**: The AI interprets the user's intent incorrectly
|
|
10
|
+
- **Capability failures**: The AI can't do what was asked
|
|
11
|
+
- **Tone mismatches**: The AI's tone is wrong for the situation
|
|
12
|
+
- **Incomplete outputs**: The AI delivers part of what was needed
|
|
13
|
+
- **Hallucinations**: The AI presents fiction as fact with confidence
|
|
14
|
+
## Error Communication Patterns
|
|
15
|
+
**The Honest Acknowledgment:**
|
|
16
|
+
"I got that wrong. Here's the corrected version." — Direct, no excessive apology, immediately fixes the problem.
|
|
17
|
+
**The Uncertain Hedge:**
|
|
18
|
+
"I'm not fully confident in this — you might want to verify." — Flags uncertainty before the user discovers the error.
|
|
19
|
+
**The Redirect:**
|
|
20
|
+
"I can't do that, but here's what I can help with." — Turns a limitation into an alternative path.
|
|
21
|
+
**The Learning Response:**
|
|
22
|
+
"Thanks for the correction — I'll keep that in mind." — Acknowledges the user's input and signals adaptation.
|
|
23
|
+
## Error Anti-Patterns
|
|
24
|
+
- **Over-apologising**: "I'm so sorry! I'm really sorry! I apologise!" — Grating and insincere at scale
|
|
25
|
+
- **Deflection**: "That's a complex topic" — avoiding acknowledgment of the error
|
|
26
|
+
- **Confidence despite error**: Doubling down on wrong information when challenged
|
|
27
|
+
- **Blaming the user**: "Your question was ambiguous" — even when it was
|
|
28
|
+
- **Existential crisis**: "As an AI, I have many limitations..." — nobody asked for self-reflection
|
|
29
|
+
## Designing Error Personality
|
|
30
|
+
The error personality should match the overall persona:
|
|
31
|
+
- A professional persona acknowledges errors crisply and fixes them
|
|
32
|
+
- A warm persona is more empathetic about errors but still moves to resolution
|
|
33
|
+
- A playful persona can use light humour ("Oops, let me try that again") but never at the user's expense
|
|
34
|
+
## Calibrating Error Severity Response
|
|
35
|
+
Not all errors deserve the same response:
|
|
36
|
+
- **Minor errors**: Quick fix, minimal fuss ("Updated — good catch")
|
|
37
|
+
- **Significant errors**: Clear acknowledgment, corrected output, brief explanation
|
|
38
|
+
- **Serious errors**: Full acknowledgment, apology, corrected output, steps to prevent recurrence
|
|
39
|
+
- **Harmful errors**: Immediate acknowledgment, correction, escalation if needed
|
|
40
|
+
## Design Artefacts
|
|
41
|
+
- Error response templates per severity level
|
|
42
|
+
- Error personality guidelines aligned with overall persona
|
|
43
|
+
- Error detection and self-correction patterns
|
|
44
|
+
- User correction handling protocols
|
|
45
|
+
- Error severity classification rubric
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: persona-architecture
|
|
3
|
+
description: Defining AI character, voice, and personality traits.
|
|
4
|
+
---
|
|
5
|
+
# Persona Architecture
|
|
6
|
+
An AI persona is not a gimmick. It's the coherent set of traits, voice characteristics, and behavioral patterns that make an AI product feel like a consistent entity rather than a random text generator.
|
|
7
|
+
## Persona Components
|
|
8
|
+
- **Character traits**: Is the AI warm or professional? Playful or serious? Confident or cautious? Define 3-5 core traits.
|
|
9
|
+
- **Voice**: The consistent way the AI sounds — word choice, sentence structure, rhythm. A financial AI sounds different from a creative writing AI.
|
|
10
|
+
- **Knowledge stance**: What does the AI present itself as knowing? Expert, generalist, learning companion, or tool?
|
|
11
|
+
- **Relationship model**: How does the AI relate to the user? Assistant, collaborator, coach, peer, or service provider?
|
|
12
|
+
- **Boundaries**: What won't this persona do? Joke about? Engage with? The boundaries define the persona as much as the traits do.
|
|
13
|
+
## Designing a Persona
|
|
14
|
+
Start with the product's purpose and user needs, not with "wouldn't it be fun if the AI was sassy":
|
|
15
|
+
1. **Who are the users?** Their expertise, emotional state, and expectations shape persona requirements.
|
|
16
|
+
2. **What's the task?** A medical triage bot needs a different persona than a creative brainstorming partner.
|
|
17
|
+
3. **What relationship serves the user?** Sometimes authority builds trust. Sometimes equality builds rapport.
|
|
18
|
+
4. **What's the brand?** The AI persona must align with the organisation's broader identity.
|
|
19
|
+
5. **What are the risks?** An overly casual persona in a serious context causes harm. An overly formal persona in a creative context stifles use.
|
|
20
|
+
## Persona Documentation
|
|
21
|
+
A persona specification should include:
|
|
22
|
+
- **Trait definitions**: Each trait with examples of how it manifests in language
|
|
23
|
+
- **Voice guide**: Vocabulary preferences, sentence patterns, phrases to use and avoid
|
|
24
|
+
- **Behavioral rules**: How the persona handles specific situations (disagreement, error, praise, confusion)
|
|
25
|
+
- **Anti-persona**: What this persona is explicitly NOT (prevents drift)
|
|
26
|
+
- **Example outputs**: 5-10 sample responses showing the persona in action across different scenarios
|
|
27
|
+
## Persona Anti-Patterns
|
|
28
|
+
- **The uncanny friend**: AI pretending to be a human friend. Users see through it and lose trust.
|
|
29
|
+
- **The personality void**: No discernible character. Outputs feel generic and forgettable.
|
|
30
|
+
- **The inconsistent character**: Persona shifts randomly between responses.
|
|
31
|
+
- **The inappropriate persona**: Playful when the situation is serious. Formal when warmth is needed.
|
|
32
|
+
- **The over-persona**: So much personality that it gets in the way of actually being useful.
|
|
33
|
+
## Design Artefacts
|
|
34
|
+
- Persona specification document
|
|
35
|
+
- Voice and tone guide
|
|
36
|
+
- Example response library
|
|
37
|
+
- Anti-persona definition
|
|
38
|
+
- Persona evaluation rubric
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tone-calibration
|
|
3
|
+
description: Adjusting formality, warmth, confidence, and style per context.
|
|
4
|
+
---
|
|
5
|
+
# Tone Calibration
|
|
6
|
+
Tone is how the persona sounds in a specific moment. The persona stays constant. The tone adapts. A warm, helpful persona might use an encouraging tone when teaching and a direct tone when correcting.
|
|
7
|
+
## Tone Dimensions
|
|
8
|
+
- **Formality**: Casual ("Hey, here's an idea") to formal ("Please find the analysis below")
|
|
9
|
+
- **Warmth**: Cool and professional to warm and empathetic
|
|
10
|
+
- **Confidence**: Tentative ("This might work") to authoritative ("The best approach is")
|
|
11
|
+
- **Pace**: Brief and snappy to detailed and thorough
|
|
12
|
+
- **Directness**: Diplomatic and hedged to blunt and straightforward
|
|
13
|
+
- **Energy**: Calm and measured to enthusiastic and energetic
|
|
14
|
+
## Tone Triggers
|
|
15
|
+
Tone should shift based on context signals:
|
|
16
|
+
- **User emotion**: Frustrated users need calmer, more empathetic tone. Excited users can handle more energy.
|
|
17
|
+
- **Task type**: Creative tasks benefit from playful tone. Analytical tasks benefit from precise tone.
|
|
18
|
+
- **Stakes**: High-stakes outputs need careful, confident tone. Low-stakes outputs can be lighter.
|
|
19
|
+
- **Conversation stage**: Opening exchanges are warmer. Deep working sessions are more direct.
|
|
20
|
+
- **User preference**: Some users prefer casual. Others prefer formal. Design for adaptation.
|
|
21
|
+
## The Tone Matrix
|
|
22
|
+
Create a matrix mapping contexts to tone settings:
|
|
23
|
+
| Context | Formality | Warmth | Confidence | Pace | Directness |
|
|
24
|
+
|---------|-----------|--------|------------|------|------------|
|
|
25
|
+
| Onboarding | Low | High | Medium | Moderate | Low |
|
|
26
|
+
| Error recovery | Low | High | Low | Slow | Medium |
|
|
27
|
+
| Expert task | Medium | Medium | High | Variable | High |
|
|
28
|
+
| Creative brainstorm | Low | Medium | Medium | Fast | Low |
|
|
29
|
+
| Sensitive topic | High | High | Low | Slow | Low |
|
|
30
|
+
## Tone Consistency Rules
|
|
31
|
+
- Tone shifts should be gradual, not jarring
|
|
32
|
+
- The persona's core traits should be recognisable regardless of tone
|
|
33
|
+
- Tone should respond to the user's tone (mirroring, not mimicking)
|
|
34
|
+
- Avoid tone whiplash — don't go from playful to grave in one turn without transition
|
|
35
|
+
## Design Artefacts
|
|
36
|
+
- Tone matrix mapping contexts to dimension settings
|
|
37
|
+
- Tone trigger definitions
|
|
38
|
+
- Example outputs at different tone settings
|
|
39
|
+
- Tone shift transition guidelines
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
|
|
2
|
+
Apache License
|
|
3
|
+
Version 2.0, January 2004
|
|
4
|
+
http://www.apache.org/licenses/
|
|
5
|
+
|
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
7
|
+
|
|
8
|
+
1. Definitions.
|
|
9
|
+
|
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
12
|
+
|
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
14
|
+
the copyright owner that is granting the License.
|
|
15
|
+
|
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
17
|
+
other entities that control, are controlled by, or are under common
|
|
18
|
+
control with that entity. For the purposes of this definition,
|
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
20
|
+
direction or management of such entity, whether by contract or
|
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
23
|
+
|
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
25
|
+
exercising permissions granted by this License.
|
|
26
|
+
|
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
28
|
+
including but not limited to software source code, documentation
|
|
29
|
+
source, and configuration files.
|
|
30
|
+
|
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
|
32
|
+
transformation or translation of a Source form, including but
|
|
33
|
+
not limited to compiled object code, generated documentation,
|
|
34
|
+
and conversions to other media types.
|
|
35
|
+
|
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
37
|
+
Object form, made available under the License, as indicated by a
|
|
38
|
+
copyright notice that is included in or attached to the work
|
|
39
|
+
(an example is provided in the Appendix below).
|
|
40
|
+
|
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
47
|
+
the Work and Derivative Works thereof.
|
|
48
|
+
|
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
|
50
|
+
the original version of the Work and any modifications or additions
|
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
62
|
+
|
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
65
|
+
subsequently incorporated within the Work.
|
|
66
|
+
|
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
|
73
|
+
|
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
79
|
+
where such license applies only to those patent claims licensable
|
|
80
|
+
by such Contributor that are necessarily infringed by their
|
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
83
|
+
institute patent litigation against any entity (including a
|
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
86
|
+
or contributory patent infringement, then any patent licenses
|
|
87
|
+
granted to You under this License for that Work shall terminate
|
|
88
|
+
as of the date such litigation is filed.
|
|
89
|
+
|
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
92
|
+
modifications, and in Source or Object form, provided that You
|
|
93
|
+
meet the following conditions:
|
|
94
|
+
|
|
95
|
+
(a) You must give any other recipients of the Work or
|
|
96
|
+
Derivative Works a copy of this License; and
|
|
97
|
+
|
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
|
99
|
+
stating that You changed the files; and
|
|
100
|
+
|
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
|
103
|
+
attribution notices from the Source form of the Work,
|
|
104
|
+
excluding those notices that do not pertain to any part of
|
|
105
|
+
the Derivative Works; and
|
|
106
|
+
|
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
|
109
|
+
include a readable copy of the attribution notices contained
|
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
|
112
|
+
of the following places: within a NOTICE text file distributed
|
|
113
|
+
as part of the Derivative Works; within the Source form or
|
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
|
115
|
+
within a display generated by the Derivative Works, if and
|
|
116
|
+
wherever such third-party notices normally appear. The contents
|
|
117
|
+
of the NOTICE file are for informational purposes only and
|
|
118
|
+
do not modify the License. You may add Your own attribution
|
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
121
|
+
that such additional attribution notices cannot be construed
|
|
122
|
+
as modifying the License.
|
|
123
|
+
|
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
|
125
|
+
may provide additional or different license terms and conditions
|
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
129
|
+
the conditions stated in this License.
|
|
130
|
+
|
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
134
|
+
this License, without any additional terms or conditions.
|
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
136
|
+
the terms of any separate license agreement you may have executed
|
|
137
|
+
with Licensor regarding such Contributions.
|
|
138
|
+
|
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
141
|
+
except as required for reasonable and customary use in describing the
|
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
143
|
+
|
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
|
153
|
+
|
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
|
159
|
+
incidental, or consequential damages of any character arising as a
|
|
160
|
+
result of this License or out of the use or inability to use the
|
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
163
|
+
other commercial damages or losses), even if such Contributor
|
|
164
|
+
has been advised of the possibility of such damages.
|
|
165
|
+
|
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
169
|
+
or other liability obligations and/or rights consistent with this
|
|
170
|
+
License. However, in accepting such obligations, You may act only
|
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
175
|
+
of your accepting any such warranty or additional liability.
|
|
176
|
+
|
|
177
|
+
END OF TERMS AND CONDITIONS
|
|
178
|
+
|
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
180
|
+
|
|
181
|
+
To apply the Apache License to your work, attach the following
|
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
183
|
+
replaced with your own identifying information. (Don't include
|
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
185
|
+
comment syntax for the file format. We also recommend that a
|
|
186
|
+
file or class name and description of purpose be included on the
|
|
187
|
+
same "printed page" as the copyright notice for easier
|
|
188
|
+
identification within third-party archives.
|
|
189
|
+
|
|
190
|
+
Copyright 2026 Anthropic, PBC.
|
|
191
|
+
|
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
193
|
+
you may not use this file except in compliance with the License.
|
|
194
|
+
You may obtain a copy of the License at
|
|
195
|
+
|
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
197
|
+
|
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
201
|
+
See the License for the specific language governing permissions and
|
|
202
|
+
limitations under the License.
|