Skip to content

Add comprehensive GitHub Copilot instructions for foresta-js repository#6

Merged
joelmartinez merged 2 commits intomasterfrom
copilot/fix-5
Aug 8, 2025
Merged

Add comprehensive GitHub Copilot instructions for foresta-js repository#6
joelmartinez merged 2 commits intomasterfrom
copilot/fix-5

Conversation

Copy link
Contributor

Copilot AI commented Aug 8, 2025

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot coding agents with detailed instructions for working effectively in the foresta-js codebase.

The instructions cover all essential development workflows:

Bootstrap & Build Process:

  • Exact commands for dependency installation (npm ci ~2-3 seconds, npm install ~45 seconds)
  • Build process using Rollup (npm run build <1 second)
  • All timing expectations with "NEVER CANCEL" warnings included

Testing & Validation:

  • Jest test suite execution (npm test <1 second, 17 tests)
  • Coverage reporting (npm run test:coverage <2 seconds, 92%+ coverage)
  • Manual validation scenarios with expected outputs from node examples/basic.js

Development Workflow:

  • Watch mode for continuous testing (npm run test:watch)
  • Linting with ESLint using proper environment flags
  • CI validation steps matching the GitHub Actions workflow

Key Information:

  • Complete file structure and important locations
  • All 5 selector types supported by the library (#identifier, ExpressionType, *, property modifiers, path queries)
  • Dependencies (esprima for runtime, jest/rollup/eslint for development)
  • Expected build outputs and warnings

Validation:
Every command in the instructions has been thoroughly tested by following them exactly from a clean repository state. The instructions are designed to be copy-pastable and work reliably every time, eliminating guesswork for coding agents working with this JavaScript AST selector engine library.

Fixes #5.


💡 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.

Co-authored-by: joelmartinez <90380+joelmartinez@users.noreply.github.com>
Copilot AI changed the title [WIP] ✨Set+up+Copilot+instructions Add comprehensive GitHub Copilot instructions for foresta-js repository Aug 8, 2025
Copilot AI requested a review from joelmartinez August 8, 2025 11:48
@joelmartinez joelmartinez marked this pull request as ready for review August 8, 2025 11:50
@joelmartinez joelmartinez merged commit 2ba790e into master Aug 8, 2025
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.

✨Set+up+Copilot+instructions

2 participants