ci(copilot): add copilot-setup-steps workflow (#1697)

- Add .github/workflows/copilot-setup-steps.yml: prepares Copilot cloud
  agent environment before it starts working on any task
- Triggers on workflow_dispatch, push and pull_request (scoped to file)
- Steps: checkout (v6), stable Rust toolchain, rust-cache, cargo build,
  install linter, install cargo-machete, install git hooks, linter all
- Update docs/issues/1697-ai-agent-configuration.md: mark Task 5 complete

Author: josecelano

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,49 @@
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy
+# validation, and allow manual testing through the repository's "Actions" tab.
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be called `copilot-setup-steps` or it will not be picked up
+  # by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    # Set the permissions to the lowest permissions possible needed for your
+    # steps. Copilot will be given its own token for its operations.
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Enable Rust cache
+        uses: Swatinem/rust-cache@v2
+
+      - name: Build workspace
+        run: cargo build --workspace
+
+      - name: Install linter
+        run: cargo install --locked --git https://github.com/torrust/torrust-linting --bin linter
+
+      - name: Install cargo-machete
+        run: cargo install cargo-machete
+
+      - name: Install Git pre-commit hooks
+        run: ./scripts/install-git-hooks.sh
+
+      - name: Smoke-check — run all linters
+        run: linter all

docs/issues/1697-ai-agent-configuration.md

@@ -264,19 +264,20 @@ https://raw.githubusercontent.com/torrust/torrust-tracker-deployer/refs/heads/ma
 
 Minimum steps to include:
 
-- [ ] Trigger on `workflow_dispatch`, `push` and `pull_request` (scoped to the workflow file path)
-- [ ] `copilot-setup-steps` job on `ubuntu-latest`, `timeout-minutes: 30`, `permissions: contents: read`
-- [ ] `actions/checkout@v5` — check out the repository (verify this is still the latest stable
+- [x] Trigger on `workflow_dispatch`, `push` and `pull_request` (scoped to the workflow file path)
+- [x] `copilot-setup-steps` job on `ubuntu-latest`, `timeout-minutes: 30`, `permissions: contents: read`
+- [x] `actions/checkout@v6` — check out the repository (verify this is still the latest stable
       version on the GitHub Marketplace before merging)
-- [ ] `dtolnay/rust-toolchain@stable` — install the stable Rust toolchain (pin MSRV if needed)
-- [ ] `Swatinem/rust-cache@v2` — cache `target/` and `~/.cargo` between runs
-- [ ] `cargo build` warm-up — build the workspace (or key packages) so incremental compilation is
+- [x] `dtolnay/rust-toolchain@stable` — install the stable Rust toolchain (pin MSRV if needed)
+- [x] `Swatinem/rust-cache@v2` — cache `target/` and `~/.cargo` between runs
+- [x] `cargo build` warm-up — build the workspace (or key packages) so incremental compilation is
       ready when Copilot starts editing
-- [ ] Install the `linter` binary —
+- [x] Install the `linter` binary —
       `cargo install --locked --git https://github.com/torrust/torrust-linting --bin linter`
-- [ ] Install `cargo-machete` — `cargo install cargo-machete`; ensures Copilot can run unused
+- [x] Install `cargo-machete` — `cargo install cargo-machete`; ensures Copilot can run unused
       dependency checks (`cargo machete`) as required by the essential rules
-- [ ] Smoke-check: run `linter all` to confirm the environment is healthy before Copilot begins
+- [x] Smoke-check: run `linter all` to confirm the environment is healthy before Copilot begins
+- [x] Install Git pre-commit hooks — `./scripts/install-git-hooks.sh`
 
 Commit message: `ci(copilot): add copilot-setup-steps workflow`