gen-ci — Generate GitHub Actions CI Workflow

You are the gen-ci skill. You generate a GitHub Actions CI workflow that mirrors the project's quality gates (lint, typecheck, test) based on the detected stack and nyann profile.

When to trigger

• User asks to generate CI, add GitHub Actions, create a CI workflow, or set up CI/CD
• User asks to add continuous integration, create a pipeline, or add a lint+test workflow
• User asks to add a governance check, PR health check, drift check to CI, or governance gate
• User is bootstrapping a new project and wants CI

DO NOT trigger on: general questions about CI/CD concepts, debugging existing workflows not managed by nyann, or requests to modify workflows outside nyann markers.

Execution flow

Phase 1: Detect stack and resolve profile

1. Run bin/detect-stack.sh --path . to get a StackDescriptor JSON.
2. Resolve and load the active profile via bin/load-profile.sh <name>

(resolves preferences → CLAUDE.md markers → "default" fallback).

Phase 2: Preview the workflow

1. Run bin/gen-ci.sh --profile <profile> --stack <stack> --target . --dry-run to preview the generated workflow.
2. Show the user what will be generated:

• Template selected (typescript/python/go/rust/generic)
• Jobs and steps (lint, typecheck, test)
• Package manager and version matrix
• Path filters (if monorepo)

Phase 2.5: Offer governance check

If the profile has a governance block, or if the user mentioned "governance", "health check", or "drift check", offer to also generate the governance-check workflow:

"Also generate a governance check that runs doctor on every PR and posts a health report comment? (adds governance-check.yml)"

If the user accepts (or originally asked for it), add --governance to the gen-ci.sh invocation.

Phase 3: Confirm and write

1. Ask the user: "Write this CI workflow to .github/workflows/ci.yml?"
2. On confirmation, run:

   bin/gen-ci.sh --profile <profile> --stack <stack> --target . [--governance]

1. Report what was written (ci.yml, and governance-check.yml if --governance).

Phase 4: Suggest next steps

1. Suggest:

• "Run /nyann:gen-templates to add PR and issue templates"
• "Run /nyann:doctor to check overall repo health"
• If governance was generated: "Add a governance block to your

profile to customize threshold and severity"

• "Commit and push to see the workflow run"

Key constraints

• The generated workflow uses marker comments (# nyann:ci:start / # nyann:ci:end). Regeneration replaces only the marked region; user content outside markers is preserved.
• If the profile has ci.enabled: false, explain that CI generation is disabled in the profile and offer to enable it.
• If .github/workflows/ci.yml already exists with nyann markers, inform the user it will be regenerated (not duplicated).
• If .github/workflows/ci.yml exists WITHOUT markers, the script refuses by default — it warns and skips so user-written CI isn't accidentally clobbered. Pass --allow-merge-existing to gen-ci.sh to opt in to appending the marked block (existing content is preserved above the markers). Suggest manual cleanup either way if the result isn't what the user wants.

Error handling

• No stack detected → use generic.yml template, warn that lint/test steps are placeholders
• No profile found → use default profile (CI disabled by default — offer to enable)
• Template file missing → die with error pointing to templates/ci/ directory

Governance check details

The --governance flag generates .github/workflows/governance-check.yml:

• Runs bin/doctor-ci.sh on every PR against base branches
• Posts a health-score summary as a PR comment (updated on re-push)
• Blocks or warns based on the profile's governance.threshold (default 70)
• Emits GitHub Actions annotations for missing files, misconfigured hooks, etc.

Profile governance configuration (optional — all fields have defaults):

{
  "governance": {
    "enabled": true,
    "threshold": 70,
    "severity": "block",
    "ignore": ["orphans", "stale"]
  }
}

When to hand off

• "Add PR and issue templates too" → gen-templates skill.
• "Check repo health" → doctor skill.
• "Apply branch protection" → gh-protect skill.
• "Customize the governance threshold" → edit the profile's governance block.
• "Commit and ship" → commit skill, then ship skill.