Skip to content

Add instruction files#3

Merged
shigeyf merged 2 commits into
mainfrom
dev
Feb 12, 2026
Merged

Add instruction files#3
shigeyf merged 2 commits into
mainfrom
dev

Conversation

@shigeyf
Copy link
Copy Markdown
Owner

@shigeyf shigeyf commented Feb 12, 2026

This pull request introduces a comprehensive set of coding and documentation standards for various technology stacks by adding detailed instruction files and updating the main Copilot instructions. These changes establish clear, enforceable guidelines for code style, best practices, security, and project-specific conventions, tailored to different file types and frameworks. The most important changes are grouped below by theme.

1. Instruction Framework and File Mapping

  • Added a new section to .github/copilot-instructions.md describing an automated system that applies specific instruction files based on file patterns, ensuring that the correct coding standards are enforced for each technology stack. This includes a mapping table for instruction files and their applicable file globs.

2. Technology-Specific Coding Standards

  • Markdown: Introduced markdown.instructions.md outlining strict formatting, content, and validation rules for Markdown documents, including required YAML front-matter fields, heading structure, and line length limits.
  • Node.js/JavaScript/Vitest: Added nodejs-javascript-vitest.instructions.md with ES2022+ standards, Node.js ESM usage, async/await requirements, Vitest testing rules, and documentation guidelines.
  • Python MCP Server: Created python-mcp-server.instructions.md detailing best practices for building Model Context Protocol servers, including usage of FastMCP, type hints, structured outputs, context management, and extensive code examples.
  • General Python: Added python.instructions.md specifying PEP 8/257 compliance, type annotations, code style, edge case handling, and documentation examples.
  • ReactJS: Introduced reactjs.instructions.md defining modern React (v19+) best practices, TypeScript integration, component architecture, state management, styling, testing, accessibility, and security requirements.
  • Tailwind CSS v4 + Vite: Added tailwind-v4-vite.instructions.md with installation, configuration, and usage guidelines for Tailwind v4 in Vite projects, emphasizing the new CSS-first configuration approach and removal of legacy files.

3. Security and Best Practices

  • Added security-and-owasp.instructions.md to enforce OWASP Top 10 and industry best practices across all languages and frameworks, covering access control, cryptography, injection prevention, secure configuration, authentication, and code review education.

These changes provide a robust foundation for consistent, secure, and high-quality code across the project, with clear, automated enforcement of best practices for each technology and file type.

@shigeyf shigeyf merged commit bd2239d into main Feb 12, 2026
2 checks passed
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.

1 participant