updated the cursor rules structure

Author: cs-raj

.cursor/rules/README.md

@@ -1,22 +1,7 @@
-# Cursor rules
+# Cursor (optional)
 
-Context-aware guidance for developing `@contentstack/cli-cm-regex-validate` (Contentstack CLI oclif plugin).
+**Cursor** users: start at **[`AGENTS.md`](../../AGENTS.md)**. All conventions live in **`skills/*/SKILL.md`**.
 
-## Rules overview
+This folder only points contributors to **`AGENTS.md`** so editor-specific config does not duplicate the canonical docs.
 
-| File | Scope |
-|------|--------|
-| `dev-workflow.md` | Core workflow, validation commands, links to skills (always applied) |
-| `typescript.mdc` | TypeScript and ESLint conventions |
-| `testing.mdc` | Jest + ts-jest tests |
-| `oclif-commands.mdc` | Command classes under `src/commands/` |
-| `contentstack-cli.mdc` | Utilities under `src/utils/` (SDK, safe-regex, output) |
-
-## How rules apply
-
-- `dev-workflow.md` uses `alwaysApply: true` and broad globs so it loads for most edits.
-- `.mdc` rules load when you work in matching paths (see each file’s `globs`).
-
-## Manual references in chat
-
-You can mention rules by context, for example: TypeScript guidance when editing `src/**/*.ts`, testing patterns when editing `**/*.test.ts`.
+Path from this file to the repo root agent guide: **`../../AGENTS.md`** (two levels up from `.cursor/rules/`).

.cursor/rules/contentstack-cli.mdc

@@ -1,10 +1,8 @@
 fileignoreconfig:
-  - filename: package-lock.json
-    checksum: 3f663322d950acc49b7e8899ca353456b1e7ac6277ac36fdfcac813644fb07d7
-  - filename: .cursor/rules/dev-workflow.md
-    checksum: 9912be426cb15077a67b81bd5801f2a65d367e30204d278c6814ebb1d74661ba
+  - filename: skills/dev-workflow/SKILL.md
+    checksum: bbe23955b8865b7b44e8adaf414dce2b0127921ed1e35488adf470fdd833270f
   - filename: skills/code-review/references/code-review-checklist.md
-    checksum: 8bc8e53a9775258ddfadb40f9a6f415508d87aa9c70c95ebf748737e1ef7dbee
-  - filename: skills/contentstack-cli/references/contentstack-patterns.md
-    checksum: 3e3f445d01c67577dc91b1ba6ee27dcd1ffc1e907b2fbf33ce9b2905eaba239a
+    checksum: 7b5132bc27e2328f32ecf38941bb117a77be0d83502f15c3a5d1933f3220b6fc
+  - filename: package-lock.json
+    checksum: 31cf2fecced45ffd2db8b1f7c5258d1c98c2d0be7dd443460cfc070558a85c82
 version: ""

.cursor/rules/dev-workflow.md

@@ -1,41 +1,46 @@
-# cli-cm-regex-validate
+# cli-cm-regex-validate – Agent guide
 
-`@contentstack/cli-cm-regex-validate` is a **Contentstack CLI** oclif plugin with a single command, **`csdx cm:stacks:validate-regex`**, which scans content types and/or global fields in a stack for regex `format` values that fail the `safe-regex` check, then writes results to CSV and prints a summary table. User-facing copy lives in `messages/index.json`.
+**Universal entry point** for contributors and AI agents. Detailed conventions live in **`skills/*/SKILL.md`**.
 
-## Layout
+## What this repo is
 
