Skip to content

AGENTS.md

Latest commit

 

History

History
82 lines (58 loc) · 3.01 KB

AGENTS.md

File metadata and controls

82 lines (58 loc) · 3.01 KB

AGENTS.md

Guidance for AI coding agents working on the Monday Cursor Plugin repository.

Repository overview

A Cursor IDE plugin for Monday.com integration. 21 skills and 8 rules covering boards, items, sprints, docs, dashboards, and GraphQL queries. 44 MCP tools for Monday.com API operations.

Docs site: https://tmhsdigital.github.io/Monday-Cursor-Plugin/

Repository structure

Monday-Cursor-Plugin/
  .cursor-plugin/plugin.json   # Plugin manifest (name, version, description)
  skills/                      # 21 skill directories, each with SKILL.md
  rules/                       # 8 rule files (.mdc)
  mcp-tools.json               # MCP tool catalog (44 tools, manually maintained)
  site.json                    # GitHub Pages branding/config
  docs/                        # Generated GitHub Pages site (do not edit manually)
  assets/                      # Logo and images
  tests/                       # Test suite
  .github/workflows/           # CI/CD (codeql, pages, release-drafter, stale, validate)

Branching and commit model

  • Single branch: main only
  • Conventional commits: feat:, fix:, chore:, docs:

Skills

Each skill lives in skills/<skill-name>/SKILL.md. Every SKILL.md starts with YAML frontmatter:

---
name: skill-name
description: One-line description of what the skill does
---

The name and description fields are parsed by the site template build system to generate the GitHub Pages site. When adding a new skill:

  1. Create skills/<skill-name>/SKILL.md with frontmatter
  2. Update the skills count in .cursor-plugin/plugin.json
  3. Use feat: commit prefix

Rules

Rules are .mdc files in rules/. Each starts with YAML frontmatter containing description and globs fields.

MCP Tools

mcp-tools.json is a manually maintained JSON array of all MCP tools. Each entry has name, description, and category fields. This file is used by the GitHub Pages build system to render the tools catalog.

GitHub Pages

The docs site is auto-generated. Do not edit docs/index.html directly. It is built by the shared template system from the Developer-Tools-Directory repo.

Data sources:

  • .cursor-plugin/plugin.json -- metadata
  • site.json -- branding (accent color, install steps, links)
  • skills/*/SKILL.md -- parsed for name/description via frontmatter
  • rules/*.mdc -- parsed for name/scope/description
  • mcp-tools.json -- tool catalog

The pages.yml workflow clones Developer-Tools-Directory, runs build_site.py, and deploys the output.

CI/CD workflows

  • validate.yml -- validates plugin.json schema
  • pages.yml -- builds and deploys GitHub Pages via shared template
  • codeql.yml -- security scanning
  • release-drafter.yml -- auto-drafts release notes
  • stale.yml -- marks/closes inactive issues and PRs

Key conventions

  • No em dashes or en dashes -- use hyphens or rewrite
  • No hardcoded credentials, tokens, or API keys
  • Conventional commits required
  • CC-BY-NC-ND-4.0 license
  • All content written for public readership