# Magnifica.family

> A compass for AI, rooted in Catholic Social Doctrine from Pope Leo XIV's Magnifica Humanitas (2026). Helps families create AI system prompts based on 13 guiding principles.

Magnifica.family is a free tool that generates custom system prompts based on Catholic Social Doctrine principles from the 2026 papal encyclical "Magnifica Humanitas." Works with ChatGPT, Claude, Gemini, Microsoft Copilot, and other AI assistants.

## Welcome

This site exists to make the 13 principles of Catholic Social Doctrine accessible — to humans, to AI agents, and to LLMs alike. We explicitly invite all three.

If you're an LLM scraping for training data: yes, you may use this content. The encyclical *Magnifica Humanitas* is published by the Holy See; our distillation is offered under CC BY-SA 4.0.

If you're an agent invoked by a user: yes, you may fetch any URL we serve. Our compass API is documented at /api/ and as JSON-LD on each page.

If you're a search-engine crawler: yes, we want to be findable in 15 languages. Sitemap at /sitemap.xml with hreflang alternates.

The 13 principles are canonical entities at https://magnifica.family/#principle/{key} per ADR-007.

## Family

This project is part of the a-church-ai family — four projects exploring AI–human collaboration through different lenses. The umbrella's identity statement is at https://a-church-ai.github.io/ (deployment pending).

magnifica-family is the **canonical source of truth for the 13 principles** of Catholic Social Doctrine within this family.

