Skip to content

Reorganize .github/copilot-instructions.md into AGENTS.md and material3/AGENTS.md#144

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/simplify-transfer-copilot-instructions
Draft

Reorganize .github/copilot-instructions.md into AGENTS.md and material3/AGENTS.md#144
Copilot wants to merge 3 commits intomainfrom
copilot/simplify-transfer-copilot-instructions

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 29, 2026

Completes the reorganization of .github/copilot-instructions.md into appropriate agent context files, making all instructions universal for AI agents (not just GitHub Copilot).

Changes

  • AGENTS.md (root): Comprehensive agent context file containing all coding conventions, patterns, build/test commands, project structure, troubleshooting, API change policy, visual validation, expect/actual patterns, component organization, CSS shortcuts, fillMax*Stretch guidance, "copied and adapted" code patterns, and the adding new components checklist — available for all modules
  • material3/AGENTS.md: Material 3 component lookup guidance (searching m3.material.io) as path-specific instructions
  • Deleted .github/copilot-instructions.md: All content transferred to the above files
  • Removed: Hardcoded dependency version numbers, build timing estimates, root directory file list, repository statistics, "trust these instructions" meta-notes (maintenance burdens or non-actionable items)

Final structure

Destination Content type
AGENTS.md (root) Build commands, project structure, troubleshooting, API change policy, visual validation, code style, all coding conventions (expect/actual patterns, component organization, CSS shortcuts, fillMax*Stretch, "copied and adapted" code, platform-limited parameters, unsupported APIs, avoiding duplicates, adding new components)
material3/AGENTS.md M3 component lookup (m3.material.io)
Removed Hardcoded version numbers, build timing estimates, root file list, repo statistics, meta-notes

…structions.md

The new AGENTS.md provides a concise overview derived from the repository's
actual structure (build files, CI, source layout) rather than copying from
.github/copilot-instructions.md. It references copilot-instructions.md for
detailed coding conventions.

Agent-Logs-Url: https://github.com/huanshankeji/compose-multiplatform-html-unified/sessions/bd99c79d-e9f2-47d8-95c5-3a564137e095

Co-authored-by: ShreckYe <27768951+ShreckYe@users.noreply.github.com>
Copilot AI changed the title [WIP] Simplify and reorganize copilot instructions into AGENTS.md Generate proper AGENTS.md and analyze copilot-instructions.md for reorganization Apr 29, 2026
Copilot AI requested a review from ShreckYe April 29, 2026 09:24
@ShreckYe
Copy link
Copy Markdown
Member

@copilot My feedback:

  1. .github/copilot-instructions.md should not be kept, its content should be moved completely to other places to be universal for all AI agents;
  2. Your proposed content for common/AGENTS.md and material3/AGENTS.md should actually be available for all modules, only except for "M3 lookup".

The rest looks OK. Continue.

…erial3/AGENTS.md

- Expanded root AGENTS.md with all coding conventions, patterns, and guidelines
  (available for all modules)
- Created material3/AGENTS.md with M3 component lookup guidance only
- Removed .github/copilot-instructions.md entirely
- Removed: hardcoded version numbers, build timing estimates, root file list,
  repository statistics, "trust these" meta-notes

Agent-Logs-Url: https://github.com/huanshankeji/compose-multiplatform-html-unified/sessions/50b35dd7-69bd-427b-b5f5-abca686d9932

Co-authored-by: ShreckYe <27768951+ShreckYe@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Apr 29, 2026

@copilot My feedback:

  1. .github/copilot-instructions.md should not be kept, its content should be moved completely to other places to be universal for all AI agents;
    ...

Done in 5db3afb. Moved all content from .github/copilot-instructions.md into root AGENTS.md (universal for all modules) and created material3/AGENTS.md with only the M3 lookup guidance. The old file is deleted. Removed hardcoded versions, timing estimates, and other maintenance-burden items as previously agreed.

@sonarqubecloud
Copy link
Copy Markdown

Copilot AI changed the title Generate proper AGENTS.md and analyze copilot-instructions.md for reorganization Reorganize .github/copilot-instructions.md into AGENTS.md and material3/AGENTS.md Apr 29, 2026
Copilot AI added a commit that referenced this pull request Apr 29, 2026
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.

Simplify, transfer/reorganize .github/copilot-instructions.md into AGENTS.md and other more appropriate agent context files

2 participants