Agenterra Development Rules

This skill provides GitHub Copilot with comprehensive instructions for working on the Agenterra project. It enforces mandatory workflows including PR-based development, test-driven development, documentation standards, and multi-agent coordination.

Overview

This skill is designed to be used as a `.github/copilot-instructions.md` file in the Agenterra repository. It acts as a gateway that redirects the AI agent to read and follow a centralized set of rules defined in `AGENT_INSTRUCTIONS.md`.

Instructions

When working on the Agenterra project with GitHub Copilot:

1. **Read the Core Rules First**

- Before making any code changes, read and understand ALL instructions in the common Agent rules document: `docs/AGENT_INSTRUCTIONS.md` (or `../docs/AGENT_INSTRUCTIONS.md` relative to `.github/`)

- This document contains the authoritative development practices for the project

2. **Verification Checklist**

Before proceeding with any changes, confirm you have:

- Read and understood all rules in `AGENT_INSTRUCTIONS.md`

- Will follow the PR workflow (no direct pushes to main)

- Will follow test-driven development practices

- Will avoid analysis paralysis

3. **PR Workflow (Mandatory)**

- NEVER push directly to main branch

- Always create feature branches

- Follow the branch naming convention defined in `AGENT_INSTRUCTIONS.md`

- Submit pull requests for all changes

4. **Test-Driven Development**

- Write tests before implementing features

- Ensure all tests pass before submitting PRs

- Follow testing standards outlined in the core rules document

5. **Documentation Standards**

- Keep documentation in sync with code changes

- Follow the documentation structure defined in `AGENT_INSTRUCTIONS.md`

- Update relevant docs when changing functionality

6. **Multi-Agent Coordination**

- If multiple agents are working on the project, follow coordination practices from the core rules

- Communicate changes that might affect other agents' work

- Avoid conflicts by adhering to the established workflow

Example Usage

When GitHub Copilot is invoked in the Agenterra repository:

```

Copilot reads .github/copilot-instructions.md

Follows redirect to docs/AGENT_INSTRUCTIONS.md

Applies all rules from the core document

Proceeds with development following mandatory practices

```

Important Notes

Related Files