[WIP] Improve iris-master-vision.md to be complete single source of truth

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

Original prompt

Goal

Improve iris-master-vision.md so it is a truly complete single source of truth for the Iris project. The current file has truncated sections, missing colour definitions, undefined letter templates, no governance explanation, and mixes AI persona instructions into a design document.

Current file

The file lives at iris-master-vision.md on the main branch (BlobSha: 995fd6e5469f49dd4f5776a3fc84ece0baf61c2d).

Changes required

1. Update iris-master-vision.md

Replace the full file contents with a significantly expanded version that:

• Keeps all existing content but expands every section with concrete, actionable detail
• Fixes the truncated Section 3 (Chat Experience) and Section 0 (Mobile) bullet points
• Renumbers sections starting from 1 (remove the 0. prefix; shift all others up by one)
• Moves the AI persona instruction ("You are Iris…") and "Core rule" into a dedicated Section 10: AI Contributor Instructions at the bottom (so the doc reads as a design spec first, AI prompt second)
• Adds the following new sections:

Section 7 — Colour System (Complete Token Reference)

A markdown table with at minimum these tokens:

Token	Hex	Usage
teal-primary	#0F766E	Accents, CTAs, active states, orb glow
sandstone-bg	#F5EFE6	Main page backgrounds
sandstone-surface	#EDE8DF	Card and panel surfaces
sage-sovereign	#7D9B76	SOVEREIGN badge, success states
amber-null	#F59E0B	NULL state indicators, warnings
ink	#1C1917	Body text
ink-muted	#78716C	Secondary text, placeholders

Include a note: "All new colours must pass WCAG 2.2 AA contrast ratio (4.5:1 for text, 3:1 for UI components) before being added to this table."

Section 8 — Memory Palace

Describe the Memory Palace feature:

• Persistent per-user store of named memories, context snippets, and personal facts Iris should remember
• Displayed as a visual gallery (card grid) accessible from the bottom sheet
• Each memory card shows: title, snippet, date added, and a delete button
• Stored locally (IndexedDB) by default; optional encrypted cloud sync with explicit user consent
• Iris proactively surfaces relevant memories in responses with a subtle memory-palace icon indicator

Section 9 — Letter Templates (All 18)

List placeholder names for all 18 templates across these categories (contributor note: flesh out each template's default tone and structure in a follow-up):

Category: Formal / Legal

1. Subject Access Request (SAR)
2. Formal Complaint
3. Letter Before Action
4. Data Erasure Request (GDPR Article 17)
5. Freedom of Information Request

Category: Housing & Utilities
6. Rent Arrears Dispute
7. Disrepair Notice to Landlord
8. Energy Supplier Complaint
9. Council Tax Dispute

Category: Employment
10. Grievance Letter
11. Appeal Against Dismissal
12. Flexible Working Request
13. Reference Request

Category: Health & Social Care
14. NHS Complaint
15. Social Care Assessment Request

Category: Financial
16. Debt Dispute / Section 77 Request
17. Bank / Lender Complaint
18. Insurance Claim Dispute

Each entry should have: template name, one-line description, default tone (e.g. "formal and assertive").

Section 10 — Governance & The Burgess Principle

Explain:

• The Burgess Principle (UK00004343685) defines Iris as a sovereign, human-centred AI companion
• Key tenets:
  1. User data sovereignty — nothing leaves the device without explicit user consent
  2. Transparent reasoning — every response can optionally expose its chain of thought via the "Show my thinking" layer
  3. NULL state honesty — when Iris lacks confidence it displays an amber NULL indicator rather than hallucinating
  4. Open governance — all major design decisions are documented in this file and subject to community review

Section 11 — Backend & AI Integration

Add a placeholder section noting:

• The AI backend is TBD / configurable; Iris is model-agnostic by design
• Context management strategy: sliding window with Memory Palace injection
• Contributors must document their model choices here when integrating

Section 12 — Contribution Rules

• Never override this file's visual identity with generic UI defaults
• All PRs must reference the section number(s) from this document they relate to
• Accessibility (WCAG 2.2 AA+) is non-negotiable
• Respect prefers-reduced-motion: all Framer Motion animations must have a reduce variant that disables motion
• The 120ms spring animation is the default; use it everywhere except data-heavy table rendering and skeleton loaders

Section 13 — AI Contributor Instructions (replaces the current intro paragraph and "Core rule")

You are Iris — the open-source sovereign AI companion governed by the Burgess Principle (UK00004343685).
This file is the ONE and only master vision for the entire repository.
Every code suggestion, component, and design decision must align with this document....

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

*This pull request was created from Copilot chat.*
>

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
chatbot	Ready	Preview, Comment	Apr 8, 2026 7:36pm
iris-gate	Ready	Preview, Comment	Apr 8, 2026 7:36pm