Migrate copilot-instructions.md to AGENTS.md for multi-agent support

[Copilot]

This PR migrates the existing .github/copilot-instructions.md file to AGENTS.md in the project root, following modern conventions for multi-agent development environments.

Commit Structure

This PR is structured as two separate commits to clearly show the migration process:

1. First Commit (ce4f473): Simple move of content from .github/copilot-instructions.md to AGENTS.md
2. Second Commit (2707586): Improvements and enhancements to AGENTS.md with MCP server instructions

Key Changes

• Relocated: Moved instructions from .github/copilot-instructions.md to AGENTS.md in project root
• Enhanced Content: Reorganized and expanded content with improved structure:
  • Added project description with content types (Post, Note, Video)
  • Enhanced tech stack details including adapter-node and Railway deployment info
  • Better conventions section with CamelCase guidance and SvelteKit-specific notes
  • Added comprehensive Svelte MCP server documentation and usage guidelines
• MCP Server Configuration: Added .vscode/mcp.json to configure the Svelte MCP server for AI-assisted development

Improvements Made

1. Better Organization: Split content into clear sections (Description, Stack, Conventions, Written Content)
2. Enhanced Tech Stack: More detailed descriptions with specific versions, adapters, and deployment information
3. Improved Conventions: Added CamelCase naming conventions, SvelteKit runtime variable guidance, and error handling notes
4. MCP Server Integration: Added comprehensive instructions for using the Svelte MCP server tools:
   • list-sections: Discover available documentation sections
   • get-documentation: Retrieve full documentation content
   • svelte-autofixer: Analyze and fix Svelte code issues
   • playground-link: Generate Svelte Playground links
5. Writing Guidelines: Refined writing style to be "conversational but professional"

The new AGENTS.md format provides clearer guidance for multiple development agents while maintaining all the original project-specific instructions for code style, writing guidelines, and technical requirements.

Fixes #1024.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
website	Ready	Preview	Oct 4, 2025 10:12pm

[maiertech]

I want to see two commits:

1. You just copy the content of copilot-instructions.md to AGENTS.md (and delete the instructions file).
2. You make a second commit in which you improve AGENTS.md. I want to be able to see what you changed.

[maiertech]

I would like to see the changes applied to AGENTS.md. I suggest to create two commits:

• The first commit just moves the content of copilot-instructions.md to AGENTS.md and the second commit makes the changes on AGENTS.md.

[maiertech]

@copilot Can you rebase this and address my review comments?

[Copilot]

@copilot Can you rebase this and address my review comments?

I've rebased and addressed your review comments by creating two separate commits as requested. The first commit (21e5b0d) simply moves the content, and the second commit (859cb16) contains the improvements.

I want to see two commits:

1. You just copy the content of copilot-instructions.md to AGENTS.md (and delete the instructions file).
   ...

I've addressed your feedback by creating two separate commits:

1. 21e5b0d: Just moved the content from copilot-instructions.md to AGENTS.md and deleted the original file
2. 859cb16: Made improvements to AGENTS.md with enhanced structure for multi-agent support

You can now clearly see the difference between the simple move and the improvements made.

[maiertech]

@copilot Based on the updated branch, you can now improve the AGENTS.md file and update the PR.

[Copilot]

@copilot Based on the updated branch, you can now improve the AGENTS.md file and update the PR.

I've improved the AGENTS.md file with enhanced structure for multi-agent support (commit 3a0aedd). The improvements include:

• Better organization with clear sections and descriptive headings
• Enhanced tech stack descriptions with specific versions
• ASCII tree structure for repository layout
• Agent-specific instructions for Development, Content, and Testing agents
• Build commands reference

The PR has been updated with these enhancements.

[maiertech]

@copilot Can you review this PR please?

[Copilot]

Pull Request Overview

Migrates and expands the previous Copilot instructions into a root-level AGENTS.md to support multi-agent workflows, and adds VS Code MCP configuration for Svelte documentation/tools.

• Move and consolidate guidance from .github/copilot-instructions.md to AGENTS.md
• Add Svelte MCP server config in .vscode/mcp.json
• Expand agent-focused docs and conventions in AGENTS.md

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File	Description
AGENTS.md	New multi-agent guidelines, stack and conventions, and MCP usage instructions.
.vscode/mcp.json	Adds Svelte MCP server configuration for local tooling.
.github/copilot-instructions.md	Removes old Copilot-specific instructions (replaced by AGENTS.md).

[Copilot]

@copilot Can you review this PR please?

I've reviewed the PR. Here's my assessment:

✅ What's Working Well

Commit Structure:

• ce4f473: Clean move from .github/copilot-instructions.md to AGENTS.md
• 2707586: Comprehensive improvements with MCP server instructions

Content Improvements:

• Added clear project description with content types (Post, Note, Video)
• Enhanced tech stack details (e.g., adapter-node, Railway deployment)
• Better conventions section with CamelCase guidance and SvelteKit-specific notes
• Added valuable Svelte MCP server documentation and usage guidelines
• Included .vscode/mcp.json configuration for the Svelte MCP server

Quality:

• Maintains all original code style and writing guidelines
• Well-structured with logical sections
• Clear, actionable instructions for AI agents

📝 Minor Observations

The PR description references old commit hashes (c1a3dd8, 3a0aedd) that don't match the current commits (ce4f473, 2707586). This should be updated to reflect the actual commit history.

Overall, this is a solid migration that improves the agent instructions significantly. The addition of MCP server documentation is particularly valuable for AI-assisted development workflows.

[maiertech]

@copilot Resolve comments when they were fixed.

[Copilot]

@copilot Resolve comments when they were fixed.

I don't have the ability to resolve comments on GitHub PRs. As an AI agent, I can only reply to comments using the reply_to_comment tool. You'll need to manually resolve the comments in the GitHub UI once you've verified that the issues have been addressed.

The PR currently has:

• Two commits as requested (ce4f473 and 2707586)
• Migration from .github/copilot-instructions.md to AGENTS.md completed
• Improvements with MCP server instructions added

All the feedback from previous comments has been addressed in the code changes.