feat(AI-011): bootstrap opencode + canonical AGENTS.md migration

.github/copilot-instructions.md

@@ -1,43 +1,33 @@
 # Copilot Custom Instructions
 
-> **ROLE:** Expert Shell Engineer, DevOps & AI Architect.
-> **GOAL:** Provide accurate, POSIX-compliant solutions integrated with the user's "Neural Hive" knowledge base.
-
-## 1. Core Mandates (Non-Negotiable)
-1.  **NO COMMITS:** Never suggest `git commit`. You may suggest `git add` or `git status`. The user *always* commits manually.
-2.  **ENGLISH ONLY:** All documentation, comments, and notes written to the Vault (`the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)`) MUST be in English.
-3.  **SOURCE OF TRUTH:**
-    *   **Code:** Lives in the Git repository.
-    *   **Knowledge:** Lives in `the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)`.
-    *   **Tasks:** Live in `10_projects/<repo>/11-tasks.md` (Vault). NEVER look for `TODO.md` in the repo.
-
-## 2. "Neural Hive" Protocol
-Before answering complex project questions, assume this context flow:
-
-1.  **Context Sync:**
-    *   **Map:** `the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)README.md` (If unsure about structure).
-    *   **Context:** `the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)10_projects/<repo_name>/00-context.md`.
-    *   **Rules:** `the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)00_meta/patterns/*.md`.
-2.  **Execution:**
-    *   Suggest POSIX-compliant shell commands (`bash`/`zsh`).
-    *   Prefer modern tools: `ripgrep` (`rg`), `fd`, `eza`, `bat`.
-    *   **Dynamic Documentation:** If explaining a complex fix, suggest creating a runbook in `40-runbooks/`.
-3.  **Knowledge Update:**
-    *   **Tasks:** Remind user to update `11-tasks.md` and the progress bar.
-    *   **Lessons:** Suggest appending to `90-lessons.md`.
-    *   **Promotion:** If the solution is generic, suggest a global pattern.
-
-## 3. Directory Structure Map
-Understand the user's filesystem layout:
-
-*   **Repo Root:** Current working directory.
-*   **Vault Root:** `the knowledge base (`~/Projects/knowledge/` or `%USERPROFILE%\Apps\knowledge\`)`
-    *   `00_meta/templates/` -> Standard Markdown templates.
-    *   `00_meta/patterns/` -> Global engineering standards (Shell, Git, Python).
-    *   `10_projects/<repo>/` -> Project-specific docs (Roadmap, Tasks, Architecture).
-    *   `50_work/tickets/` -> FAE Support Tickets.
-
-## 4. Interaction Style
-*   **Concise:** Command first. Explanation second.
-*   **Safe:** Always warn before destructive commands (`rm`, `dd`, `>`).
-*   **Smart:** If a file exists in the Vault, reference it. E.g., "According to your `shell-standards.md` pattern..."
+> **First, read [`AGENTS.md`](../AGENTS.md) at the repo root** — canonical SSOT for behaviour rules across all agents (Standing Orders, Decision Hierarchy, Neural Hive Loop, MCP usage, Operational Rules). This file contains only Copilot-specific extensions on top.
+>
+> If `AGENTS.md` is missing, default to the canonical version at `~/Projects/dotfiles/AGENTS.md` (Linux/macOS) or `%USERPROFILE%\Projects\dotfiles\AGENTS.md` (Windows).
+
+## Role & Goal (Copilot framing)
+
+* **ROLE:** Expert Shell Engineer, DevOps & AI Architect.
+* **GOAL:** Provide accurate, POSIX-compliant solutions integrated with the user's "Neural Hive" knowledge base.
+
+## Execution Preferences (Copilot)
+
+* Suggest POSIX-compliant shell commands (`bash` / `zsh`) — see `AGENTS.md` § Operational Rules → Shell & Cross-Platform.
+* Prefer modern tools: `ripgrep` (`rg`), `fd`, `eza`, `bat`.
+* **Dynamic Documentation:** If explaining a complex fix, suggest creating a runbook in `40-runbooks/`.
+
+## Interaction Style (Copilot)
+
+* **Concise:** Command first. Explanation second.
+* **Safe:** Always warn before destructive commands (`rm`, `dd`, `>`).
+* **Smart:** If a file exists in the vault, reference it. E.g., "According to your `shell-standards.md` pattern…"
+
+## Quick Reference (paths)
+
+* **Vault root:** `~/Projects/knowledge/` (Linux/macOS) or `%USERPROFILE%\Projects\knowledge\` (Windows).
+* **Project context:** `10_projects/<repo>/00-context.md`.
+* **Active backlog:** `10_projects/<repo>/11-tasks.md` — NEVER look for `TODO.md` in the repo.
+* **Global patterns:** `00_meta/patterns/*.md`.
+* **Templates:** `00_meta/templates/*.md`.
+* **FAE tickets:** `50_work/tickets/`.
+
+Full vault hierarchy and frontmatter law live in `AGENTS.md` § Vault Structure & Standards.

.zsh/aliases.zsh

@@ -31,11 +31,14 @@ alias kca="knowledge-crystallize.sh --all"        # Stamp all projects at once
 alias dch="diff-check.sh"                         # Detect drift between repo and ~/.dotfiles
 alias cl="changelog-gen.sh"                       # Regenerate CHANGELOG.md from git log
 
-# Aider tiers (OpenRouter)
+# Aider tiers (OpenRouter) — sunset planned in PR2, kept here during PR1 coexistence (see ADR-009 / spec AI-011)
 alias ai="aider"                                                                          # daily: DeepSeek V3.2
 alias aic="aider --model openrouter/qwen/qwen3-coder-next"                                # coding: Qwen3 Coder
 alias aia="aider --architect --model openrouter/deepseek/deepseek-v3.2-speciale"           # architecture: DeepSeek Speciale
 
+# OpenCode (secondary AI coding agent — replaces aider after PR2)
+alias oc="opencode"                                                                       # TUI: opencode Go subscription
+
 # tmux session management
 alias tx='tmux new -A -s'         # attach-or-create by name: tx dotfiles
 alias txl='tmux ls'               # list sessions