CLAUDE.md

1@../AGENTS.md
2 
3## .github Quick Reference
4 
5This folder contains n8n's GitHub Actions infrastructure.
6 
7### Key Files
8 
9| File/Folder | Purpose |
10|-------------|---------|
11| `WORKFLOWS.md` | Complete CI/CD documentation |
12| `DEVELOPING_V3.md` | How to develop v3 features (master + 3.x branch model, opt-in flags) |
13| `workflows/` | GitHub Actions workflows |
14| `actions/` | Reusable composite actions |
15| `scripts/` | Release & Docker automation |
16| `CODEOWNERS` | Team review ownership |
17 
18### Workflow Naming
19 
20| Prefix | Purpose |
21|--------|---------|
22| `test-` | Testing (unit, E2E, visual) |
23| `ci-` | Continuous integration |
24| `util-` | Utilities (notifications) |
25| `build-` | Build processes |
26| `release-` | Release automation |
27| `sec-` | Security scanning |
28 
29Reusable workflows: add `-reusable` or `-callable` suffix.
30 
31### Common Tasks
32 
33**Add workflow:** Create in `workflows/`, document in `WORKFLOWS.md`.
34Always declare a least-privilege top-level `permissions:` block (usually
35`contents: read`) — without one the workflow runs with the repo's broad
36default token and review flags it. Jobs needing more override at job level;
37a job calling a reusable workflow must grant at least what that workflow
38declares.
39 
40**Add script:** Create `.mjs` in `scripts/`, document in `WORKFLOWS.md`
41 
42### Reference
43 
44See `WORKFLOWS.md` for:
45- Architecture diagrams
46- Workflow call graph
47- Scheduled jobs & triggers
48- Runners & secrets
49