Draft: Add shared OpenCode configuration for GitLab project

Gregory Havengarequested to merge
ghavenga-add-shared-opencode-config into master

Status: Superseded

Note: This MR has been superseded by a more iterative approach:

  • Minimal MR: !222867 (merged) - Contains just the foundation (opencode.json + skeleton AGENTS.md)
  • Epic: &20880 - Tracks the overall initiative and key decisions

This MR remains open for reference as it contains valuable discussion context about content strategy, file organization, and other decisions that will be addressed incrementally.

See Chad's suggestion that prompted this change in approach.

Original Description

This MR adds shared OpenCode configuration to the GitLab project to help developers use AI coding assistants effectively when contributing.

Changes

  • opencode.json - OpenCode configuration file
  • AGENTS.md - AI agent guidelines for working on GitLab
  • .ai/ - Directory structure for AI-related configuration
  • Documentation updates in doc/development/contributing/

Why this approach was reconsidered

This MR accumulated 28+ discussion threads with debates about:

  • Content strategy (SSOT vs duplication of docs)
  • File organization (root level vs .ai/ directory)
  • Branch naming conventions
  • Security considerations
  • Domain-specific guidelines

Rather than resolving all debates in one large MR, we're embracing iteration by starting with a minimal foundation and addressing enhancements incrementally.

Edited by Gregory Havenga

Merge request reports