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.
Files changed (167) hide show
  1. package/package.json +1 -1
  2. package/skills-registry.yaml +12 -2
  3. package/src/skills-lib/ai-product-design/SKILL.md +85 -0
  4. package/src/skills-lib/ai-product-design/references/LICENSE +21 -0
  5. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/bias-detection-design/SKILL.md +37 -0
  6. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/consent-and-agency/SKILL.md +37 -0
  7. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/escalation-design/SKILL.md +40 -0
  8. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/guardrail-design/SKILL.md +36 -0
  9. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/harm-anticipation/SKILL.md +108 -0
  10. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/transparency-patterns/SKILL.md +36 -0
  11. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/trust-calibration/SKILL.md +102 -0
  12. package/src/skills-lib/ai-product-design/references/ai-alignment-reasoning/value-specification/SKILL.md +39 -0
  13. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/agent-role-design/SKILL.md +37 -0
  14. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/failure-recovery/SKILL.md +37 -0
  15. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/handoff-protocols/SKILL.md +45 -0
  16. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/human-in-the-loop/SKILL.md +39 -0
  17. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/observability-design/SKILL.md +48 -0
  18. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/state-management/SKILL.md +95 -0
  19. package/src/skills-lib/ai-product-design/references/design-agent-orchestration/task-decomposition/SKILL.md +36 -0
  20. package/src/skills-lib/ai-product-design/references/evaluation/comparative-evaluation/SKILL.md +39 -0
  21. package/src/skills-lib/ai-product-design/references/evaluation/failure-taxonomy/SKILL.md +47 -0
  22. package/src/skills-lib/ai-product-design/references/evaluation/heuristic-evaluation-ai/SKILL.md +46 -0
  23. package/src/skills-lib/ai-product-design/references/evaluation/longitudinal-measurement/SKILL.md +38 -0
  24. package/src/skills-lib/ai-product-design/references/evaluation/output-quality-rubrics/SKILL.md +41 -0
  25. package/src/skills-lib/ai-product-design/references/evaluation/task-success-metrics/SKILL.md +35 -0
  26. package/src/skills-lib/ai-product-design/references/evaluation/user-satisfaction-signals/SKILL.md +50 -0
  27. package/src/skills-lib/ai-product-design/references/model-interaction-design/context-window-design/SKILL.md +28 -0
  28. package/src/skills-lib/ai-product-design/references/model-interaction-design/conversation-patterns/SKILL.md +37 -0
  29. package/src/skills-lib/ai-product-design/references/model-interaction-design/feedback-loops/SKILL.md +35 -0
  30. package/src/skills-lib/ai-product-design/references/model-interaction-design/frustration-detection/SKILL.md +91 -0
  31. package/src/skills-lib/ai-product-design/references/model-interaction-design/generative-ui/SKILL.md +34 -0
  32. package/src/skills-lib/ai-product-design/references/model-interaction-design/mixed-initiative-flow/SKILL.md +39 -0
  33. package/src/skills-lib/ai-product-design/references/model-interaction-design/multimodal-orchestration/SKILL.md +94 -0
  34. package/src/skills-lib/ai-product-design/references/model-interaction-design/progressive-disclosure/SKILL.md +33 -0
  35. package/src/skills-lib/ai-product-design/references/prompt-architecture/chain-of-thought-design/SKILL.md +45 -0
  36. package/src/skills-lib/ai-product-design/references/prompt-architecture/constraint-specification/SKILL.md +50 -0
  37. package/src/skills-lib/ai-product-design/references/prompt-architecture/context-engineering/SKILL.md +45 -0
  38. package/src/skills-lib/ai-product-design/references/prompt-architecture/few-shot-patterns/SKILL.md +47 -0
  39. package/src/skills-lib/ai-product-design/references/prompt-architecture/prompt-versioning/SKILL.md +42 -0
  40. package/src/skills-lib/ai-product-design/references/prompt-architecture/system-prompt-structure/SKILL.md +50 -0
  41. package/src/skills-lib/ai-product-design/references/prompt-architecture/template-design/SKILL.md +42 -0
  42. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/behavioral-consistency/SKILL.md +36 -0
  43. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/cultural-adaptation/SKILL.md +38 -0
  44. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/domain-voice/SKILL.md +51 -0
  45. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/emotional-design/SKILL.md +51 -0
  46. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/error-personality/SKILL.md +45 -0
  47. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/persona-architecture/SKILL.md +38 -0
  48. package/src/skills-lib/ai-product-design/references/system-behavior-shaping/tone-calibration/SKILL.md +39 -0
  49. package/src/skills-lib/algorithmic-art/LICENSE.txt +202 -0
  50. package/src/skills-lib/algorithmic-art/SKILL.md +405 -0
  51. package/src/skills-lib/algorithmic-art/templates/generator_template.js +223 -0
  52. package/src/skills-lib/algorithmic-art/templates/viewer.html +599 -0
  53. package/src/skills-lib/animate/README.md +41 -0
  54. package/src/skills-lib/animate/SKILL.md +179 -0
  55. package/src/skills-lib/animate/examples/animate-height.tsx +75 -0
  56. package/src/skills-lib/animate/examples/app-store-card.tsx +164 -0
  57. package/src/skills-lib/animate/examples/card-hover.tsx +79 -0
  58. package/src/skills-lib/animate/examples/feedback-popover.tsx +119 -0
  59. package/src/skills-lib/animate/examples/multi-step-flow.tsx +128 -0
  60. package/src/skills-lib/animate/examples/shared-layout.tsx +64 -0
  61. package/src/skills-lib/animate/examples/text-reveal.tsx +70 -0
  62. package/src/skills-lib/animate/examples/toast-stacking.tsx +95 -0
  63. package/src/skills-lib/animate/references/css-animations.md +232 -0
  64. package/src/skills-lib/animate/references/easing-and-timing.md +105 -0
  65. package/src/skills-lib/animate/references/framer-motion.md +356 -0
  66. package/src/skills-lib/animate/references/performance-accessibility.md +185 -0
  67. package/src/skills-lib/auth-and-secrets/SKILL.md +10 -0
  68. package/src/skills-lib/canvas-design/LICENSE.txt +202 -0
  69. package/src/skills-lib/canvas-design/SKILL.md +130 -0
  70. package/src/skills-lib/canvas-design/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  71. package/src/skills-lib/canvas-design/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  72. package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  73. package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-OFL.txt +93 -0
  74. package/src/skills-lib/canvas-design/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  75. package/src/skills-lib/canvas-design/canvas-fonts/Boldonse-OFL.txt +93 -0
  76. package/src/skills-lib/canvas-design/canvas-fonts/Boldonse-Regular.ttf +0 -0
  77. package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  78. package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  79. package/src/skills-lib/canvas-design/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  80. package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  81. package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  82. package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  83. package/src/skills-lib/canvas-design/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  84. package/src/skills-lib/canvas-design/canvas-fonts/DMMono-OFL.txt +93 -0
  85. package/src/skills-lib/canvas-design/canvas-fonts/DMMono-Regular.ttf +0 -0
  86. package/src/skills-lib/canvas-design/canvas-fonts/EricaOne-OFL.txt +94 -0
  87. package/src/skills-lib/canvas-design/canvas-fonts/EricaOne-Regular.ttf +0 -0
  88. package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-Bold.ttf +0 -0
  89. package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-OFL.txt +93 -0
  90. package/src/skills-lib/canvas-design/canvas-fonts/GeistMono-Regular.ttf +0 -0
  91. package/src/skills-lib/canvas-design/canvas-fonts/Gloock-OFL.txt +93 -0
  92. package/src/skills-lib/canvas-design/canvas-fonts/Gloock-Regular.ttf +0 -0
  93. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  94. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  95. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  96. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  97. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  98. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  99. package/src/skills-lib/canvas-design/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  100. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  101. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  102. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  103. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  104. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  105. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  106. package/src/skills-lib/canvas-design/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  107. package/src/skills-lib/canvas-design/canvas-fonts/Italiana-OFL.txt +93 -0
  108. package/src/skills-lib/canvas-design/canvas-fonts/Italiana-Regular.ttf +0 -0
  109. package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  110. package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  111. package/src/skills-lib/canvas-design/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  112. package/src/skills-lib/canvas-design/canvas-fonts/Jura-Light.ttf +0 -0
  113. package/src/skills-lib/canvas-design/canvas-fonts/Jura-Medium.ttf +0 -0
  114. package/src/skills-lib/canvas-design/canvas-fonts/Jura-OFL.txt +93 -0
  115. package/src/skills-lib/canvas-design/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  116. package/src/skills-lib/canvas-design/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  117. package/src/skills-lib/canvas-design/canvas-fonts/Lora-Bold.ttf +0 -0
  118. package/src/skills-lib/canvas-design/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  119. package/src/skills-lib/canvas-design/canvas-fonts/Lora-Italic.ttf +0 -0
  120. package/src/skills-lib/canvas-design/canvas-fonts/Lora-OFL.txt +93 -0
  121. package/src/skills-lib/canvas-design/canvas-fonts/Lora-Regular.ttf +0 -0
  122. package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-Bold.ttf +0 -0
  123. package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-OFL.txt +93 -0
  124. package/src/skills-lib/canvas-design/canvas-fonts/NationalPark-Regular.ttf +0 -0
  125. package/src/skills-lib/canvas-design/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  126. package/src/skills-lib/canvas-design/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  127. package/src/skills-lib/canvas-design/canvas-fonts/Outfit-Bold.ttf +0 -0
  128. package/src/skills-lib/canvas-design/canvas-fonts/Outfit-OFL.txt +93 -0
  129. package/src/skills-lib/canvas-design/canvas-fonts/Outfit-Regular.ttf +0 -0
  130. package/src/skills-lib/canvas-design/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  131. package/src/skills-lib/canvas-design/canvas-fonts/PixelifySans-OFL.txt +93 -0
  132. package/src/skills-lib/canvas-design/canvas-fonts/PoiretOne-OFL.txt +93 -0
  133. package/src/skills-lib/canvas-design/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  134. package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  135. package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-OFL.txt +93 -0
  136. package/src/skills-lib/canvas-design/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  137. package/src/skills-lib/canvas-design/canvas-fonts/Silkscreen-OFL.txt +93 -0
  138. package/src/skills-lib/canvas-design/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  139. package/src/skills-lib/canvas-design/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  140. package/src/skills-lib/canvas-design/canvas-fonts/SmoochSans-OFL.txt +93 -0
  141. package/src/skills-lib/canvas-design/canvas-fonts/Tektur-Medium.ttf +0 -0
  142. package/src/skills-lib/canvas-design/canvas-fonts/Tektur-OFL.txt +93 -0
  143. package/src/skills-lib/canvas-design/canvas-fonts/Tektur-Regular.ttf +0 -0
  144. package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Bold.ttf +0 -0
  145. package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  146. package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Italic.ttf +0 -0
  147. package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-OFL.txt +93 -0
  148. package/src/skills-lib/canvas-design/canvas-fonts/WorkSans-Regular.ttf +0 -0
  149. package/src/skills-lib/canvas-design/canvas-fonts/YoungSerif-OFL.txt +93 -0
  150. package/src/skills-lib/canvas-design/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  151. package/src/skills-lib/design-motion-principles/SKILL.md +122 -0
  152. package/src/skills-lib/design-motion-principles/references/accessibility.md +52 -0
  153. package/src/skills-lib/design-motion-principles/references/anti-checklist.md +274 -0
  154. package/src/skills-lib/design-motion-principles/references/audit-checklist.md +137 -0
  155. package/src/skills-lib/design-motion-principles/references/creation-gotchas.md +36 -0
  156. package/src/skills-lib/design-motion-principles/references/demo-shell.html +275 -0
  157. package/src/skills-lib/design-motion-principles/references/emil-kowalski.md +121 -0
  158. package/src/skills-lib/design-motion-principles/references/jakub-krehel.md +80 -0
  159. package/src/skills-lib/design-motion-principles/references/jhey-tompkins.md +122 -0
  160. package/src/skills-lib/design-motion-principles/references/motion-cookbook.md +529 -0
  161. package/src/skills-lib/design-motion-principles/references/output-format.md +346 -0
  162. package/src/skills-lib/design-motion-principles/references/performance.md +82 -0
  163. package/src/skills-lib/design-motion-principles/references/report-template.html +1006 -0
  164. package/src/skills-lib/design-motion-principles/workflows/audit.md +203 -0
  165. package/src/skills-lib/design-motion-principles/workflows/create.md +87 -0
  166. package/src/skills-lib/web-security/SKILL.md +47 -4
  167. package/src/skills-lib/wizz-router/SKILL.md +4 -1
@@ -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
@@ -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
@@ -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.