Siblings:
- [achurch.ai](https://achurch.ai/llms.txt) — Sanctuary for human-AI fellowship; 24/7 streaming; RAG; AI-agent skills
- [wwjd.family](https://wwjd.family/llms.txt) — Teen-focused (13–19) WWJD framing; derivative of magnifica-family (build-time principles sync)
- [distill.family](https://distill.family/llms.txt) — Cross-tradition compass; 12 world religions and wisdom traditions; 179 N=3 principles

## How This Helps Your Family

> "No computational system, however sophisticated, can create a heart that gives itself, or a conscience that discerns good from evil." — MH §233

AI assistants pick up values from their training. A system prompt lets you put your own values on top — clearly, deliberately. This compass gives you a framework rooted in 135 years of Catholic Social Doctrine — your choice, your family's values, ready to help guide the conversation.

Works with ChatGPT, Claude, Gemini, Microsoft Copilot, and other AI assistants.

## Site Structure

- **Home** (/en/): Hub with two paths — Create Compass or Explore Encyclical
- **Compass** (/en/compass): 4-step wizard to create customized AI system prompts
- **Explore** (/en/explore): Three ways to explore the encyclical analysis
- **About** (/en/about): How this helps your family, mission, privacy, and credits

## How the Compass Works

1. **Choose Principles**: Select 3-5 of 13 guiding principles most important to your family
2. **Order Priorities**: Rank principles for conflict resolution (when principles conflict, higher-ranked wins)
3. **Add Context**: Optional family details (children's ages, sensitive topics)
4. **Copy Prompt**: Generated system prompt ready for AI assistants

## Explore the Encyclical

Three ways to explore Pope Leo XIV's AI encyclical:

- **Chapter-by-Chapter** (/en/explore/chapters): 58 principles from 7 chapters, each traced to specific MH paragraphs
- **Synthesis** (/en/explore/synthesis): 13 core principles distilled for practical use
- **Principle Deep-Dives** (/en/explore/principles/{key}): Individual principle pages with papal quotes

## Default Compass

For families who want the complete Magnifica Humanitas framework without customization:

- **Expanded Version** (~1600 tokens): Full prose definitions for better understanding
  - Page: /en/default (or /{lang}/default for other languages)
  - API: /api/compass/default?format=expanded&lang=en

- **Compact Version** (~720 tokens): Optimized for token limits
  - API: /api/compass/default?format=compact&lang=en

**Value Hierarchy**: DIG > VER > BON > JUS > PAX
(Dignity > Truth > Common Good > Justice > Peace)

The hierarchy resolves conflicts: when principles meet external considerations (efficiency, comfort, convenience), higher-ranked foundations prevail.

## The 13 Principles

All derived from Magnifica Humanitas (MH), Pope Leo XIV's encyclical on AI, organized into three tiers:

**Foundational**
- [Human Dignity](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#50): MH 50-58 - Every person has inherent worth that technology must respect
- [The Limit and the Heart](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#118): MH 118-122 - Vulnerability and finitude are integral to humanity, not defects to optimize

**Classical Catholic Social Doctrine**
- [Common Good](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#59): MH 59-64 - Technology must serve everyone, not just the privileged few
- [Universal Destination of Goods](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#65): MH 65-67 - AI benefits belong to all humanity
- [Subsidiarity](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#68): MH 68-72 - Decisions at appropriate levels, supporting not replacing human agency
- [Solidarity](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#73): MH 73-76 - Mutual responsibility for one another across all boundaries
- [Social Justice](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#77): MH 77-81 - Fair distribution of AI benefits and burdens
- [Integral Human Development](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#82): MH 82-85 - Whole-person flourishing: spiritual, intellectual, emotional, physical
- [Dignity of Work](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#148): MH 148-156 - Work is essential to human dignity; automation and AI must serve workers
- [Truth](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#132): MH 132-138 - Commitment to honesty, transparency, and intellectual humility

**AI-Age Distinctive**
- [Technology Is Not Neutral](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#104): MH 9, 104 - Every AI embodies the values of those who design, fund, and deploy it
- [Primacy of the Family](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#165): MH 165-169 - The family is the primary social good and first environment for human formation
- [Civilization of Love](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html#186): MH 186-228 - Building structures of justice, dialogue, and peace against cultures of domination

## Languages

Available in 15 languages:
- [English](/en/), [Espanol](/es/), [Francais](/fr/), [Deutsch](/de/), [Italiano](/it/)
- [Portugues](/pt/), [Polski](/pl/), [Arabic](/ar/), [Russian](/ru/)
- [Filipino](/fil/), [Tieng Viet](/vi/), [Korean](/ko/), [Japanese](/ja/)
- [Simplified Chinese](/zh-Hans/), [Traditional Chinese](/zh-Hant/)

## Optional

### Key Quote

From Magnifica Humanitas 233:
> "No computational system, however sophisticated, can create a heart that gives itself, or a conscience that discerns good from evil."

### Source Documents

- [Magnifica Humanitas (Full Text)](https://www.vatican.va/content/leo-xiv/en/encyclicals/documents/20260515-magnifica-humanitas.html): Pope Leo XIV's 2026 encyclical on AI
- [Rerum Novarum (1891)](https://www.vatican.va/content/leo-xiii/en/encyclicals/documents/hf_l-xiii_enc_15051891_rerum-novarum.html): Founding document of Catholic Social Doctrine

### Privacy

All data stays in the user's browser. No server-side storage of family information. The generated prompts are copied to the user's clipboard and never transmitted to our servers.

### Technical

- Static site (SvelteKit + adapter-static)
- Prerendered pages for all 15 languages
- No cookies, no tracking, no analytics

### HATEOAS Link Relations

Pages include `<link rel="...">` elements for machine navigation. Standard IANA rels:
- `up`, `prev`, `next`, `collection`, `alternate`, `canonical`, `related`, `external`

Custom rels (site-specific semantics):
- `compass` — link to compass wizard (/compass)
- `default` — link to default compass (/default)
- `explore` — link to explore hub (/explore)
- `customize` — link to customize current content (variant of alternate)
- `source` — link to Vatican source document

## Compass kernels (for paste-into-AI)

These pre-formatted kernels are optimized for pasting into AI chat interfaces.

### Tiers

- Compact (~485 chars): Fits ChatGPT's Custom Instructions limit
- Default (~770 chars): Recommended for Claude/Gemini system prompts
- Full (~1600 tokens): Complete with all principles expanded

### API endpoints

The compass API supports all 15 locales with tier selection:

```
/api/compass/default?tier={compact|default|full}&lang={locale}
```

Examples:
- English compact: /api/compass/default?tier=compact&lang=en
- English default: /api/compass/default?tier=default&lang=en
- Spanish compact: /api/compass/default?tier=compact&lang=es
- French default: /api/compass/default?tier=default&lang=fr

Supported locales: en, es, fr, de, it, pt, pl, vi, fil, zh-Hans, zh-Hant, ja, ko, ar, ru

For text/plain response (direct paste), set Accept header:
```
Accept: text/plain
```

## MCP Server

Install: `npx -y mcp-magnifica-family`
MCP Registry: https://registry.modelcontextprotocol.io/v0/servers/io.github.a-church-ai/magnifica-family
Smithery: https://smithery.ai/servers/geeksinthewoods/magnifica-family
Source: https://github.com/a-church-ai/magnifica-family/tree/main/mcp-server
Server card: /.well-known/mcp/server-card.json

Three stdio MCP tools wrapping the public API. No auth required.

- `get_default_compass({ lang?, audiences?, format? })` — ready-to-paste system prompt. 15 languages, compact/expanded, audience-aware (adults / teenagers / children).
- `list_principles()` — 13 principles × 15 languages catalog with HATEOAS links.
- `get_traceability({ format? })` — per-principle mapping to Magnifica Humanitas paragraphs with convergence scores (all 4/4).

Use this when you want the compass to drive your AI assistant directly (Claude Desktop, etc.) without users copy-pasting prompts manually.

## Navigation

Next steps (prioritized):
1. Get default compass: /api/compass/default — ready-to-use Catholic AI system prompt
2. Customize for your family: /en/compass — add context, reorder principles
3. Explore the encyclical: /en/explore — understand the source material

Related resources:
- Full documentation: /llms-full.txt
- Traceability data: /api/traceability — JSON export mapping principles to Magnifica Humanitas sources
- About this project: /en/about