Blog Writing Agent Instructions

Overview

Blog posts for Groove Breathwork are written in MDX and stored in this directory (apps/website/content/blog/). They are rendered automatically — no CMS, no database, no deployment steps beyond adding the file.

File Format

Each post is a single .mdx file. Filename becomes the default slug if not set in frontmatter.

content/blog/your-post-slug.mdx

Required Frontmatter

---
title: "Post Title Here"
date: "YYYY-MM-DD"
excerpt: "One or two sentences. Appears on the blog listing page."
slug: your-post-slug
author: Groove Breathwork
---
  • title — Sentence case preferred. Clear, specific, and grounded. No clickbait.
  • date — ISO format (2026-03-15). Use the actual intended publish date.
  • excerpt — 1–2 sentences. Should finish the reader's thought, not tease it.
  • slug — Lowercase, hyphenated. Must be unique. Should match the filename.
  • author — Always Groove Breathwork unless otherwise instructed.

Content Structure

Posts use standard Markdown rendered via next-mdx-remote. Supported elements:

| Element | Markdown | Notes | |---|---|---| | Heading 2 | ## Heading | Main section breaks. Use sparingly (2–4 per post). | | Heading 3 | ### Subheading | Optional. Use for sub-sections within an h2. | | Paragraph | plain text | One blank line between paragraphs. | | Bold | **word** | Renders in brand green. Use for key terms. | | Italic | *word* | Use for emphasis, not decoration. | | Bullet list | - item | Good for techniques, options, or steps. | | Numbered list | 1. item | Use when sequence matters. | | Blockquote | > text | For quotes or highlighted insights. | | Horizontal rule | --- | Section divider. Use sparingly. | | Link | [text](url) | Internal links preferred. |

Do not use: raw HTML, JSX components, image imports, or import statements unless you have confirmed they are supported.

Voice & Tone

Groove Breathwork posts are written for people who are curious but sceptical, or new to breathwork. The voice is:

  • Warm but not woo — grounded in physiology and real experience, not mysticism
  • Direct — short sentences, plain language, no jargon without explanation
  • Inclusive — "you do not need prior experience" energy; no gatekeeping
  • Honest — make claims you can support; say "may" not "will" for outcomes

Avoid: excessive exclamation marks, vague wellness buzzwords ("transform your life"), passive voice throughout, or paragraphs longer than 4–5 lines.

Ideal Post Structure

A typical post is 300–600 words. Longer is fine if the topic warrants it.

[Opening paragraph — hook the reader with the core idea, no heading]

## Section One
[2–3 paragraphs or a list]

## Section Two
[2–3 paragraphs or a list]

## Practice / Try This / What to Do Next  ← optional closing section
[Short actionable takeaway — a breathing exercise, a question, a next step]

The closing section is encouraged. Posts that end with something the reader can do perform better and feel more complete.

Example Post (reference)

---
title: "What Is Breathwork? A Beginner's Guide"
date: "2026-02-10"
excerpt: "Most of us breathe without thinking — but intentional breathwork is one of the most powerful tools available for shifting your state."
slug: what-is-breathwork
author: Groove Breathwork
---

Breathwork is the conscious use of breathing techniques to improve mental, emotional, and physical well-being. Whether you are managing stress, releasing trauma, or simply seeking a deeper connection to your body, breathwork offers a direct pathway.

## What Does Breathwork Actually Do?

When you breathe intentionally, you activate the parasympathetic nervous system — the branch responsible for rest, digestion, and recovery. Even a single slow exhale can lower your heart rate and reduce cortisol levels.

## Common Techniques

- **Box breathing** — inhale, hold, exhale, hold, each for 4 counts
- **Coherent breathing** — 5 breaths per minute to synchronise heart and lungs
- **Conscious connected breathing** — a continuous circular breath used in sessions

## Who Is It For?

Breathwork is for anyone. You do not need prior experience, a meditation practice, or any particular belief system. All you need is willingness to show up and breathe.

Checklist Before Saving

  • [ ] Frontmatter is complete and valid YAML
  • [ ] slug matches the filename (minus .mdx)
  • [ ] date is in YYYY-MM-DD format
  • [ ] excerpt is 1–2 sentences, no markdown inside it
  • [ ] No raw HTML or JSX in the body
  • [ ] Post has a clear opening paragraph (no heading at the top)
  • [ ] Post ends with something actionable or reflective
  • [ ] Voice is warm, direct, and grounded — not clinical or hype-y