# GitHub Copilot Setup

## 🛡️ GitHub Copilot Integration Protocol (UK English & DBP)

This document defines the procedure for synchronising GitHub Copilot with the **DSOM** framework, ensuring consistency across the "inner-loop" of development.

### ⚙️ 1. Automatic Configuration (.github)

Copilot is configured to automatically ingest repository-level instructions to maintain sovereignty.

* **File Location:** `.github/copilot-instructions.md`
* **Function:** Enforces DSOM Laws, **UK English** prose, and **DBP-standard** Bahasa Melayu comments.

### 💬 2. Manual Chat References

To ensure Copilot maintains context during active chat sessions, utilise the following file references (mentions):

#### Using File Mentions (#)

When prompted, specifically attach the 'Brain' artifacts to the chat context:

> "Based on **#file:.agent/brain/task.md** and **#file:.agent/brain/walkthrough.md**, initialise the sitemap logic according to our HA-Ready standards."

#### Workspace Context (@workspace)

Use the `@workspace` command to query the entire project structure:

> "**@workspace** verify if the current directory structure adheres to the DSOM Sovereign Portability law."

### 📜 3. Reanimation Shortcuts (/reanimate)

Utilise the custom prompt file (`.github/prompts/dsom-reanimate.prompt.md`) to quickly align the AI:

1. Type `/` in the Copilot Chat interface.
2. Select `dsom-reanimate`.
3. Copilot will parse all brain artifacts and summarise the current **Mental Anchor** in UK English.

***

*Generated for the DSOM Sovereign Environment.*

## 🛡️ GitHub Copilot Integration Protocol (UK English & DBP)

Dokumen ini menjelaskan cara mengkonfigurasi GitHub Copilot supaya mematuhi kerangka kerja **DSOM** secara automatik dan manual.

### ⚙️ 1. Konfigurasi Automatik (.github)

Copilot secara automatik akan membaca fail arahan jika ia diletakkan di lokasi yang betul.

* **Lokasi Fail:** `.github/copilot-instructions.md`
* **Fungsi:** Menetapkan undang-undang DSOM, penggunaan **UK English**, dan **Bahasa Melayu Malaysia (DBP)** sebagai arahan sistem kekal.

### 💬 2. Penggunaan Manual dalam Chat

Untuk memastikan Copilot mempunyai konteks yang tepat semasa sesi chat, gunakan rujukan fail (mentions) berikut:

#### Teknik Mentions (#)

Apabila bertanya dalam Chat, sertakan fail 'Brain' sebagai rujukan:

> "Based on **#file:.agent/brain/task.md** and **#file:.agent/brain/walkthrough.md**, what is the next logical step for the sitemap implementation?"

#### Penggunaan Arahan Workspace (@workspace)

Gunakan `@workspace` untuk bertanya soalan merentas keseluruhan struktur repositori:

> "**@workspace** explain how the DSOM laws are enforced in this project using UK English."

### 📜 3. Pintasan Reanimasi (/reanimate)

Gunakan fail prom (`.github/prompts/dsom-reanimate.prompt.md`) untuk memulakan sesi dengan pantas:

1. Taip `/` dalam chat.
2. Pilih `dsom-reanimate`.
3. Copilot akan membaca semua artifak brain dan menyelaraskan status semasanya.

***

*Generated for the DSOM Sovereign Environment.*
