Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

delete-initial-resource

/delete-initial-resource

Usuwa z kodu wybrane wbudowane zasoby CRM (kontakty, firmy, deale, tagi, zadania) skryptem delete-initial-resource.ts i prowadzi przez sprzątanie plików, które się do nich odwołują.

Repozytorium
atomic-crm ↗
Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: delete-initial-resource.ts

Co robi i kiedy

Usuwa z kodu wybrane wbudowane zasoby CRM (kontakty, firmy, deale, tagi, zadania) skryptem delete-initial-resource.ts i prowadzi przez sprzątanie plików, które się do nich odwołują.

Oryginalny opis (EN)

Remove one or more of the initial CRM resources (contacts, companies, deals, tags, tasks) from the codebase. Use when the user asks to delete, remove, or strip out one or several of these built-in resources. Runs the delete-initial-resource.ts script to drop each resource's own folder, then guides cleanup of every file that references them.

Jak działa

  1. Overview
  2. When to Use
  3. Steps
  4. The script
  5. Shapes a resource takes
  6. Backend (the script only touches frontend)
  7. Rationalizations
  8. Red Flags
  9. Verification
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 1 277 słów
Podgląd SKILL.md
---
name: delete-initial-resource
description: Remove one or more of the initial CRM resources (contacts, companies, deals, tags, tasks) from the codebase. Use when the user asks to delete, remove, or strip out one or several of these built-in resources. Runs the delete-initial-resource.ts script to drop each resource's own folder, then guides cleanup of every file that references them.
---

# delete-initial-resource

## Overview

Removes one or more of the five initial Atomic CRM resources (`contacts`, `companies`, `deals`, `tags`, `tasks`) and every reference to them. **Irreversible confirm the target(s) with the user first; rely on git to recover.** Exit criterion: `make typecheck && make lint` is clean and no live reference to the deleted resource(s) survives in `src/` or `supabase/`.

## When to Use

- The user asks to delete, remove, or strip out one or several built-in CRM resources.
- Not for *custom* entities added during setup only the five built-ins above.

For the backend migration mechanics, see `Skill({skill: "backend-dev"})` and `Skill({skill: "writing-migrations"})`.

## Steps

1. **Confirm the target(s)**, then read each one's file before editing:
   - `contacts` → [`contacts.md`](contacts.md) — spine; **confirm cascade scope first**
   - `companies` → [`companies.md`](companies.md) — spine/link; **confirm cascade scope first**
   - `deals` → [`deals.md`](deals.md)
   - `tags` → [`tags.md`](tags.md)
   - `tasks` → [`tasks.md`](tasks.md)
2. **Run the script** (below) — deletes each `src/components/atomic-crm/<resource>/` folder and prints the dependent files to clean.
3. **Clean each dependent file** using the "Shapes" patterns below + the per-resource file.
4. **Verify** (below).

Deleting several at once: clean from the most-coupled resource outward; clean a shared file **once** for both; and reconcile interacting union guidance — deleting both `contacts` and `deals` removes the notes/activity-log reference *entirely* rather than each narrowing it, so don't half-apply each file's "narrow the union" note.

## The script

```bash
node .claude/skills/delete-initial-resource/delete-initial-resource.ts <resource> [<resource> ...]
```

Validates the names, deletes each resource's folder, and prints the **merged, de-duplicated dependent-file list** (files inside a just-deleted folder are dropped). It does **not** edit those files — that's your job. Each entry in the script's `dependentFiles` map has a `//` comment saying *what* to remove; read it alongside the printed list, and update the map if the codebase grows new references.

## Shapes a resource takes

A resource is rarely just a folder. The later shapes are invisible to a `\b<resource>\b` grep:

