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 ``` 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?