mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-08 11:46:35 +00:00
Environment TestandClaude Sonnet 4.6
83262816a3
- Move emojis after headline text (CONTRIBUTING.md, actions/, design/, tools/, tests/) - Replace em dashes with colons, semicolons, or complete sentences throughout - Add missing emojis to all headlines in exceptions.md, principles.md, services.md, shell.md, setup.md, pull-request.md, commit.md, act.md, docker.md, pr/README.md - Update H1 titles to reflect renamed directories (actions/, design/) - Fix broken relative links in workflow.md after directory moves - Fix full-path link texts in services.md (style.css.md, javascript.js.md) - Fix broken principles.md link to lint.md after testing/ → actions/testing/ move Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# CI Failures and Debugging 🐛
|
|
|
|
If CI fails, follow a clean debugging workflow:
|
|
|
|
1. Export the raw failing logs.
|
|
2. Save them locally as `job-logs.txt`.
|
|
3. Decide whether the failure belongs to your branch or to something unrelated.
|
|
4. Fix related failures in the same branch.
|
|
5. Open an issue for unrelated failures instead of mixing them into your branch.
|
|
|
|
## Important 🚨
|
|
|
|
- You MUST NOT debug from screenshots alone. Use raw logs.
|
|
- You MUST NOT commit log files to the repository.
|
|
- If a [Playwright](https://playwright.dev/) job fails, you MUST also download the Playwright assets, store them in `/tmp/`, and analyze them together with the logs.
|
|
|
|
## Manual CI Jobs 🎯
|
|
|
|
You SHOULD use targeted manual CI jobs instead of rerunning the full pipeline if you only need one focused check.
|
|
|
|
Prefer the manual workflow in [entry-manual.yml](../../../../.github/workflows/entry-manual.yml):
|
|
|
|
- Select your branch.
|
|
- Use `debian` unless you have a clear reason to use a different distro.
|
|
- Limit the run to the affected app when possible.
|
|
|
|
This gives faster feedback and protects shared CI runners.
|
|
|
|
More information [here](https://hub.infinito.nexus/t/infinito-nexus-ci-cd-debugging-guide/462).
|