-| Area | Path |
-|------|------|
-| Command | `src/commands/cm/stacks/validate-regex.ts` |
-| Utils | `src/utils/` (`connect-stack`, `process-stack`, `safe-regex`, `generate-output`, `interactive`) |
-| Messages | `messages/index.json` |
-| Tests | `test/utils/*.test.ts` |
-| Fixtures | `test/data/*.json` |
+| Field | Detail |
+|-------|--------|
+| **Name:** | [contentstack/cli-cm-regex-validate](https://github.com/contentstack/cli-cm-regex-validate) (`@contentstack/cli-cm-regex-validate` on npm) |
+| **Purpose:** | Contentstack CLI oclif plugin with a single command, **`csdx cm:stacks:validate-regex`**, which scans content types and/or global fields in a stack for regex `format` values that fail the `safe-regex` check, then writes results to CSV and prints a summary table. User-facing copy lives in `messages/index.json`. |
+| **Out of scope (if any):** | Not a general-purpose Contentstack SDK — only this plugin’s command, utils, and tests. |
 
-## Workflow
+## Tech stack (at a glance)
 
-- Run **`npm test`** (Jest + ts-jest) before pushing; CI uses the same in `.github/workflows/unit-tests.yml`.
-- Run ESLint after tests via **`npm run posttest`** (or your team’s eslint invocation from `package.json`).
+| Area | Details |
+|------|---------|
+| Language | TypeScript (`strict`), Node `>=14.0.0` per `package.json` engines |
+| Build | npm; `prepack` runs `tsc -b`, oclif manifest, oclif readme — see `package.json` |
+| Tests | Jest + ts-jest (`jest.config.ts`), `npm test`; suites under `test/utils/`, fixtures `test/data/*.json` |
+| Lint / coverage | ESLint (`.eslintrc`), `npm run posttest` |
+| Other | oclif v3, `@contentstack/cli-command`; CI: Node 22.x — [`.github/workflows/unit-tests.yml`](.github/workflows/unit-tests.yml). **CI runs Jest only** (`npm run test`); **ESLint is not run in CI** — run `npm run posttest` locally before merge. |
 
-## Naming
+## Commands (quick reference)
 
-- Source files: kebab-case.
-- Tests: describe behavior clearly (what should happen under which condition).
+| Command type | Command |
+|--------------|---------|
+| Build (release prep) | `npm run prepack` — cleans `lib`, compiles, generates oclif manifest and readme |
+| Test | `npm test` |
+| Lint | `npm run posttest` |
 
-## Universal skills (any agent)
+CI runs `npm i` and `npm run test` on pull requests — see [`.github/workflows/unit-tests.yml`](.github/workflows/unit-tests.yml). It does **not** run `npm run posttest` (ESLint); run lint locally before merging.
 
-- `@skills/testing` — Jest mocks, fixtures, no live API calls
-- `@skills/contentstack-cli` — SDK flow, schema recursion, `safe-regex`, output
-- `@skills/code-review` — PR checklist (security, packaging, CI, messages)
+## Where the documentation lives: skills
 
-## Cursor rules (IDE)
+| Skill | Path | What it covers |
+|-------|------|----------------|
+| Development workflow | [`skills/dev-workflow/SKILL.md`](skills/dev-workflow/SKILL.md) | Commands, repo layout, naming, hooks, TDD, before merge |
+| Testing | [`skills/testing/SKILL.md`](skills/testing/SKILL.md) | Jest, mocks, fixtures, no live API calls |
+| Contentstack CLI | [`skills/contentstack-cli/SKILL.md`](skills/contentstack-cli/SKILL.md) | Command flow, SDK, schema walk, `safe-regex`, CSV/table output |
+| Code review | [`skills/code-review/SKILL.md`](skills/code-review/SKILL.md) | PR and release checklist |
 
-For file-scoped guidance, Cursor loads rules under `.cursor/rules/`. You can reference them in chat by intent, for example:
+An index with “when to use” hints is in [`skills/README.md`](skills/README.md).
 
-- TypeScript and ESLint conventions — `typescript.mdc`
-- Jest tests — `testing.mdc`
-- Command class — `oclif-commands.mdc`
-- Utils (SDK, safe-regex, output) — `contentstack-cli.mdc`
-- Dev workflow — `dev-workflow.md` (always applied)
+## Using Cursor (optional)
 
-See `.cursor/rules/README.md` for the full index.
+If you use **Cursor**, [`.cursor/rules/README.md`](.cursor/rules/README.md) only points to **[`AGENTS.md`](AGENTS.md)** — same docs as everyone else.