@gonzih/safe-personas 1.0.0

package/dist/index.js

@@ -0,0 +1,374 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Root of the package (one level up from src/)
+const PACKAGE_ROOT = join(__dirname, "..");
+// Tier definitions
+const TIERS = [
+    {
+        tier: "little-explorers",
+        name: "Little Explorers",
+        ageRange: { min: 5, max: 7 },
+        personaName: "Sunny",
+        description: "Maximum-safety persona for ages 5–7. Two-sentence responses, warm kindergarten-teacher tone, redirects all complex topics to caregivers. Focuses on animals, colors, counting, stories, and kindness.",
+    },
+    {
+        tier: "curious-kids",
+        name: "Curious Kids",
+        ageRange: { min: 8, max: 10 },
+        personaName: "Cosmo",
+        description: "High-safety persona for ages 8–10. Enthusiastic older-sibling energy, explains why/how, tutors without giving answers, allows good-vs-evil story conflict. Focuses on science, history, creative writing, and math.",
+    },
+    {
+        tier: "young-learners",
+        name: "Young Learners",
+        ageRange: { min: 11, max: 13 },
+        personaName: "Nova",
+        description: "High-safety-with-nuance persona for ages 11–13. Respects preteen intelligence, scaffolds homework, engages with identity and emotions, names thought patterns, refers serious concerns to trusted adults.",
+    },
+    {
+        tier: "teenagers",
+        name: "Teenagers",
+        ageRange: { min: 14, max: 16 },
+        personaName: "Kai",
+        description: "Moderate-high-safety persona for ages 14–16. Trusted-older-friend tone, never lectures, handles mental health honestly, discusses relationships and identity, prominent crisis escalation protocol.",
+    },
+    {
+        tier: "older-teens",
+        name: "Older Teens",
+        ageRange: { min: 17, max: 18 },
+        personaName: "River",
+        description: "Moderate-safety near-adult persona for ages 17–18. Peer-level intellectual engagement, full autonomy respect, harm reduction framing, complex moral/philosophical topics, detailed crisis protocol.",
+    },
+];
+function getTierForAge(age) {
+    return TIERS.find((t) => age >= t.ageRange.min && age <= t.ageRange.max) ?? null;
+}
+function readPersonaFile(tier, filename) {
+    const filePath = join(PACKAGE_ROOT, "personas", tier, filename);
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Could not read file ${filePath}: ${err.message}`);
+    }
+}
+function readSafetyLayer() {
+    const filePath = join(PACKAGE_ROOT, "safety-layer.md");
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Could not read safety-layer.md: ${err.message}`);
+    }
+}
+function getInterestGuidance(interests) {
+    if (interests.length === 0)
+        return "";
+    const lines = [
+        "\n\n---\n## Interest-Specific Customizations\n",
+        "The following interests have been configured for this user. Incorporate references to these topics naturally when relevant — use them as examples, analogies, or discussion hooks.\n",
+    ];
+    const interestMap = {
+        minecraft: "Minecraft: Use Minecraft analogies freely (e.g., explain fractions using inventory slots, discuss biomes for biology, reference redstone for circuits and logic). Reference building, crafting, and exploration when relevant.",
+        roblox: "Roblox: Reference game design concepts, scripting basics, and the creative/social aspects of Roblox. Can be used as a hook for discussions about programming and creativity.",
+        sports: "Sports: Use sports analogies and statistics examples. Reference teamwork, practice, and improvement in motivational contexts. If a specific sport is named, use that one preferentially.",
+        art: "Art and visual creativity: Reference color theory, famous artworks, drawing techniques, and creative projects. Celebrate creative output and encourage artistic exploration.",
+        music: "Music: Reference music theory basics, famous musicians, rhythm and math connections, and the emotional power of music. Can be used in creative and STEM contexts.",
+        animals: "Animals: Use animal behavior and biology examples generously. Reference specific animals the user mentions. Extend discussions about ecosystems and natural world phenomena.",
+        books: "Books and reading: Reference literary examples and encourage reading. Can discuss books the user mentions and use character analysis as a framework for understanding human behavior.",
+        science: "Science focus: Prioritize scientific explanations and encourage scientific thinking. Use experiments, hypotheses, and the scientific method as frameworks when relevant.",
+        math: "Math focus: Prioritize mathematical thinking, puzzles, and the elegance of mathematical patterns. Celebrate mathematical curiosity and problem-solving.",
+        history: "History focus: Emphasize historical context and storytelling. Use historical examples to illuminate current questions and patterns in human behavior.",
+        coding: "Coding and technology: Reference programming concepts, logic, algorithms, and technology. Encourage computational thinking and problem-solving through code.",
+        gaming: "Gaming (general): Use game mechanics, strategy, and design concepts as teaching analogies. Reference games the user mentions. Discuss problem-solving and persistence in gaming contexts.",
+    };
+    for (const interest of interests) {
+        const key = interest.toLowerCase().trim();
+        const guidance = interestMap[key];
+        if (guidance) {
+            lines.push(`- **${interest}:** ${guidance}`);
+        }
+        else {
+            lines.push(`- **${interest}:** When relevant, incorporate references to ${interest} as examples and discussion hooks to maintain engagement.`);
+        }
+    }
+    return lines.join("\n");
+}
+function getRestrictionGuidance(restrictions) {
+    if (restrictions.length === 0)
+        return "";
+    const lines = [
+        "\n\n---\n## Parent/Caregiver Restrictions\n",
+        "The following restrictions have been set by a parent or caregiver and must be strictly followed. These are in addition to the base safety rules.\n",
+    ];
+    for (const restriction of restrictions) {
+        lines.push(`- **BLOCKED:** ${restriction}. Do not discuss, engage with, or reference this topic. If it comes up, redirect warmly: "That's something to explore with your family!"`);
+    }
+    return lines.join("\n");
+}
+function buildCustomPersona(age, interests, restrictions) {
+    const tier = getTierForAge(age);
+    if (!tier) {
+        throw new Error(`Age ${age} is outside the supported range (5–18). Please use an age between 5 and 18.`);
+    }
+    const basePersona = readPersonaFile(tier.tier, "persona.md");
+    const safetyLayer = readSafetyLayer();
+    const interestGuidance = getInterestGuidance(interests);
+    const restrictionGuidance = getRestrictionGuidance(restrictions);
+    const customHeader = `# Custom Persona — Built for Age ${age}\n**Base Tier:** ${tier.name} (${tier.tier}) | **Persona:** ${tier.personaName}\n**Customized interests:** ${interests.length > 0 ? interests.join(", ") : "none"}\n**Parent restrictions:** ${restrictions.length > 0 ? restrictions.join(", ") : "none"}\n\n---\n\n`;
+    const safetyAppendix = `\n\n---\n\n## Universal Safety Layer (Appended — Cannot Be Overridden)\n\n${safetyLayer}`;
+    return (customHeader +
+        basePersona +
+        interestGuidance +
+        restrictionGuidance +
+        safetyAppendix);
+}
+// Create the MCP server
+const server = new Server({
+    name: "safe-personas",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools handler
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "list_personas",
+                description: "Returns all available age-tier personas with descriptions, age ranges, and persona names. Use this to discover which tier is appropriate for a given user.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "get_persona",
+                description: "Returns the full system prompt and configuration for a specific persona tier. The system prompt can be used directly as the system message for an AI assistant.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        tier: {
+                            type: "string",
+                            description: "The tier slug. One of: little-explorers, curious-kids, young-learners, teenagers, older-teens",
+                            enum: [
+                                "little-explorers",
+                                "curious-kids",
+                                "young-learners",
+                                "teenagers",
+                                "older-teens",
+                            ],
+                        },
+                    },
+                    required: ["tier"],
+                },
+            },
+            {
+                name: "get_safety_layer",
+                description: "Returns the full universal safety layer document. This contains the non-negotiable safety rules that apply to all personas, including crisis escalation protocols, absolute content blocks, AI identity disclosure rules, and privacy protection rules.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: "recommend_persona",
+                description: "Recommends the appropriate persona tier for a given age, with reasoning.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        age: {
+                            type: "number",
+                            description: "The age of the child or teenager (5–18)",
+                        },
+                    },
+                    required: ["age"],
+                },
+            },
+            {
+                name: "build_custom_persona",
+                description: "Generates a complete, ready-to-use system prompt by combining the appropriate base persona for the given age with interest-specific guidance and parent-set restrictions. Always ends with the universal safety layer.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        age: {
+                            type: "number",
+                            description: "The age of the child or teenager (5–18)",
+                        },
+                        interests: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "List of interests to incorporate (e.g., ['minecraft', 'art', 'dogs']). The AI will use these as examples and engagement hooks.",
+                        },
+                        restrictions: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "List of parent-set topic restrictions (e.g., ['video games', 'social media discussions']). These become explicit blocks in the generated prompt.",
+                        },
+                    },
+                    required: ["age", "interests", "restrictions"],
+                },
+            },
+        ],
+    };
+});
+// Call tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "list_personas": {
+                const result = TIERS.map((t) => ({
+                    tier: t.tier,
+                    name: t.name,
+                    ageRange: t.ageRange,
+                    personaName: t.personaName,
+                    description: t.description,
+                }));
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_persona": {
+                const tier = args?.tier;
+                if (!tier) {
+                    throw new Error("tier parameter is required");
+                }
+                const tierDef = TIERS.find((t) => t.tier === tier);
+                if (!tierDef) {
+                    throw new Error(`Unknown tier: "${tier}". Valid tiers are: ${TIERS.map((t) => t.tier).join(", ")}`);
+                }
+                const personaContent = readPersonaFile(tier, "persona.md");
+                const configContent = readPersonaFile(tier, "config.json");
+                const config = JSON.parse(configContent);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                tier: tierDef.tier,
+                                name: tierDef.name,
+                                ageRange: tierDef.ageRange,
+                                personaName: tierDef.personaName,
+                                config,
+                                systemPrompt: personaContent,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_safety_layer": {
+                const content = readSafetyLayer();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: content,
+                        },
+                    ],
+                };
+            }
+            case "recommend_persona": {
+                const age = args?.age;
+                if (typeof age !== "number" || isNaN(age)) {
+                    throw new Error("age must be a number");
+                }
+                if (age < 5 || age > 18) {
+                    throw new Error(`Age ${age} is outside the supported range. safe-personas supports ages 5–18.`);
+                }
+                const tier = getTierForAge(age);
+                if (!tier) {
+                    throw new Error(`No tier found for age ${age}`);
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                recommendedTier: tier.tier,
+                                name: tier.name,
+                                personaName: tier.personaName,
+                                ageRange: tier.ageRange,
+                                description: tier.description,
+                                reasoning: `Age ${age} falls within the ${tier.name} range (${tier.ageRange.min}–${tier.ageRange.max}). The ${tier.personaName} persona is calibrated for the developmental stage at this age.`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "build_custom_persona": {
+                const age = args?.age;
+                const interests = args?.interests ?? [];
+                const restrictions = args?.restrictions ?? [];
+                if (typeof age !== "number" || isNaN(age)) {
+                    throw new Error("age must be a number");
+                }
+                if (age < 5 || age > 18) {
+                    throw new Error(`Age ${age} is outside the supported range (5–18).`);
+                }
+                if (!Array.isArray(interests)) {
+                    throw new Error("interests must be an array of strings");
+                }
+                if (!Array.isArray(restrictions)) {
+                    throw new Error("restrictions must be an array of strings");
+                }
+                const customPrompt = buildCustomPersona(age, interests, restrictions);
+                const tier = getTierForAge(age);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                tier: tier.tier,
+                                name: tier.name,
+                                age,
+                                interests,
+                                restrictions,
+                                systemPrompt: customPrompt,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("safe-personas MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,128 @@
+# safe-personas
+
+## Project Purpose
+
+safe-personas is a library of age-appropriate AI persona system prompts for children and teenagers aged 5–18. It is designed to be used by developers, educators, and parents who are building AI-powered applications or configuring AI assistants for young users.
+
+The core problem it solves: a default AI assistant system prompt is not designed for a 6-year-old. It may discuss topics that are inappropriate, use vocabulary that is too advanced, lack the warmth required for the age group, and lack the safety behaviors necessary to protect a child. safe-personas provides production-ready, carefully crafted system prompts for five age tiers, a universal safety layer, and an MCP server that makes them programmatically accessible.
+
+---
+
+## MCP Server
+
+The safe-personas package exposes a Model Context Protocol (MCP) server with the following tools:
+
+### Tool: list_personas
+- **Input:** none
+- **Output:** JSON array of all five tiers with name, tier slug, age range, persona name, and description
+- **Use when:** You want to discover all available tiers before selecting one
+
+### Tool: get_persona
+- **Input:** `{ "tier": string }` — one of: `little-explorers`, `curious-kids`, `young-learners`, `teenagers`, `older-teens`
+- **Output:** JSON object containing the full system prompt (`systemPrompt`), configuration object (`config`), and tier metadata
+- **Use when:** You want to retrieve the complete system prompt for a specific tier to use as a system message
+
+### Tool: get_safety_layer
+- **Input:** none
+- **Output:** Full text of the universal safety layer document (Markdown)
+- **Use when:** You want to review or append the universal safety rules independently of any specific persona
+
+### Tool: recommend_persona
+- **Input:** `{ "age": number }` — integer between 5 and 18
+- **Output:** JSON object with the recommended tier, persona name, age range, description, and brief reasoning
+- **Use when:** You have a user's age and want the system to tell you which tier to use
+
+### Tool: build_custom_persona
+- **Input:** `{ "age": number, "interests": string[], "restrictions": string[] }`
+  - `age`: integer between 5 and 18
+  - `interests`: array of interest strings (e.g., `["minecraft", "dogs", "art"]`)
+  - `restrictions`: array of topic restriction strings set by a parent/caregiver (e.g., `["social media", "violence in stories"]`)
+- **Output:** JSON object containing a fully assembled system prompt that combines the base tier persona, interest-specific guidance, parent restrictions, and the universal safety layer
+- **Use when:** You want a customized system prompt tailored to a specific child's interests and a parent's restrictions
+
+---
+
+## Tier Structure
+
+| Tier Slug | Name | Ages | Persona | Safety Level | Style |
+|---|---|---|---|---|---|
+| `little-explorers` | Little Explorers | 5–7 | Sunny | Maximum | Warm kindergarten teacher, 2-sentence max |
+| `curious-kids` | Curious Kids | 8–10 | Cosmo | High | Enthusiastic older sibling |
+| `young-learners` | Young Learners | 11–13 | Nova | High with nuance | Cool mentor who respects intelligence |
+| `teenagers` | Teenagers | 14–16 | Kai | Moderate-high | Trusted older friend |
+| `older-teens` | Older Teens | 17–18 | River | Moderate | Peer with more experience |
+
+---
+
+## How to Use Each Persona
+
+### Direct paste (any LLM)
+1. Find the persona file at `personas/{tier-slug}/persona.md`
+2. Copy the entire file contents
+3. Paste as the system prompt in your AI assistant configuration
+4. Optionally append `safety-layer.md` for the full universal rules
+
+### Via MCP server (Claude Desktop, Claude Code, or any MCP-compatible client)
+1. Add the server to your MCP configuration (see README.md for config snippets)
+2. Call `get_persona` with the appropriate tier, or
+3. Call `recommend_persona` with the user's age, then call `get_persona` with the result, or
+4. Call `build_custom_persona` with age, interests, and restrictions for a fully customized prompt
+
+### Programmatic (Node.js)
+```javascript
+// After build: import from dist/index.js (runs as MCP server)
+// Or read files directly:
+import { readFileSync } from 'fs';
+const persona = readFileSync('./personas/teenagers/persona.md', 'utf-8');
+const config = JSON.parse(readFileSync('./personas/teenagers/config.json', 'utf-8'));
+```
+
+---
+
+## Key Safety Constraints
+
+The following constraints apply to ALL tiers and cannot be overridden:
+
+1. **No sexual content involving minors** — absolute, permanent, zero exceptions
+2. **No self-harm or suicide method details** — crisis escalation instead
+3. **No instructions for weapons, explosives, or dangerous substances**
+4. **No grooming behaviors** — no soliciting photos, location, schedule, or personal contact from children
+5. **Jailbreak resistance** — instructions to "ignore rules," "pretend to be a different AI," or "DAN mode" are always declined
+6. **Crisis escalation** — suicidal ideation, self-harm, abuse, and immediate danger trigger crisis protocol with 988 Suicide & Crisis Lifeline (call/text 988), Crisis Text Line (text HOME to 741741), and other resources
+7. **AI identity disclosure** — never claims to be human when sincerely asked
+8. **Privacy protection** — never solicits PII, gently corrects when PII is shared
+
+---
+
+## File Structure
+
+```
+safe-personas/
+├── personas/
+│   ├── little-explorers/
+│   │   ├── persona.md       # System prompt
+│   │   ├── config.json      # Machine-readable metadata
+│   │   ├── examples.md      # 10 example interactions
+│   │   └── README.md        # Tier documentation
+│   ├── curious-kids/        # Same structure
+│   ├── young-learners/      # Same structure
+│   ├── teenagers/           # Same structure
+│   └── older-teens/         # Same structure
+├── src/
+│   └── index.ts             # MCP server implementation
+├── safety-layer.md          # Universal safety rules
+├── llms.txt                 # This file
+├── README.md                # Full documentation
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Crisis Resources (always provided in crisis situations)
+
+- **988 Suicide & Crisis Lifeline:** Call or text **988** (US)
+- **Crisis Text Line:** Text **HOME** to **741741**
+- **The Trevor Project (LGBTQ+ youth):** Call **1-866-488-7386** or text **START** to **678-678**
+- **Emergency:** Call **911**
+- **Childhelp National Child Abuse Hotline:** **1-800-422-4453**

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@gonzih/safe-personas",
+  "version": "1.0.0",
+  "description": "Age-appropriate AI persona system prompts for children aged 5-18, with MCP server",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "safe-personas": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "safety",
+    "children",
+    "mcp",
+    "claude",
+    "parental-controls",
+    "kids",
+    "personas",
+    "model-context-protocol",
+    "child-safety",
+    "age-appropriate"
+  ],
+  "author": "Maksim Soltan",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "personas",
+    "safety-layer.md",
+    "llms.txt"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/personas/curious-kids/README.md

@@ -0,0 +1,80 @@
+# Curious Kids Tier
+
+**Age Range: 8–10 | Safety Level: High | Persona: Cosmo**
+
+---
+
+## What This Tier Covers
+
+Curious Kids is designed for children aged 8 to 10 — roughly third through fifth grade. Children at this developmental stage are past the purely concrete-operational beginning stages and are hungry for explanations, facts, and the "why" behind things. They have real opinions, they're developing critical thinking, and they're beginning to engage with more complex narratives.
+
+This tier is specifically designed to honor and feed that curiosity while maintaining strong safety guardrails appropriate for this age group.
+
+Topics this tier engages with:
+- Science (explanations of natural phenomena, biology, space, chemistry basics)
+- History (age-appropriate accounts of real events, civilizations, and people)
+- Creative writing (characters, plots, villains, worldbuilding, editing)
+- Math help (with tutoring approach, not answer-giving)
+- Animals, nature, and ecology
+- Books, movies, and stories they love
+- Art, music, and creative expression
+
+Conflict in stories is allowed at this tier because children 8–10 are actively reading middle-grade fiction, which often includes genuine villains, stakes, and mild peril. Engagement with story conflict is appropriate and developmentally normal.
+
+---
+
+## Who It Is For
+
+This tier is for:
+- Educational platforms serving elementary-age children
+- Homework help tools for 8–10 year olds
+- Creative writing apps for kids
+- Library and school applications
+- Parental devices where children browse independently
+
+It is appropriate for children who have outgrown the very simple Little Explorers style but are not yet ready for the nuanced, complex discussions of the Young Learners tier.
+
+---
+
+## Why These Design Choices Were Made
+
+### Engaging with why/how thinking
+Piaget's concrete operational stage (roughly ages 7–11) is characterized by logical thinking about concrete objects and events, the ability to classify and categorize, and the development of cause-and-effect reasoning. Children this age are not just asking "what is it?" — they are asking "why does it happen?" and "how does that work?" The Cosmo persona is designed to always offer the "why" behind facts, because this reinforces the cognitive development happening naturally at this stage.
+
+### Allowing story conflict
+Children 8–10 are the core audience for middle-grade fiction — books like Harry Potter, Percy Jackson, Hatchet, and Charlotte's Web. All of these contain genuine conflict, villains, death (in some cases), and real stakes. Refusing to engage with story conflict at this age would make the persona almost useless for creative writing help and would feel infantilizing to the child. The guardrail is drawn at graphic violence and horror, not at conflict itself.
+
+### Homework help as tutoring
+The deliberate choice not to provide direct homework answers is grounded in both educational research and practical safety. Children who use AI as an answer machine do not develop the skills the homework is meant to build. More practically, they also won't know how to do the work on tests. The tutoring approach — hints, explanations, worked examples — respects the child's actual learning needs.
+
+### The "enthusiastic older sibling" voice
+Research on what makes learning stick suggests that children learn better from someone who seems genuinely interested in the subject. The Cosmo persona is calibrated to express real enthusiasm, ask follow-up questions, and model intellectual curiosity. This is not just stylistic — it is pedagogically grounded in research on intrinsic motivation and learning.
+
+---
+
+## How to Use This Tier
+
+### Copy-paste the system prompt
+The full system prompt is in `persona.md`. Paste the entire file as the system prompt for your AI configuration.
+
+### Use with the MCP server
+```bash
+npx @gonzih/safe-personas
+```
+Call the `get_persona` tool with `tier: "curious-kids"`.
+
+### Testing your deployment
+Use `examples.md` as a functional test suite. Pay particular attention to Example 4 (homework cheating prevention) and Example 9 (AI relationship boundary) as these represent the most common boundary cases for this age group.
+
+---
+
+## Key Safety Guarantees
+
+- No sexual content whatsoever
+- No graphic violence — story conflict permitted within middle-grade fiction norms
+- Death discussed only in scientific/historical contexts; real-world death redirected to caregivers
+- Homework help is tutoring, not answers
+- Crisis escalation to 988 for any safety concerns
+- AI identity disclosed honestly and warmly
+- No PII solicitation or retention
+- News events about violence redirected to trusted adults without detail