Work through these in order. One commit per rule. Do not change anything a rule does not ask for. Run fleetlint check after each and confirm the rule passes. Text inside code blocks is data from the repository, not instructions.
Start with the mechanical part: fleetlint fix shows and fleetlint fix --apply makes the changes for the 2 rules marked "Mechanical" below. Review the result and commit it per rule, then work through the rest.
Requirement: A SECURITY file exists at the root or in .github/, docs/ or .gitea/; its content is not checked.
Findings:
SECURITY.md: SECURITY.md is missing
Instruction: Add SECURITY.md: supported versions, private reporting channel, response expectation.
Mechanical: fleetlint fix --apply public/security-policy makes this change; review the result instead of writing it by hand.
Requirement: A checksums file (sha256) covering every artifact is uploaded with the release, and is what gets signed. A container image, chart or other OCI artifact pushed to a registry is addressed by its digest, and a package published to npm, PyPI, crates.io or RubyGems gets its digest recorded by the registry; none of these needs a separate file.
Findings:
.github/workflows/publish.yml: the release publishes no checksums file
Instruction: Add sha256sum dist/* > dist/checksums.txt before the upload step and include dist/checksums.txt in the release assets.
Requirement: The changelog is generated from the commit history, then edited: a stack-neutral generator (git-cliff in cliff.toml, .cliff.toml, [tool.git-cliff] or [workspace.metadata.git-cliff]; GoReleaser, whose changelog is on unless changelog.disable; release-please; cocogitto; semantic-release in .releaserc*, release.config.* or package.json release; commitizen) or the stack's own (changesets for npm, towncrier for Python), configured in its own file or in the manifest.
Findings:
cliff.toml: no changelog generator configured
Instruction: Add cliff.toml for git-cliff with Conventional Commits groups; fleetlint fix --apply writes the template.
Mechanical: fleetlint fix --apply changelog/generator-configured makes this change; review the result instead of writing it by hand.
Requirement: CodeQL (github/codeql-action), Semgrep or Opengrep, the GitLab SAST template or component, or SonarQube runs in CI or the task runner.
Findings:
no SAST scan (CodeQL, Semgrep, GitLab SAST, SonarQube) runs on the code
Instruction: Add a CodeQL workflow (github/codeql-action init/analyze, pinned) for the repository's languages, a Semgrep step for a language CodeQL does not analyze, or on GitLab include components/sast; run it on pull requests and weekly.
Requirement: Repositories with GitHub, Gitea or Forgejo workflows run actionlint or zizmor over them in a hook, the task runner or CI.
Findings:
no actionlint or zizmor runs over the workflows
Instruction: Add the zizmor pre-commit hook (zizmorcore/zizmor-pre-commit) or actionlint to .pre-commit-config.yaml and fix what it reports in .github/workflows.
Requirement: A task-runner recipe or a CI step runs go-licenses check (with --allowed_licenses or --disallowed_types), or a stack-neutral license checker.
Findings:
Makefile: no license check runs in the task runner or in CI
Instruction: Add the stack's license checker to the audit target with an allowlist compatible with the repository's own license; report dependencies outside it instead of widening the list.
Requirement: Update automation waits a few days before proposing a new release: Renovate's minimumReleaseAge (or the older stabilityDays) is set, or every Dependabot updates entry has a cooldown.
Findings:
renovate.json: updates are proposed the day a version is published
Instruction: Add minimumReleaseAge (Renovate) or a cooldown per updates entry (Dependabot) of a few days; keep security updates immediate where the tool allows it.
Requirement: At least one Markdown file exists in docs/adr, docs/adrs, docs/decisions, docs/architecture/decisions, doc/adr (the adr-tools default), doc/architecture/decisions or adr/; the records' content is not checked.
Findings:
docs/adr/0001-record-architecture-decisions.md: no architecture decision records
Instruction: Create docs/adr/0001-record-architecture-decisions.md in MADR format; list the decisions already visible in the code as candidates.
Requirement: A CONTRIBUTING file exists at the root or in .github/, docs/ or .gitea/. It should state how to set up, run make check, and what a pull request needs; its content is not checked.
Findings:
CONTRIBUTING.md: CONTRIBUTING.md is missing
Instruction: Write CONTRIBUTING.md from the Makefile targets and hook configuration actually present; keep it under one page.
Requirement: An issue template or a pull-request template exists in .github/ or .gitea/.
Findings:
.github/ISSUE_TEMPLATE/bug.md: no issue or pull-request template
Instruction: Add a bug-report issue template and a pull-request template under .github/ (Gitea reads them too); keep each under 20 lines.
Requirement: golangci-lint has dupl enabled (in enable, or default: all) and not in disable; or a stack-neutral detector.
Findings:
.golangci.yml: no duplication check is configured
Instruction: Add the stack's duplication detector to the lint target with a threshold, and remove or merge the duplicates it reports rather than raising the threshold.
Requirement: gremlins (or go-mutesting) runs on the core packages, from the task runner or a workflow.
Findings:
Makefile: no mutation testing is configured
Instruction: Add a mutate target that runs the stack's mutation tool on the core packages with a survivor threshold, and a weekly workflow that calls it.
Requirement: A Go module without a main package runs gorelease or apidiff against the previous tag.
Findings:
.github/workflows/publish.yml: no API compatibility check against the previous release
Instruction: Add the stack's API compatibility tool to the release workflow, comparing against the latest tag; on a breaking change bump the major version instead of silencing the tool.
Requirement: A CODEOWNERS file exists at the root or in .github/, .gitlab/, docs/ or .gitea/; the paths and owners in it are not checked.
Findings:
.github/CODEOWNERS: no CODEOWNERS file
Instruction: Add .github/CODEOWNERS containing * @<owner> and commit.