Skip to content

Conversation

Copy link

Copilot AI commented Oct 30, 2025

The MPA-First guidelines existed only as generic markdown files, requiring manual adaptation for each AI coding assistant's specific format requirements.

Changes

Created AI Assistant-Specific Formats

Added instruction files formatted for 6 major AI coding assistants:

  • Cursor IDE (.cursor/rules/*.mdc) - YAML frontmatter with glob patterns
  • Windsurf IDE (.windsurf/*.md) - Version headers and workspace rules format
  • Gemini CLI (.gemini/GEMINI-*.md) - Project context structure
  • Claude Desktop/Projects (.claude/*-instructions.md) - Persona/role-based instructions
  • GitHub Copilot CLI (.github/agents/*-agent.md) - Agent metadata with tool definitions
  • GPT-4/Codex (gpt4-codex/*-system-prompt.md) - Structured system prompts with step-by-step guidelines

Each assistant has both strict (vanilla JS only) and relaxed (jQuery allowed) versions.

Updated README

Added:

  • Complete repository structure diagram
  • Setup instructions for each AI assistant
  • Quick start guide with copy-paste commands

Example Structure

.cursor/rules/mpa-strict-rules.mdc:
---
description: MPA-First Development Mandate - Strict rules
globs:
  - "**/*.php"
  - "**/*.html"
  - "**/*.js"
alwaysApply: true
---

# AI Coding Agent Guidelines: The MPA-First Mandate
...
.github/agents/mpa-strict-agent.md:
---
name: mpa-strict-agent
description: Expert in building MPAs with vanilla JS only
tools: ["*"]
---

You are an expert web developer specializing in MPA architecture...

Format specifications verified against current documentation for each tool via web research.

Original prompt

Create sub folders with specific instruction sets recreating the mpa-rules.md AND relaxed-mpa-rules.md Copilot chat instructions for the major other AI coding assistants in their own formatting. e.g. for Gemini CLI, GPT-Codex, Claude Applications, Copilot CLI as a Coding agent file, Cursor, Windsurf
double check them using context7 MCP to make sure you have up to date information and code.

re-write the README.md to reflect changes and show a file/folder structure diagram so people know where to find their chosen version.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits October 30, 2025 13:21
Co-authored-by: RealistSec <6409357+RealistSec@users.noreply.github.com>
… all AI assistants

Co-authored-by: RealistSec <6409357+RealistSec@users.noreply.github.com>
Copilot AI changed the title [WIP] Add subfolders for AI coding assistant instructions Add AI assistant-specific instruction formats for MPA-First guidelines Oct 30, 2025
Copilot AI requested a review from RealistSec October 30, 2025 13:25
Copilot finished work on behalf of RealistSec October 30, 2025 13:25
Copy link
Author

Copilot AI commented Nov 24, 2025

@RealistSec Unfortunately I hit an unexpected error while processing your comment. I've automatically reported this to GitHub.

You can ask me to try again later by mentioning me in a new comment.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: c03746e5-629a-4576-9a96-0d003afba504

Sorry for the inconvenience!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants