Agent Configuration

To get the most out of MANAGANI with AI coding agents (GitHub Copilot, Cursor, Windsurf, Claude Code, etc.), add an AGENTS.md file to the root of your site. This tells agents how to use MANAGANI as their shared knowledge store.

Why?

Without instructions, AI agents don't know MANAGANI exists. An AGENTS.md file tells them to:

• Search before acting — Check MANAGANI for existing context before starting work
• Inspect site context — Check saved URLs and current product data before acting
• Manage product work — Create or update feedback, roadmap, changelog, and widget chat items

Recommended AGENTS.md

Copy the following into an AGENTS.md file at the root of your site:

# Site Instructions

## Knowledge Management
This site uses MANAGANI as its knowledge store via MCP.

### Before Starting Any Task
1. Make one specific retrieval call before work:
   - URL/source tasks: `search_urls` with `per_page: 3`
   - Product tasks: `list_feedback`, `get_roadmap`, or `list_changelog`
2. Read only the top 1-2 exact items, then broaden the query or raise `per_page` only if results are weak
3. Use the returned context to inform your approach

### After Completing Significant Work
1. Use `create_feedback`, `update_feedback`, `create_changelog_draft`, or `reply_widget_conversation` when the work should update MANAGANI.
2. Use descriptive titles and statuses so product teams can triage quickly.

### Saving URLs
Use `save_url` to bookmark and extract content from web pages.

### Searching
- `search_urls` — Search only saved URLs
- `list_feedback` — Search or filter product feedback
- `get_roadmap` — Read roadmap state
- `list_changelog` — Read changelog drafts and releases

Customizing

Adapt the template to your workflow. Common additions:

• Site-specific sections — Define which site maps to each app or website
• Team conventions — Note when work should create feedback vs changelog drafts
• Search-first rules — Require agents to search URLs and feedback before creating duplicates

Where to Place It

AI Client	File location
GitHub Copilot	AGENTS.md in repo root (or any directory)
Cursor	AGENTS.md and/or .cursor/rules/*.mdc (versioned site rules) and/or User Rules in Cursor Settings (global, all repos)
Windsurf	.windsurfrules file
Claude Code	CLAUDE.md in repo root

The markdown template above is the same across clients; only where you paste it changes.

Cursor-specific

See Cursor (IDE) for:

• Paste-ready global User Rules (every repository on your machine)
• How alwaysApply site rules complement AGENTS.md
• MCP server safety in Cursor (server name managani on https://mcp.managani.com/mcp, never localhost)