fix: lint issues

Author: mlataza

.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  golangci-lint:
+    name: golangci-lint
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24.0"
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v4
+        with:
+          version: v2

.golangci.yml

@@ -0,0 +1,16 @@
+version: "2"
+linters:
+  enable:
+    - errcheck
+    - govet
+    - ineffassign
+    - staticcheck
+    - unused
+formatters:
+  enable:
+    - gci
+    - gofmt
+    - gofumpt
+    - goimports
+    - golines
+    - swaggo

.vscode/settings.json

@@ -0,0 +1,9 @@
+{
+  "go.lintTool": "golangci-lint-v2",
+  "go.lintFlags": ["--path-mode=abs", "--fast-only"],
+  "go.formatTool": "custom",
+  "go.alternateTools": {
+    "customFormatter": "golangci-lint-v2"
+  },
+  "go.formatFlags": ["fmt", "--stdin"]
+}

README.md

@@ -1,6 +1,7 @@
 # Agent Smith
 [![Test](https://github.com/RewstApp/agent-smith-go/actions/workflows/test.yml/badge.svg)](https://github.com/RewstApp/agent-smith-go/actions/workflows/test.yml)
 [![Coverage](https://github.com/RewstApp/agent-smith-go/actions/workflows/coverage.yml/badge.svg)](https://github.com/RewstApp/agent-smith-go/actions/workflows/coverage.yml)
+[![Lint](https://github.com/RewstApp/agent-smith-go/actions/workflows/lint.yml/badge.svg)](https://github.com/RewstApp/agent-smith-go/actions/workflows/lint.yml)
 [![CodeQL](https://github.com/RewstApp/agent-smith-go/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/RewstApp/agent-smith-go/actions/workflows/github-code-scanning/codeql)
 [![Release](https://github.com/RewstApp/agent-smith-go/actions/workflows/release.yml/badge.svg)](https://github.com/RewstApp/agent-smith-go/actions/workflows/release.yml)
 
@@ -201,8 +202,35 @@ Tests run automatically on:
 **Pull requests must:**
 - ✅ Pass all tests
 - ✅ Maintain ≥80% coverage
+- ✅ Pass all linters
 - ✅ Pass CodeQL security scanning
 
+## Code Quality and Linting
+
+Agent Smith uses [golangci-lint](https://golangci-lint.run/) for strict security and code formatting enforcement.
+
+### Running Locally
+
+#### **Install golangci-lint:**
+
+See this [guide](https://golangci-lint.run/docs/welcome/install/local/) to learn how to install golangci-lint on your local machine.
+
+#### **Run linter:**
+```bash
+golangci-lint run
+```
+
+#### **Auto-fix formatting:**
+```bash
+golangci-lint run --fix
+```
+
+### CI/CD
+
+Linting runs automatically on:
+- Every pull request
+- Every push to main branch
+
 ## Contributing
 Contributions are always welcome. Please submit a PR!
 
@@ -214,4 +242,4 @@ cz commit
 
 ## License
 
-Agent Smith is licensed under `GNU GENERAL PUBLIC LICENSE`. See license file for details.
+Agent Smith is licensed under `GNU GENERAL PUBLIC LICENSE`. See license file for details.