docs: update README to v1.0.0

README.md

@@ -1,3 +1,59 @@
-# mpm-brand-voice-plugin
+# MPM Brand Voice Plugin
 
-MPM Brand Voice CoWork plugin — keeps all AI-generated content aligned with Message Point Media's voice, tone, messaging pillars, and visual identity. Skill-only plugin (no MCP server); baked-in brand settings work immediately in any working folder.
+Keeps every piece of AI-generated content aligned with Message Point Media's voice, tone, messaging pillars, and visual identity. Brand settings are baked in — works immediately in any working folder with no setup required.
+
+## Skills
+
+### Brand Voice Enforcement
+Apply MPM's brand guidelines to any content you're creating.
+
+**Trigger phrases:** "write an email", "draft a proposal", "create a pitch deck", "write a LinkedIn post", "write in our voice", "make this sound like MPM", "this doesn't sound on-brand"
+
+The skill loads the baked-in MPM brand settings and applies them to your content — voice constants, tone adjustments for your audience, correct product terminology, and messaging pillar alignment. It explains the brand choices it made and offers to refine.
+
+### Guideline Generation
+Update or enrich MPM's brand settings from new source materials.
+
+**Trigger phrases:** "update our brand settings", "analyze these materials for brand voice", "add this content to our guidelines", "generate brand guidelines from these documents"
+
+Use this when you have new conference presentations, sales transcripts, updated messaging, or new product documentation that should be reflected in the brand settings. The skill builds on the existing settings rather than replacing them.
+
+---
+
+## How Brand Settings Work
+
+The plugin ships with `settings/brand-voice.local.md` — the full MPM brand settings file. This is the baked-in default that works in any working folder.
+
+**Priority order when a skill loads settings:**
+1. `.claude/brand-voice.local.md` in the current working folder (project-specific override, if present)
+2. Plugin's `settings/brand-voice.local.md` (this file — always available)
+
+For most projects, the baked-in settings are all you need. Use a working folder override only when a specific project requires different positioning (e.g., a co-branded proposal, a specific sub-brand focus).
+
+---
+
+## Keeping Settings Current
+
+The MPM brand evolves. When it does:
+
+1. **Update the master** — Edit `.claude/brand-voice.local.md` in the Claude CoWork working folder on Google Drive. This is always the source of truth.
+2. **Repackage the plugin** — Open Cowork, select the Claude CoWork folder, and ask Claude to "repackage the MPM brand voice plugin with the updated settings."
+3. **Push to the org library** — Upload the new `.plugin` file to the organization plugin library.
+
+---
+
+## CoWork Project
+
+**CW-001 — MPM Brand Voice**
+- Drive folder: https://drive.google.com/drive/folders/1v38nIYfda_VanCHFbIU9BDk_7H4ENtbO
+- Wiki: https://docs.google.com/document/d/1dTKG6t2Fjbg16wsoY2Nd0Sd8zDZ8TT-0KgXD_o8uksY/edit
+
+---
+
+## Version History
+
+| Version | Date | Notes |
+|---------|------|-------|
+| 1.0.0 | March 2026 | Initial release. Full MPM brand settings including MPower 2025 conference content, complete logo catalog, font references, 11 messaging pillars, 6 audience personas, and product terminology. |
+
+**Author:** Message Point Media | mpmedia.tv