@@ -102,7 +102,15 @@ Pre-built instrumentations:
102102- Do not prefix PR titles with ` [codex] ` .
103103- Match the PR title type to the primary user-facing change.
104104
105- ## Linting and Validation
105+ ## Linting
106+
107+ Run ` mise run lint:fix ` before committing changes.
108+ If output includes ` fixed ` , keep those changes.
109+ If output includes ` partial ` or ` review ` , address the remaining issues and
110+ run ` mise run lint:fix ` again.
111+
112+ Example output:
113+ flint: fixed: gofmt — commit before pushing | partial: cargo-clippy
106114
107115** CRITICAL** : These checks MUST be run before creating any
108116commits. CI will fail if these checks fail.
@@ -117,39 +125,6 @@ commits. CI will fail if these checks fail.
117125 - Build succeeds (tests are skipped;
118126 run ` mise run test ` or ` mise run test-all ` for tests)
119127
120- ### Non-Java Files (Markdown, YAML, JSON, shell scripts)
121-
122- - ** ALWAYS** run ` mise run lint ` after modifying non-Java
123- files (runs super-linter + link checking + BOM check)
124- - ` mise run lint:fix ` autofixes linting issues
125- - Super-linter will ** autofix** many issues
126- (formatting, trailing whitespace, etc.)
127- - It only reports ERROR-level issues
128- (configured via ` LOG_LEVEL=ERROR ` in
129- ` .github/super-linter.env ` )
130- - Common issues caught:
131- - Lines exceeding 100 characters in Markdown files
132- - Missing language tags in fenced code blocks
133- - Table formatting issues
134- - YAML/JSON syntax errors
135-
136- ### Running Linters
137-
138- ``` bash
139- # After modifying Java files (run BEFORE committing)
140- mise run build
141-
142- # After modifying non-Java files (run BEFORE committing)
143- mise run lint
144- # or to autofix: mise run lint:fix
145- ```
146-
147- ### Before Pushing
148-
149- ** ALWAYS** run ` mise run lint ` before pushing to verify
150- all lints pass. CI runs the same checks and will fail
151- if any lint is violated.
152-
153128## Testing
154129
155130- JUnit 5 (Jupiter) with ` @Test ` annotations
0 commit comments