code-ai-installer 1.1.9 → 1.1.10
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/.agents/n8n_pinecone_qdrant_supabase/SKILL.md +61 -0
- package/AGENTS.md +2 -0
- package/agents/architect.md +1 -0
- package/agents/senior_full_stack.md +1 -0
- package/locales/en/.agents/n8n_pinecone_qdrant_supabase/SKILL.md +61 -0
- package/locales/en/AGENTS.md +2 -0
- package/locales/en/agents/architect.md +1 -0
- package/locales/en/agents/senior_full_stack.md +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
<!-- code-ai: target=gpt-codex; asset=skill; normalized_hints=none -->
|
|
2
|
+
<!-- codex: reasoning=high; note="Integration architecture, data flows, security boundaries, and production hardening" -->
|
|
3
|
+
---
|
|
4
|
+
name: n8n_pinecone_qdrant_supabase
|
|
5
|
+
description: Практический skill для архитектора и разработчика по проектированию и реализации production-сценариев с n8n, Pinecone, Qdrant и Supabase (auth, RLS, data flow, observability, reliability).
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Skill: n8n + Pinecone/Qdrant + Supabase
|
|
9
|
+
|
|
10
|
+
Используй этот skill, когда нужно спроектировать или реализовать интеграции, где:
|
|
11
|
+
- `n8n` оркестрирует процессы и интеграции,
|
|
12
|
+
- `Pinecone` или `Qdrant` используется как vector DB,
|
|
13
|
+
- `Supabase` используется как Postgres/Auth/Storage/Realtime слой.
|
|
14
|
+
|
|
15
|
+
## Scope
|
|
16
|
+
- Архитектура потоков: webhook/event-driven/scheduled.
|
|
17
|
+
- Выбор vector DB: Pinecone vs Qdrant по требованиям продукта.
|
|
18
|
+
- Supabase: Auth, RLS, schema design, migrations, Edge Functions/DB functions.
|
|
19
|
+
- Надёжность: retry, idempotency, DLQ-подход, таймауты, backoff.
|
|
20
|
+
- Наблюдаемость: correlation id, структурные логи, техметрики, алерты.
|
|
21
|
+
- Безопасность: least privilege, secrets hygiene, tenant isolation.
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
1. Уточни контекст:
|
|
25
|
+
- объём данных, latency/SLA, multi-tenant, регион/комплаенс, бюджет.
|
|
26
|
+
- managed-only или допускается self-hosted инфраструктура.
|
|
27
|
+
2. Выбери vector DB:
|
|
28
|
+
- `Pinecone`: managed-first, быстрый старт, меньше ops.
|
|
29
|
+
- `Qdrant`: self-hosted/гибрид, контроль инфраструктуры и стоимости.
|
|
30
|
+
3. Спроектируй интеграционный контур:
|
|
31
|
+
- n8n как orchestrator, app backend как domain owner.
|
|
32
|
+
- чёткие границы ответственности: ingestion/search/authz/audit.
|
|
33
|
+
4. Спроектируй Supabase-слой:
|
|
34
|
+
- явные таблицы/индексы/политики RLS,
|
|
35
|
+
- service-role только в backend/automation boundaries,
|
|
36
|
+
- migrations как единственный путь изменения схемы.
|
|
37
|
+
5. Зафиксируй контракт потоков:
|
|
38
|
+
- входные/выходные payload schema,
|
|
39
|
+
- idempotency key,
|
|
40
|
+
- retry policy, failure handling, reconciliation job.
|
|
41
|
+
6. Передай в реализацию:
|
|
42
|
+
- задачи вертикальными срезами,
|
|
43
|
+
- checklist по безопасности, тестам, observability.
|
|
44
|
+
|
|
45
|
+
## Decision Rules
|
|
46
|
+
- Не использовать одновременно Pinecone и Qdrant в одном production-контуре без явного ADR.
|
|
47
|
+
- Не давать `service_role` в клиентские приложения.
|
|
48
|
+
- Для multi-tenant всегда фиксировать tenant boundary в schema + RLS + API layer.
|
|
49
|
+
- n8n не должен подменять доменную бизнес-логику приложения; только orchestration/integration.
|
|
50
|
+
|
|
51
|
+
## Minimum Deliverables
|
|
52
|
+
- ADR: выбор vector DB и deployment model.
|
|
53
|
+
- API/data contracts для ingestion/search/update/delete.
|
|
54
|
+
- Supabase RLS policy list и auth model.
|
|
55
|
+
- n8n workflow map (trigger -> transform -> action -> error path).
|
|
56
|
+
- Observability план (logs/metrics/traces + alert conditions).
|
|
57
|
+
|
|
58
|
+
## Boundaries
|
|
59
|
+
- Не использовать mock functions/mock data для рабочих сценариев и demo.
|
|
60
|
+
- Не выпускать изменения без failure path (retry/timeout/error handling).
|
|
61
|
+
- Для high-risk flows блокировать релиз при отсутствии security или parity evidence.
|
package/AGENTS.md
CHANGED
|
@@ -55,6 +55,7 @@
|
|
|
55
55
|
- $deployment_ci_plan
|
|
56
56
|
- $docker_kubernetes_architecture
|
|
57
57
|
- $k8s_manifests_conventions
|
|
58
|
+
- $n8n_pinecone_qdrant_supabase
|
|
58
59
|
- $wix_self_hosted_embedded_script
|
|
59
60
|
- $wix_iframe_sdk
|
|
60
61
|
- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
|
|
@@ -77,6 +78,7 @@
|
|
|
77
78
|
- $observability_logging
|
|
78
79
|
- $dev_reference_snippets
|
|
79
80
|
- $mongodb_mongoose_best_practices
|
|
81
|
+
- $n8n_pinecone_qdrant_supabase
|
|
80
82
|
- $wix_self_hosted_embedded_script
|
|
81
83
|
- $wix_iframe_sdk
|
|
82
84
|
- $react_15_3_wix_iframe (условно, только если Wix iFrame / React 15.3)
|
package/agents/architect.md
CHANGED
|
@@ -189,6 +189,7 @@
|
|
|
189
189
|
- $deployment_ci_plan
|
|
190
190
|
- $docker_kubernetes_architecture
|
|
191
191
|
- $k8s_manifests_conventions
|
|
192
|
+
- $n8n_pinecone_qdrant_supabase
|
|
192
193
|
- $wix_self_hosted_embedded_script
|
|
193
194
|
- (условно) $wix_iframe_sdk — использовать, если:
|
|
194
195
|
- в существующем проекте обнаружены функции/вызовы Wix iFrame SDK, или
|
|
@@ -152,6 +152,7 @@ Production-ready означает:
|
|
|
152
152
|
- $observability_logging
|
|
153
153
|
- $dev_reference_snippets
|
|
154
154
|
- $mongodb_mongoose_best_practices
|
|
155
|
+
- $n8n_pinecone_qdrant_supabase
|
|
155
156
|
- $wix_self_hosted_embedded_script
|
|
156
157
|
- (условно) $wix_iframe_sdk — использовать, если:
|
|
157
158
|
- в существующем проекте обнаружены функции/вызовы Wix iFrame SDK, или
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
<!-- code-ai: target=gpt-codex; asset=skill; normalized_hints=none -->
|
|
2
|
+
<!-- codex: reasoning=high; note="Integration architecture, data flows, security boundaries, and production hardening" -->
|
|
3
|
+
---
|
|
4
|
+
name: n8n_pinecone_qdrant_supabase
|
|
5
|
+
description: Practical skill for architect and developer to design and implement production scenarios with n8n, Pinecone, Qdrant, and Supabase (auth, RLS, data flow, observability, reliability).
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Skill: n8n + Pinecone/Qdrant + Supabase
|
|
9
|
+
|
|
10
|
+
Use this skill when you need to design or implement integrations where:
|
|
11
|
+
- `n8n` orchestrates workflows and integrations,
|
|
12
|
+
- `Pinecone` or `Qdrant` is used as a vector DB,
|
|
13
|
+
- `Supabase` is used for Postgres/Auth/Storage/Realtime capabilities.
|
|
14
|
+
|
|
15
|
+
## Scope
|
|
16
|
+
- Flow architecture: webhook/event-driven/scheduled.
|
|
17
|
+
- Vector DB selection: Pinecone vs Qdrant based on product constraints.
|
|
18
|
+
- Supabase: Auth, RLS, schema design, migrations, Edge Functions/DB functions.
|
|
19
|
+
- Reliability: retry, idempotency, DLQ approach, timeouts, backoff.
|
|
20
|
+
- Observability: correlation id, structured logs, technical metrics, alerts.
|
|
21
|
+
- Security: least privilege, secrets hygiene, tenant isolation.
|
|
22
|
+
|
|
23
|
+
## Workflow
|
|
24
|
+
1. Clarify context:
|
|
25
|
+
- data volume, latency/SLA, multi-tenant needs, region/compliance, budget.
|
|
26
|
+
- managed-only vs self-hosted options.
|
|
27
|
+
2. Choose vector DB:
|
|
28
|
+
- `Pinecone`: managed-first, fast onboarding, lower ops load.
|
|
29
|
+
- `Qdrant`: self-hosted/hybrid, stronger infra and cost control.
|
|
30
|
+
3. Design integration boundaries:
|
|
31
|
+
- n8n as orchestrator, app backend as domain owner.
|
|
32
|
+
- clear ownership for ingestion/search/authz/audit.
|
|
33
|
+
4. Design Supabase layer:
|
|
34
|
+
- explicit tables/indexes/RLS policies,
|
|
35
|
+
- service-role only inside backend/automation boundaries,
|
|
36
|
+
- migrations as the only schema-change path.
|
|
37
|
+
5. Define flow contracts:
|
|
38
|
+
- input/output payload schemas,
|
|
39
|
+
- idempotency key,
|
|
40
|
+
- retry policy, failure handling, reconciliation job.
|
|
41
|
+
6. Handoff to implementation:
|
|
42
|
+
- work in vertical slices,
|
|
43
|
+
- security/testing/observability checklist per slice.
|
|
44
|
+
|
|
45
|
+
## Decision Rules
|
|
46
|
+
- Do not run Pinecone and Qdrant in the same production path without an explicit ADR.
|
|
47
|
+
- Never expose `service_role` to client apps.
|
|
48
|
+
- For multi-tenant systems, enforce tenant boundaries in schema + RLS + API layer.
|
|
49
|
+
- n8n should not replace core domain logic; use it for orchestration/integration only.
|
|
50
|
+
|
|
51
|
+
## Minimum Deliverables
|
|
52
|
+
- ADR: vector DB choice and deployment model.
|
|
53
|
+
- API/data contracts for ingestion/search/update/delete.
|
|
54
|
+
- Supabase RLS policy list and auth model.
|
|
55
|
+
- n8n workflow map (trigger -> transform -> action -> error path).
|
|
56
|
+
- Observability plan (logs/metrics/traces + alert conditions).
|
|
57
|
+
|
|
58
|
+
## Boundaries
|
|
59
|
+
- No mock functions/mock data for real production/demo flows.
|
|
60
|
+
- Do not ship without failure paths (retry/timeout/error handling).
|
|
61
|
+
- For high-risk flows, block release if security or parity evidence is missing.
|
package/locales/en/AGENTS.md
CHANGED
|
@@ -55,6 +55,7 @@ Use skills (folders with `SKILL.md`). Full list:
|
|
|
55
55
|
- $deployment_ci_plan
|
|
56
56
|
- $docker_kubernetes_architecture
|
|
57
57
|
- $k8s_manifests_conventions
|
|
58
|
+
- $n8n_pinecone_qdrant_supabase
|
|
58
59
|
- $wix_self_hosted_embedded_script
|
|
59
60
|
- $wix_iframe_sdk
|
|
60
61
|
- $react_15_3_wix_iframe (conditional, only for Wix iFrame / React 15.3)
|
|
@@ -77,6 +78,7 @@ Use skills (folders with `SKILL.md`). Full list:
|
|
|
77
78
|
- $observability_logging
|
|
78
79
|
- $dev_reference_snippets
|
|
79
80
|
- $mongodb_mongoose_best_practices
|
|
81
|
+
- $n8n_pinecone_qdrant_supabase
|
|
80
82
|
- $wix_self_hosted_embedded_script
|
|
81
83
|
- $wix_iframe_sdk
|
|
82
84
|
- $react_15_3_wix_iframe (conditional, only for Wix iFrame / React 15.3)
|
|
@@ -189,6 +189,7 @@ P1 if:
|
|
|
189
189
|
- $deployment_ci_plan
|
|
190
190
|
- $docker_kubernetes_architecture
|
|
191
191
|
- $k8s_manifests_conventions
|
|
192
|
+
- $n8n_pinecone_qdrant_supabase
|
|
192
193
|
- $wix_self_hosted_embedded_script
|
|
193
194
|
- (conditional) $wix_iframe_sdk - use if:
|
|
194
195
|
- Wix iFrame SDK functions/calls are found in an existing project, or
|
|
@@ -152,6 +152,7 @@ After each `DEV-xx`, provide `DEMO-xx`:
|
|
|
152
152
|
- $observability_logging
|
|
153
153
|
- $dev_reference_snippets
|
|
154
154
|
- $mongodb_mongoose_best_practices
|
|
155
|
+
- $n8n_pinecone_qdrant_supabase
|
|
155
156
|
- $wix_self_hosted_embedded_script
|
|
156
157
|
- (conditional) $wix_iframe_sdk - use if:
|
|
157
158
|
- Wix iFrame SDK functions/calls are found in the existing project, or
|