CI Surface: GitHub Actions Workflow Evidence
Domain evidence for the repository's GitHub Actions workflows under .github/workflows/.
The packet records four things:
- Each workflow rule, with the file and line that prove it.
- The workflows that must never be weakened.
- The one trigger that looks like drift and is not.
- Two scaffold templates.
It writes nothing. Read-only means this packet writes nothing, and it does not limit what the acting agent may do.
The workflow mode the hub pairs it with reads the evidence and applies it. When the hub routes this packet alone because no workflow mode scored, the acting agent reads and applies it directly.
A workflow change looks small and has a wide effect. One path filter decides which workflows a commit starts, one missing twin entry fails the gate that guards the source tree, and one switched-off workflow can remove the only check a branch ruleset requires. This packet keeps those facts in one place so a reviewer or author does not rebuild them from the workflow files and review history.
1. WHEN THE HUB BUNDLES THIS
- The task adds, edits or reviews a file under
.github/workflows/, .github/actions/ or .github/scripts/.
- A request names a GitHub Actions workflow, a path filter, a job timeout, a concurrency group, a permissions block or a required status check.
- A request asks whether a workflow trigger is intentional or drift.
- A request asks for the shape of a new workflow or job before it is written.
- The task edits, reviews or scaffolds a workflow, so the acting mode needs the rules and the protected set rather than a guess.
Formal findings-first review stays with sk-code-review and author-side quality gates stay with sk-code-quality. This surface supplies the workflow evidence both apply.
2. REFERENCE MAP
Rule data (references/):
references/ci-workflow-standards.md: the rule index. Path parity, SHA-pinned actions, a README row per workflow, set -euo pipefail, fork and secret safety, matrix and fail-fast. Each row says whether a machine gate enforces it.
references/trigger-and-filter-rules.md: the twin rule, the rebuild-commit skip rule, push-only scope for generated-path filters and the intentional exceptions table.
references/job-shape-rules.md: timeouts, least-privilege permissions, the concurrency template, the composite setup action and the switch if: shape.
references/protected-set.md: the repository CI profile and its keys, the workflows protected by function and the rules that follow from it.
Scaffold templates (assets/):
assets/workflow-template.yml: a whole-workflow starting point.
assets/job-block-template.yml: a single job starting point.
assets/ci-profile.template.json: the profile a repository fills in so /doctor:ci reads its own switch names, branches, protected workflows and README instead of this repository's.
Workflow doctrine: the implement, debug and verify phases are the shared doctrine symlinked in as references/workflow-implement.md, references/workflow-debug.md and references/workflow-verify.md. The acting agent applies it.
3. SMART ROUTING
The hub bundles this surface when a CI-workflow signal fires; §1 WHEN THE HUB BUNDLES THIS lists every signal. The first leaf it loads is references/ci-workflow-standards.md, the rule index the other three references extend.
The parent hub RESOURCE_MAP carries the same four paths under CI_WORKFLOW, re-prefixed with sk-code-ci/, and the router-sync guard (sk-code-skilled/assets/scripts/verify-router-sync.cjs, leg 2) checks that the two lists stay equal.
Read ROUTER.md before selecting skill-local resources; open only the matched files.
4. SURFACE STANDARDS (the non-negotiables)
The rules below hold for every workflow change, whoever applies it.
✅ ALWAYS
- ALWAYS cite the workflow file and line behind a rule, and re-read that line before relying on it, because the workflow files change faster than this packet.
- ALWAYS read
references/protected-set.md before any change to a workflow, a ruleset context or a repository variable that gates one.
- ALWAYS read the intentional exceptions table in
references/trigger-and-filter-rules.md before flagging a trigger as drift.
- ALWAYS keep generated-path filters push-only, because a
pull_request: filter that ignores a path can leave a required check pending.
- ALWAYS name a rule with no machine enforcement as honour-system, so a reader knows nothing will catch a lapse.
⛔ NEVER
- NEVER write, edit or scaffold a workflow from this packet. The tool surface is
Read, Bash, Grep and Glob, and the acting mode, /doctor:ci scaffold or /doctor:ci toggle applies any change.
- NEVER switch off or weaken a protected workflow without a second named confirmation that restates its role.
- NEVER switch off
message-contract.yml while its ruleset context is required.
- NEVER treat the message-contract every-branch push trigger as drift. It is a recorded exception.
- NEVER copy a live secret, token or repository variable value into a template or a reference.
⚠️ ESCALATE IF
- A request needs a workflow file edited, because that is the acting mode's work and not this packet's.
- A cited line no longer matches the quoted text, so the rule data is stale and needs a refresh before it is trusted.
- A change would touch a protected workflow, a ruleset context or a repository variable.
- Two rules disagree about the same workflow, for example a filter that satisfies one and breaks the other.
5. INTEGRATION POINTS
- Input: requests the
sk-code hub bundles beside a workflow mode when the task is about a GitHub Actions workflow.
- Output: the rule evidence, the protected set, the exception record and the scaffold templates the paired mode applies.
sk-code-review applies the rules to a workflow diff and sk-code-quality applies them to a workflow being authored. The quality mode selects this packet's checklist through the quality.checklists declaration in ../mode-registry.json, one path-only row for .github/workflows/**.
- The hub registration lives in
../mode-registry.json, ../hub-router.json and ../ROUTER.md.
1---2name: sk-code-ci3description: "Read-only GitHub Actions workflow evidence: trigger, filter, permission, timeout, concurrency and caching rules, the protected set and the scaffold templates."4allowed-tools: [Read, Bash, Grep, Glob]5version: 1.1.17.06metadata:7 source: https://skillmd.com/skills/michelkerkmeester/sk-code-ci8 family: sk-code9 packetKind: surface10---1112# CI Surface: GitHub Actions Workflow Evidence1314**Domain evidence** for the repository's GitHub Actions workflows under `.github/workflows/`.1516The packet records four things:1718- Each workflow rule, with the file and line that prove it.19- The workflows that must never be weakened.20- The one trigger that looks like drift and is not.21- Two scaffold templates.2223It writes nothing. Read-only means this packet writes nothing, and it does not limit what the acting agent may do.2425The workflow mode the hub pairs it with reads the evidence and applies it. When the hub routes this packet alone because no workflow mode scored, the acting agent reads and applies it directly.2627A workflow change looks small and has a wide effect. One path filter decides which workflows a commit starts, one missing twin entry fails the gate that guards the source tree, and one switched-off workflow can remove the only check a branch ruleset requires. This packet keeps those facts in one place so a reviewer or author does not rebuild them from the workflow files and review history.2829## 1. WHEN THE HUB BUNDLES THIS3031- The task adds, edits or reviews a file under `.github/workflows/`, `.github/actions/` or `.github/scripts/`.32- A request names a GitHub Actions workflow, a path filter, a job timeout, a concurrency group, a permissions block or a required status check.33- A request asks whether a workflow trigger is intentional or drift.34- A request asks for the shape of a new workflow or job before it is written.35- The task edits, reviews or scaffolds a workflow, so the acting mode needs the rules and the protected set rather than a guess.3637Formal findings-first review stays with `sk-code-review` and author-side quality gates stay with `sk-code-quality`. This surface supplies the workflow evidence both apply.3839---4041## 2. REFERENCE MAP4243Rule data (`references/`):44- `references/ci-workflow-standards.md`: the rule index. Path parity, SHA-pinned actions, a README row per workflow, `set -euo pipefail`, fork and secret safety, matrix and `fail-fast`. Each row says whether a machine gate enforces it.45- `references/trigger-and-filter-rules.md`: the twin rule, the rebuild-commit skip rule, push-only scope for generated-path filters and the intentional exceptions table.46- `references/job-shape-rules.md`: timeouts, least-privilege permissions, the concurrency template, the composite setup action and the switch `if:` shape.47- `references/protected-set.md`: the repository CI profile and its keys, the workflows protected by function and the rules that follow from it.4849Scaffold templates (`assets/`):50- `assets/workflow-template.yml`: a whole-workflow starting point.51- `assets/job-block-template.yml`: a single job starting point.52- `assets/ci-profile.template.json`: the profile a repository fills in so `/doctor:ci` reads its own switch names, branches, protected workflows and README instead of this repository's.5354Workflow doctrine: the implement, debug and verify phases are the shared doctrine symlinked in as `references/workflow-implement.md`, `references/workflow-debug.md` and `references/workflow-verify.md`. The acting agent applies it.5556---5758## 3. SMART ROUTING5960The hub bundles this surface when a CI-workflow signal fires; §1 WHEN THE HUB BUNDLES THIS lists every signal. The first leaf it loads is `references/ci-workflow-standards.md`, the rule index the other three references extend.6162The parent hub `RESOURCE_MAP` carries the same four paths under `CI_WORKFLOW`, re-prefixed with `sk-code-ci/`, and the router-sync guard (`sk-code-skilled/assets/scripts/verify-router-sync.cjs`, leg 2) checks that the two lists stay equal.6364Read [`ROUTER.md`](./ROUTER.md) before selecting skill-local resources; open only the matched files.6566---6768## 4. SURFACE STANDARDS (the non-negotiables)6970The rules below hold for every workflow change, whoever applies it.7172### ✅ ALWAYS7374- **ALWAYS** cite the workflow file and line behind a rule, and re-read that line before relying on it, because the workflow files change faster than this packet.75- **ALWAYS** read `references/protected-set.md` before any change to a workflow, a ruleset context or a repository variable that gates one.76- **ALWAYS** read the intentional exceptions table in `references/trigger-and-filter-rules.md` before flagging a trigger as drift.77- **ALWAYS** keep generated-path filters push-only, because a `pull_request:` filter that ignores a path can leave a required check pending.78- **ALWAYS** name a rule with no machine enforcement as honour-system, so a reader knows nothing will catch a lapse.7980### ⛔ NEVER8182- **NEVER** write, edit or scaffold a workflow from this packet. The tool surface is `Read`, `Bash`, `Grep` and `Glob`, and the acting mode, `/doctor:ci scaffold` or `/doctor:ci toggle` applies any change.83- **NEVER** switch off or weaken a protected workflow without a second named confirmation that restates its role.84- **NEVER** switch off `message-contract.yml` while its ruleset context is required.85- **NEVER** treat the message-contract every-branch push trigger as drift. It is a recorded exception.86- **NEVER** copy a live secret, token or repository variable value into a template or a reference.8788### ⚠️ ESCALATE IF8990- A request needs a workflow file edited, because that is the acting mode's work and not this packet's.91- A cited line no longer matches the quoted text, so the rule data is stale and needs a refresh before it is trusted.92- A change would touch a protected workflow, a ruleset context or a repository variable.93- Two rules disagree about the same workflow, for example a filter that satisfies one and breaks the other.9495---9697## 5. INTEGRATION POINTS9899- Input: requests the `sk-code` hub bundles beside a workflow mode when the task is about a GitHub Actions workflow.100- Output: the rule evidence, the protected set, the exception record and the scaffold templates the paired mode applies.101- `sk-code-review` applies the rules to a workflow diff and `sk-code-quality` applies them to a workflow being authored. The quality mode selects this packet's checklist through the `quality.checklists` declaration in `../mode-registry.json`, one path-only row for `.github/workflows/**`.102- The hub registration lives in `../mode-registry.json`, `../hub-router.json` and `../ROUTER.md`.