- **Standalone** — imports, JSX, routes, menu/nav, dashboard widgets, the `<Resource>` entry in `root/CRM.tsx`. Wrapper components *outside* the folder that only render the resource: delete outright, then clean importers.
- **Field/column on another record** — fans out far wider: the `types.ts` type, `providers/commons/mergeContacts.ts`, CSV/JSON import, i18n, stories/tests, `StoryWrapper` builders, and the sample CSVs (header **and** every row). For a *link* column, decide per-link: orphaned shell (typed, defaulted) or drop — remove the UI either way.
- **Aggregated `nb_<resource>`** (from the `_summary` views) lands on a record type, read across shows/lists/filters/generators. **Invisible to a `\b<resource>\b` grep** (the `_` is a word char) — grep `nb_<resource>` and the denormalized `company_name` separately.
- **Shared subsystems** — notes (`reference: "contacts" | "deals"`) and the activity log (`"company" | "contact" | "deal" | "all"` union). Narrow the union, delete the per-type render components (`ActivityLog*Created.tsx`) + dead branches, prune the `providers/commons/activity.ts` fetcher + `consts.ts`/`types.ts` members. Surviving `=== "<other>"` checks stay valid — only the deleted member's branches go.
- **Config props** (`taskTypes`, `dealStages`, `companySectors`) live in `root/defaultConfiguration.ts`, `ConfigurationContext.tsx`, `CRM.tsx` (default + jsdoc + store seed), `App.tsx`, and `SettingsPage.tsx` (the `<Card>` **and** the section-list entry). **Not always named after the resource** — grep the settings `<Card>` for other keys (Deals owned `currency`) and flag borderline-general ones rather than dropping them silently.
- **Custom dataProvider methods** live in **both** providers; `CrmDataProvider` derives from the supabase one, so removing them there drops them from the type. Also clean the lifecycle-callback blocks in both providers, the `sales` `beforeDelete` reassignment, the supabase `<resource> -> <resource>_summary` `getList` routing, and the FakeRest generators (which *drive* record creation).
- **JSON importer** (`misc/useImportFromJson.ts`) treats `contacts`/`companies`/`notes`/`tasks` as top-level types (`import<X>` fn, `$.<x>.*` path, a `TYPES` arm + switch, guards, `stats`/`failedImports`/`idsMaps` keys). Mirror in `ImportPage.tsx` + `import-sample.json`; the CSV importer (`useContactImport.tsx`) has parallel mappings.
- Check `useCallback`/`useMemo` deps — a stale `getTags`/`getCompanies` there is invisible until `tsc`.

## Backend (the script only touches frontend)

See the `backend-dev` skill for the migration workflow. In `supabase/schemas/`:

- Drop/adjust the table + view, generate a migration (`npx supabase db diff --local -f remove_<resource>`); update `contacts_summary`/`companies_summary` if they aggregated it.
- **`activity_log`** is a `UNION ALL` with the same column set per branch — remove the resource's columns from **every** branch (keep them aligned), delete its dedicated branch(es), and drop the matching snake→camel rename in the supabase `getList("activity_log")`.
- `06_grants.sql` grants the table **and** its `<resource>_id_seq` (drop both). `05_policies.sql` has an RLS-enable line **and** `create policy` statements (drop both).
- A resource used inside a SQL function (`merge_contacts`): drop those lines + the unused local var. Editing `02_functions.sql` regenerates the whole function (expected) — renumber leftover step comments.
- **Orphan check:** deleting triggers can orphan helpers — but verify shared callers first (`get_domain_favicon` survives a `companies` delete because contact avatars also call it).
- **Edge functions** are separate and easy to miss: `merge_contacts/`, `_shared/db.ts` (Kysely types), `postmark/` (inbound email), and `mcp/` (an AI subsystem whose depth varies per resource). When a surviving function loses a capability, **flag it to the user**.

## Rationalizations

| Rationalization | Reality |
|---|---|
| "I deleted the folder, the resource is gone." | A resource is also fields on other records, `nb_<resource>` aggregates, shared subsystems, config props, dataProvider methods, and SQL — the folder is the easy part. |
| "A `\b<resource>\b` grep came back clean, so it's clean." | `nb_<resource>` and denormalized `company_name` are invisible to that grep (`_` is a word char). Grep them separately. |
| "I'll remove the i18n key from English only." | The French catalog is type-checked against English — a one-sided removal is a `tsc` error. Remove from both or neither. |
| "The script edits the dependent files for me." | The script only deletes folders and prints the list. Editing every dependent file is your job. |
| "Typecheck passes, so the deletion is complete." | `tsc` misses broken views/functions/grants. Reset the DB and grep for live references too. |

## Red Flags

- Editing files inside `supabase/migrations/` (never — they are append-only history).
- A one-sided i18n key removal (English without French, or vice versa).
- Relying on a single `\b<resource>\b` grep and skipping `nb_<resource>` / `company_name`.
- Deleting a shared SQL helper or edge-function capability without checking surviving callers.
- Deleting several resources but half-applying each file's "narrow the union" note.
- Skipping the `db reset` check when Supabase is running.

## Verification

```bash
make typecheck && make lint
```

Resolve whatever `tsc` surfaces (the dependent-file list is a guide, not a guarantee). Then `grep -rniE "\b<resource>\b"` over `src/`+`supabase/`, plus **separate** greps for `nb_<resource>`, `company_name`, and config-prop names (`<resource>Types`, `companySectors`, `currency`). Watch for benign/substring false positives (each resource file lists its own); never edit `supabase/migrations/`.

- [ ] `make typecheck && make lint` is clean.
- [ ] `\b<resource>\b`, `nb_<resource>`, `company_name`, and config-prop greps return only benign matches.
- [ ] i18n keys removed from both catalogs, or neither.
- [ ] Backend: table/view/policies/grants/sequences and any function references handled in `supabase/schemas/` (not `migrations/`).
- [ ] If Supabase is running, `npx supabase db reset --local` replays cleanly.
- [ ] Any lost edge-function capability flagged to the user.

**i18n is all-or-nothing:** `frenchCrmMessages.ts` is type-checked against the type derived from `englishCrmMessages.ts`, so remove a key from **both** catalogs or **neither** (a one-sided removal is a `tsc` error). Dead `resources.<x>.*` keys are harmless — flag rather than force. `frenchCrmMessages.ts` uses literal `…` escapes; if an exact-string `Edit` fails on a block spanning one, fall back to `sed -i '<from>,<to>d'`.

If Supabase is running, `npx supabase db reset --local` replays the chain + `seed.sql` and catches a broken view/function/grant `db diff` misses (benign `index "…_pkey" does not exist` NOTICEs expected). On Node 24 (see `.nvmrc`), `make test` (vitest) is also available.
Pliki w paczce (7)
  • SKILL.md 9 KB
  • companies.md 7 KB
  • contacts.md 6 KB
  • deals.md 3 KB
  • delete-initial-resource.ts 17 KB
  • tags.md 1 KB
  • tasks.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie delete-initial-resource.

Migawka bazy z 13.11.2026 · wersja paczki 42f726bea4d4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100api-resource-lifecycle
    Prowadzi operacje CRUD na zasobach API z kaskadowymi zależnościami: opisowa walidacja, zapobieganie osieroconym rekordom, kaskadowe usuwanie, wykrywanie duplikatów i wycofanie przy błędzie.
  • 90working-in-flito
    Pracuje w CRM Flito przez narzędzia Flito: klienci, firmy, kontakty, szanse sprzedaży, oferty, faktury i zadania.
  • 95delete-app
    Usuwa aplikację Microsoft przez ms app delete, zawsze po wyraźnym potwierdzeniu użytkownika.
  • 100hubspot
    Odpytuje HubSpot CRM o deale, kontakty, firmy i metryki sprzedaży, na przykład o lejek sprzedaży, status deali i dane klientów.
  • 100python-resource-management
    Pilnuje zasobów w Pythonie: menedżery kontekstu, sprzątanie połączeń i plików oraz strumieniowe odpowiedzi z zebranym stanem.
  • 100remove-feature
    Usuwa z mikroserwisu endpoint, konfigurację, metrykę, ticker lub zdarzenie na prośbę o usunięcie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.