@n8n-as-code/skills 2.2.5 → 2.2.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent-skills/n8n-architect/SKILL.md +11 -39
- package/dist/assets/n8n-credentials-ontology.json +1 -1
- package/dist/assets/n8n-docs-complete.json +165 -165
- package/dist/assets/n8n-knowledge-index.json +167 -167
- package/dist/assets/n8n-nodes-index.json +13 -13
- package/dist/assets/n8n-nodes-technical.json +14 -14
- package/dist/assets/workflows-index.json +1 -1
- package/dist/services/ai-context-generator.d.ts.map +1 -1
- package/dist/services/ai-context-generator.js +4 -5
- package/dist/services/ai-context-generator.js.map +1 -1
- package/package.json +2 -2
|
@@ -5,7 +5,7 @@ description: Use when the user explicitly wants to create, edit, validate, sync,
|
|
|
5
5
|
|
|
6
6
|
# n8n Architect
|
|
7
7
|
|
|
8
|
-
Use this skill for all n8n-as-code work: workspace readiness,
|
|
8
|
+
Use this skill for all n8n-as-code work: workspace readiness, environments, managed local instances, tunnels, workflow authoring, validation, sync, push, and pull.
|
|
9
9
|
|
|
10
10
|
Use `{{N8NAC_CMD}}` as the primary interface. Use `{{N8N_MANAGER_CMD}}` only for local managed runtime lifecycle, tunnels, and workflow presentation commands that are explicitly exposed by n8n-manager.
|
|
11
11
|
|
|
@@ -30,41 +30,15 @@ Use `{{N8NAC_CMD}}` as the primary interface. Use `{{N8N_MANAGER_CMD}}` only for
|
|
|
30
30
|
|
|
31
31
|
## Workspace Readiness
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
Resolve the effective environment through the backend before workflow work:
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
{{N8NAC_CMD}} workspace migrate --json
|
|
37
36
|
{{N8NAC_CMD}} env status --json
|
|
38
37
|
```
|
|
39
38
|
|
|
40
|
-
- Treat `
|
|
41
|
-
- Treat `env status --json` as the source of effective workspace readiness only after migration is not required or has been applied.
|
|
39
|
+
- Treat `env status --json` as the source of effective workspace readiness.
|
|
42
40
|
- Do not infer readiness from raw files, generated agent docs, or directory names.
|
|
43
|
-
- If
|
|
44
|
-
|
|
45
|
-
## Migration
|
|
46
|
-
|
|
47
|
-
Migration is one user-facing command. Do not reason about internal migration phases directly; summarize the report `operations` array when explaining what will change.
|
|
48
|
-
|
|
49
|
-
1. Run the dry-run first:
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
{{N8NAC_CMD}} workspace migrate --json
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
2. If the dry-run reports `status: "dry-run"`, `required: true`, or otherwise indicates pending changes, stop and ask once before applying it. Do not run `workspace migrate --write` unless the user already directly requested applying migration.
|
|
56
|
-
3. After confirmation, apply migration and re-check readiness:
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
{{N8NAC_CMD}} workspace migrate --write
|
|
60
|
-
{{N8NAC_CMD}} workspace migrate --json
|
|
61
|
-
{{N8NAC_CMD}} env status --json
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
- Do not run `workspace migrate --write` without explicit confirmation unless the user already directly requested applying migration.
|
|
65
|
-
- When reporting a dry-run, summarize the unified `operations` list and ask for exactly one confirmation for `{{N8NAC_CMD}} workspace migrate --write`.
|
|
66
|
-
- Do not ask separately for different operation types. `{{N8NAC_CMD}} workspace migrate --write` applies the required migration as one operation.
|
|
67
|
-
- Do not run environment, workflow, or setup commands while `workspace migrate --json` still reports migration required.
|
|
41
|
+
- If `env status --json` fails because the workspace is not configured, use `env add`, `env auth set`, and `env use` to create or select a V4 workspace environment.
|
|
68
42
|
- Managed local instances remain machine-global runtime resources.
|
|
69
43
|
- Workspace environments remain workspace-scoped and are managed through `{{N8NAC_CMD}} env ...`.
|
|
70
44
|
|
|
@@ -72,14 +46,12 @@ Migration is one user-facing command. Do not reason about internal migration pha
|
|
|
72
46
|
|
|
73
47
|
1. `cd` to the context root.
|
|
74
48
|
2. Run `{{N8NAC_CMD}} update-ai`, then read `AGENTS.md`.
|
|
75
|
-
3. Run `{{N8NAC_CMD}}
|
|
76
|
-
4. If
|
|
77
|
-
5.
|
|
78
|
-
6. If the
|
|
79
|
-
7.
|
|
80
|
-
8.
|
|
81
|
-
9. Ask for host/API key only for an explicitly remote n8n environment.
|
|
82
|
-
10. Configure the environment with:
|
|
49
|
+
3. Run `{{N8NAC_CMD}} env status --json`.
|
|
50
|
+
4. If the context root is not ready, inspect managed local instances with `{{N8N_MANAGER_CMD}} instance list`.
|
|
51
|
+
5. Reuse an existing environment or managed local instance when suitable.
|
|
52
|
+
6. If no suitable environment exists, stop and ask the user whether they want to connect a remote n8n URL or create/reuse a managed local n8n instance. Do not create infrastructure by default. If the user chooses a managed local instance, ask separately whether they want a public tunnel.
|
|
53
|
+
7. Ask for host/API key only for an explicitly remote n8n environment.
|
|
54
|
+
8. Configure the environment with:
|
|
83
55
|
|
|
84
56
|
```bash
|
|
85
57
|
{{N8NAC_CMD}} env add <name> --base-url <url> --workflows-path workflows/<name>
|
|
@@ -94,7 +66,7 @@ For a managed local instance:
|
|
|
94
66
|
{{N8NAC_CMD}} env use Local
|
|
95
67
|
```
|
|
96
68
|
|
|
97
|
-
|
|
69
|
+
9. Run `{{N8NAC_CMD}} update-ai` after changing environments when the facade does not do it automatically.
|
|
98
70
|
|
|
99
71
|
## Environments
|
|
100
72
|
|