Skip to content

Add comprehensive GitHub Copilot instructions with validated build and test procedures - #193

Draft
brucecrevensten with Copilot wants to merge 3 commits into
mainfrom
copilot/fix-192
Draft

Add comprehensive GitHub Copilot instructions with validated build and test procedures#193
brucecrevensten with Copilot wants to merge 3 commits into
mainfrom
copilot/fix-192

Conversation

Copilot AI commented Sep 17, 2025

Copy link
Copy Markdown
Contributor

This PR creates comprehensive instructions for GitHub Copilot coding agents to work effectively in the ARDAC repository. The instructions provide validated, step-by-step guidance for building, testing, and developing all components of the codebase.

What was validated and documented:

Explorer Web Application (Primary Component):

  • Node.js/npm dependency installation (31 seconds)
  • Development server startup and functionality testing
  • Production build process (36 seconds)
  • Static site generation (37 seconds)
  • Complete browser-based validation of interactive features

Notebooks (JupyterLite):

  • Python dependency installation (41 seconds)
  • JupyterLite build process (3 seconds)
  • Local server deployment and testing

Python/Conda Environments:

  • Conda/mamba installation procedures
  • Environment creation workflows
  • SSL certificate limitation documentation for sandboxed environments

Key features of the instructions:

  • Firm directive to follow instructions first before additional search
  • Exact timing measurements for every command with appropriate timeout recommendations (120+ minutes for build commands)
  • "NEVER CANCEL" warnings to prevent premature command termination
  • Complete validation scenarios requiring end-to-end testing after any changes
  • Repository structure documentation with key directories and files
  • Known limitations and graceful degradation for blocked external APIs
  • Development workflows for all major components

The instructions include mandatory validation steps that require agents to:

  1. Start the development server
  2. Navigate through the homepage sections
  3. Test interactive data visualizations and navigation
  4. Verify responsive layout and functionality

All commands have been thoroughly tested and validated to work correctly. The application runs perfectly with full interactive functionality, as demonstrated by comprehensive browser testing of the climate data visualization features.

![ARDAC Homepage Working](https://github.com/user-attachments/assets/fdee0963-110a-473b-96dc-ad386a5ad338) *The ARDAC homepage showing full functionality with interactive data visualizations, navigation, and climate stripe stories*

Fixes #192.


💡 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 September 17, 2025 23:49
…d test procedures

Co-authored-by: brucecrevensten <525049+brucecrevensten@users.noreply.github.com>
Copilot AI changed the title [WIP] ✨ Set up Copilot instructions Add comprehensive GitHub Copilot instructions with validated build and test procedures Sep 17, 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