Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 14, 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 OGP Agent Linux codebase.

What's Included

The instructions cover all essential aspects of working with this Perl-based game server management agent:

  • Prerequisites and Installation: Complete workflow for installing system dependencies via install_agent_prereqs.sh (90 seconds, tested and timed)
  • Build and Test Process: Since this is a Perl script, no compilation is needed - just syntax validation with perl -c ogp_agent.pl (5 seconds)
  • Agent Operation: How to start, stop, and validate the XML-RPC daemon that listens on port 12679
  • Critical Timing Information: Specific timeout values and "NEVER CANCEL" warnings for all time-consuming operations
  • Validation Scenarios: Manual testing procedures to ensure changes work correctly
  • Project Structure: Documentation of bundled Perl modules and key directories

Key Features

  • Imperative tone throughout: "Run this command", "Do not do this" - as requested
  • Exhaustively validated commands: Every command was tested in the development environment
  • Timing documentation: All operations are timed with appropriate timeout recommendations
  • Firm directive: Instructions start with clear guidance to follow them first before additional exploration

Validated Operations

All instructions were thoroughly tested:

  • Prerequisites installation: 90 seconds (with 180+ second timeout recommendation)
  • Installation workflow: 1 second automated mode (with proper user creation)
  • Agent startup and basic functionality verification
  • Syntax checking and module availability validation

The instructions enable any GitHub Copilot agent to quickly become productive in this codebase without trial-and-error or extensive exploration.

Fixes #10.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • esm.ubuntu.com
    • Triggering command: /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copy link
Contributor Author

Copilot AI commented Sep 14, 2025

@iaretechnician 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

@iaretechnician iaretechnician marked this pull request as ready for review September 14, 2025 20:51
@iaretechnician iaretechnician merged commit 5d981cc into stable Sep 14, 2025
1 check passed
Copilot AI changed the title [WIP] ✨ Set up Copilot instructions Add comprehensive GitHub Copilot instructions for OGP Agent Linux development Sep 14, 2025
@iaretechnician
Copy link
Contributor

@copilot I believe this has been completed and added into this repo but the option is still displayed as if its never been done?

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