Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.harmonica.chat/llms.txt

Use this file to discover all available pages before exploring further.

​
What is HARMONICA.md?

HARMONICA.md is a short markdown document that describes your organization, team, or community to Harmonica. Once set, it is injected into the facilitation prompt of every new session you create — so the AI facilitator arrives already knowing your vocabulary, your decision-making norms, and the context that would otherwise take a paragraph of copy-paste each time. Think of it as a standing brief for the AI: “Here is who we are and how we work.”
HARMONICA.md is available on Pro, LTD, and Enterprise plans. Free accounts can still run sessions; they just start without this layer.

​
Where it lives

Go to Settings → Context. The editor on that tab is your HARMONICA.md. Changes you save there take effect on the next session you create — existing sessions are not retroactively affected.

​
How it gets seeded

When you complete the onboarding flow after signing up, Harmonica asks you two questions: your role type and your primary use cases. From those answers it generates a starter HARMONICA.md for you — a skeleton with the right headings filled in based on what you described. You are not locked into this draft; edit it freely. If you skipped onboarding or want to re-run it, the Settings → Context tab also has an onboarding re-entry form that updates the seed.

​
What to put in it

A good HARMONICA.md typically has three to five short sections:
  • Who you are — a sentence or two about the team, company, or community
  • What you do — the mission or focus area
  • How you work — decision-making style, communication norms, meeting culture
  • Standing context — things every session should know (ongoing initiatives, terminology, recent decisions)
Keep it under a page. The facilitator reads the whole file on every turn, so a concise document is more effective than a comprehensive one.

​
How it flows into sessions

When you create a new session, Harmonica assembles the facilitation prompt from several layers. HARMONICA.md is the outermost layer — it wraps the session-specific goal and approach so the facilitator’s voice stays consistent with your organizational context. The full prompt stack at creation time (outermost to innermost):
  1. HARMONICA.md — organizational context (this file)
  2. Platform Guidelines — base facilitation rules
  3. Facilitation Approach — methodology-specific instructions for this session
  4. Summary Generation — how to synthesize participant responses
You can inspect and edit all four layers from the Session Design tab inside any session. See Session Design for details.

​
Edit your HARMONICA.md

1

Open Settings

Click your account icon in the top right and select Settings.
2

Go to the Context tab

Select the Context tab. Your current HARMONICA.md appears in the editor.
3

Edit and save

Update the content. Click Save when done. The file has a 10,000-character limit — it is intentionally a concise reference document, not a knowledge base.
You can use standard markdown in HARMONICA.md — headings, bullet lists, and bold text all render correctly when the facilitator processes them.

Managing projects

Organize sessions into projects

Session Design

Inspect and edit all four prompt layers for a session

Creating sessions

How HARMONICA.md flows into new sessions

Templates

Start from a pre-built methodology