From 1cdabfa90360d9281f3c66bf97e4ac05cdb946f1 Mon Sep 17 00:00:00 2001 From: "Jorge O. Castro" Date: Sun, 5 Apr 2026 13:56:51 -0400 Subject: [PATCH 1/2] =?UTF-8?q?chore(agents):=20add=20session=20lessons=20?= =?UTF-8?q?=E2=80=94=20branch=20hygiene,=20skill=20routing,=20audit=20ques?= =?UTF-8?q?tions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - One branch per logical fix (never bundle unrelated changes) - Load github-actions-expert before touching any .github/workflows/ file - Call ask_user before planning on any audit task - Create .github/copilot-instructions.md pointer to AGENTS.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .github/copilot-instructions.md | 5 +++++ AGENTS.md | 27 ++++++++++++++++++++++++++- 2 files changed, 31 insertions(+), 1 deletion(-) create mode 100644 .github/copilot-instructions.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 00000000..ae2d7c74 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,5 @@ +# Bluefin Documentation — Copilot Instructions + +Source of truth: [`AGENTS.md`](../AGENTS.md) + +Read `AGENTS.md` before starting any task in this repository. diff --git a/AGENTS.md b/AGENTS.md index 07e11156..dab8e883 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -32,7 +32,9 @@ Dev server: ## Git Workflow -**Never push directly to main.** Always work on a topic branch: +**Never push directly to main.** Always work on a topic branch. + +**One branch per logical fix.** Never bundle unrelated changes onto the same branch, even if the second change is small. Each fix gets its own branch and PR — create a separate branch, cherry-pick if needed. ```bash git checkout -b / @@ -75,6 +77,29 @@ CI enforces TypeScript and ESLint as hard failures. Prettier is warnings-only. --- +## Required Skills + +| Task type | Load before starting | +|---|---| +| Any change to `.github/workflows/*.yml` | `github-actions-expert` skill | +| Multi-file planning or design decisions | `blueprint-mode` skill | + +Failure to load the required skill before touching workflow files is a hard rule violation. + +--- + +## Audit Tasks + +When asked to audit or investigate anything in this repo, **call `ask_user` before writing any plan.** Minimum questions to ask: + +1. Are the open issues still current, or stale? +2. Forward-only fix, or retroactive correction of past data? +3. What does "done" look like — what is in scope and out of scope? + +Do not proceed to planning until answers are collected. + +--- + ## Repository Structure ``` From 2653ec127bc635f869425d001002fdaf3c74d7a8 Mon Sep 17 00:00:00 2001 From: "Jorge O. Castro" Date: Sun, 19 Apr 2026 18:33:18 -0400 Subject: [PATCH 2/2] blog: add video embed to Dakota Alpha 1 post Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- blog/2026-04-19-dakota-alpha-1.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/blog/2026-04-19-dakota-alpha-1.md b/blog/2026-04-19-dakota-alpha-1.md index eabfdc23..07700e1f 100644 --- a/blog/2026-04-19-dakota-alpha-1.md +++ b/blog/2026-04-19-dakota-alpha-1.md @@ -5,6 +5,8 @@ authors: castrojo tags: [announcements] --- + + Today we celebrate a nice milestone for the project. Thanks to some awesome work by the team we have a mostly daily-driveable Alpha 1. GNOME 50 too! ## What is this?