chore: complete mdformat → prettier swap (mcp build, docs)

The mcp server's semantic-release build_command was still installing
mdformat at release time, and several agent/contributor docs still
told users to use mdformat. Update both to match the new toolchain.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dougborg

.github/agents/documentation-writer.agent.md

@@ -102,7 +102,7 @@ scope. But prefer this ordering when sections are present.
 
 ### Markdown Formatting
 
-**Always use mdformat for consistency:**
+**Always use Prettier for consistency:**
 
 ```bash
 uv run poe format  # Formats all markdown files
@@ -485,7 +485,7 @@ Before considering documentation complete:
 
 - [ ] All code examples tested and working
 - [ ] Links verified (internal and external)
-- [ ] Formatting consistent with mdformat
+- [ ] Formatting consistent with Prettier
 - [ ] Spelling and grammar checked
 - [ ] Screenshots updated (if UI changes)
 - [ ] Version numbers current
@@ -506,7 +506,7 @@ Documentation should improve every time it's touched:
 ## Critical Reminders
 
 1. **Test all examples** - Don't document code that doesn't work
-1. **Format with mdformat** - Consistency is critical
+1. **Format with Prettier** - Consistency is critical
 1. **Update indexes** - Keep navigation current
 1. **Link validation** - Broken links frustrate users
 1. **Build verification** - Always build docs locally first

.github/agents/guides/COPILOT_ARCHITECTURE.md

@@ -306,7 +306,7 @@ If agent needs more detail:
 When agent creates markdown file:
 
 - `markdown.instructions.md` auto-loads (for `**/*.md`)
-  - mdformat standards (88-char line length)
+  - Prettier standards (88-char line length)
   - ATX-style headers
   - Code block language specification
 
@@ -318,7 +318,7 @@ Agent follows `create-adr.prompt.md`:
 1. Copy template from `docs/adr/0000-template.md`
 1. Fill out ADR structure
 1. Update `docs/adr/README.md` index
-1. Format with mdformat
+1. Format with Prettier
 1. Validate links
 
 #### Step 4: Result

.github/agents/guides/REFACTORING_SUMMARY.md

@@ -196,7 +196,7 @@ Created 4 shared guides eliminating duplication across all agents:
    - Standards: AAA pattern, fixtures, mocking, coverage goals
 1. **markdown.instructions.md** (224 lines)
    - Auto-applies to: `**/*.md`
-   - Standards: mdformat, line length, headers, code blocks
+   - Standards: Prettier, line length, headers, code blocks
 
 **Created 5 reusable prompt files:**
 

.github/copilot-instructions.md

@@ -187,7 +187,7 @@ gh pr create
 ### Code Quality
 
 ```bash
-uv run poe format          # Format code (ruff + mdformat)
+uv run poe format          # Format code (ruff + prettier)
 uv run poe format-check    # Check formatting without changes
 uv run poe lint            # Run all linting (ruff + mypy + yamllint)
 uv run poe fix             # Auto-fix formatting and linting issues

.github/instructions/markdown.instructions.md

@@ -6,14 +6,14 @@
 
 ## Formatting Tool
 
-- **Always use mdformat** for consistency
+- **Always use Prettier** for consistency
 - Run `uv run poe format` to format all markdown files
 - Run `uv run poe format-check` to verify formatting
 
 ## Line Length
 
 - **88 characters maximum** (matches ruff for code)
-- mdformat handles wrapping automatically
+- Prettier handles wrapping automatically (`proseWrap: always`)
 
 ## Headers
 
@@ -54,8 +54,8 @@
 3. Step 3
 ```
 
-- Use `1.` numbering (mdformat handles sequential)
-- Don't manually number (mdformat fixes)
+- Use `1.` numbering (Prettier handles sequential)
+- Don't manually number (Prettier fixes)
 
 ### Task Lists
 
@@ -118,7 +118,7 @@ key: value
 | Value 4  | Value 5  | Value 6  |
 ```
 
-- Use mdformat to align columns automatically
+- Use Prettier to align columns automatically
 - Include header separator row
 
 ## Images
@@ -220,7 +220,7 @@ Date: YYYY-MM-DD
 
 ## Critical Reminders
 
-1. **Always format with mdformat** - Run before committing
+1. **Always format with Prettier** - Run before committing
 1. **Test code examples** - Ensure they actually work
 1. **Verify links** - Broken links frustrate users
 1. **Specify code block language** - Required for syntax highlighting

.github/prompts/create-adr.prompt.md

@@ -125,4 +125,4 @@ Date: YYYY-MM-DD
 - [ ] Consequences are realistic
 - [ ] Alternatives are documented
 - [ ] Index is updated
-- [ ] Files are formatted with mdformat
+- [ ] Files are formatted with Prettier

docs/CONTRIBUTING.md

@@ -72,7 +72,7 @@ uv run poe test-integration
 - We use [Ruff](https://docs.astral.sh/ruff/) for code formatting and linting
 - [ty](https://astral.sh/blog/ty) for type checking (Astral's fast Rust-based type
   checker)
-- [mdformat](https://mdformat.readthedocs.io/) for Markdown formatting
+- [Prettier](https://prettier.io/) for Markdown formatting
 
 All formatting is automated via `uv run poe format`.
 

docs/adr/0014-github-copilot-custom-agents.md

@@ -23,7 +23,7 @@ organizing these agents and their supporting materials.
 - YAML frontmatter must follow specific format with `name`, `description`, `tools`
   properties
 - Progressive disclosure is critical - agents should load minimal context initially
-- Markdown formatters (mdformat) can break YAML frontmatter if not configured properly
+- Markdown formatters (Prettier) can break YAML frontmatter if not configured properly
 
 **Project-Specific:**
 
@@ -124,7 +124,7 @@ Agents use the `read` tool to load these guides only when needed.
 ### Configuration Details
 
 - **File extension**: `.agent.md` (distinguishes from regular markdown)
-- **mdformat exclusion**: Agent files excluded from mdformat to preserve YAML
+- **Prettier exclusion**: Agent files listed in `.prettierignore` to preserve YAML
   frontmatter
 - **CODEOWNERS**: `.github/CODEOWNERS` assigns ownership of Copilot configuration
 - **Validation**: Pre-commit hooks validate YAML syntax with yamllint
@@ -144,7 +144,7 @@ Agents use the `read` tool to load these guides only when needed.
 1. **Maintainability**: Clear separation of concerns makes updates easier
 1. **Discoverability**: Developers can invoke agents by role (@python-developer,
    @tdd-specialist, etc.)
-1. **Context preservation**: mdformat exclusion prevents YAML frontmatter corruption
+1. **Context preservation**: Prettier exclusion prevents YAML frontmatter corruption
 
 ### Negative Consequences
 

statuspro_mcp_server/pyproject.toml

@@ -83,7 +83,7 @@ upload_to_repository = false
 remove_dist = false
 commit_author = "github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
 commit_message = "chore(release): mcp v{version}"
-build_command = "pip install mdformat mdformat-gfm mdformat-tables mdformat-toc && mdformat CHANGELOG.md --wrap 88"
+build_command = "pnpm exec prettier --write CHANGELOG.md"
 major_on_zero = false
 allow_zero_version = true
 tag_format = "mcp-v{version}"