update: consolidate export-query plugin skills and add AGENTS.md

.cursor/rules/README.md

@@ -1,25 +1,5 @@
-# Cursor rules
+# Cursor (optional)
 
-Rules give context-aware guidance for this **Contentstack query-export CLI plugin** (`@contentstack/cli-cm-export-query`).
+**Cursor** users: start at **[AGENTS.md](../../AGENTS.md)**. All conventions live in **`skills/*/SKILL.md`**.
 
-## Rules overview
-
-| File | Purpose |
-|------|---------|
-| `dev-workflow.md` | TDD, structure, validation commands (always applied) |
-| `typescript.mdc` | TypeScript style and naming |
-| `contentstack-cli.mdc` | Contentstack CLI utilities, export flow, API habits |
-| `testing.mdc` | Mocha/Chai/Sinon and coverage |
-| `oclif-commands.mdc` | Command flag and delegation patterns |
-
-## How they attach
-
-- **Always**: `dev-workflow.md`
-- **TypeScript**: `typescript.mdc`
-- **Commands** (`src/commands/**`): `oclif-commands.mdc` + `typescript.mdc`
-- **Core / utils** (`src/core/**`, `src/utils/**`, `src/types/**`): `contentstack-cli.mdc` + `typescript.mdc`
-- **Tests** (`test/**`): `testing.mdc` + domain rules as needed
-
-## Chat shortcuts
-
-You can `@`-mention rule topics (for example TypeScript or testing) depending on how your workspace maps rule names.
+This folder only points contributors to **`AGENTS.md`** so editor-specific config does not duplicate the canonical docs.

.talismanrc

@@ -1,14 +1,14 @@
 fileignoreconfig:
-  - filename: skills/code-review/SKILL.md
-    checksum: 8c0c5c1a18ba08aa0c048d261f1ca81c152def23745fd74b531b75a23a5ac969
-  - filename: skills/framework/SKILL.md
-    checksum: 5674849276e2087f6361decb2c7e427f451ec7799538fa2eb697b0a8b7b92f44
-  - filename: .cursor/rules/contentstack-cli.mdc
-    checksum: 11bf8883f584b900ce1cde336057391717b47eb5a304cb46c5660bb3185cef2f
-  - filename: skills/code-review/references/code-review-checklist.md
-    checksum: 6e65ad06469083ed0196edaf8bd2d4478800493b32535be7c98e436082fba44a
-  - filename: skills/framework/references/framework-patterns.md
-    checksum: cae3858eea36c1f716ebe4a9679fc3d4eee628cb244cf4fc0a6eccbd8cecb36d
   - filename: package-lock.json
-    checksum: 9b73c1e977f09964843bd5f7529ca8decb7e8b5ab462a4e9ab167ff2a05df53f
-version: '1.0'
+    checksum: a907736828db3f054d2e29324a26265e4eeee28416ca2feef4b71ac037468d08
+  - filename: skills/testing/SKILL.md
+    checksum: da9831797a5e6a4d2e6e846c3f6d2583d84008d2dfd454dd7effe2f897c43a7b
+  - filename: skills/framework/SKILL.md
+    checksum: 2b74c9aaeeee804fe3c2d11e5ed14a20b82922c1d343e7ac0572da1abcc6d26a
+  - filename: skills/contentstack-cli/SKILL.md
+    checksum: b42e3526fb902a31080824b776cc8e233646139ee0915d89c0925744d56d586f
+  - filename: skills/code-review/SKILL.md
+    checksum: dd24d9e45419787c36cd50142422be53316c4e88dde2d651cc78314db1d4e6aa
+  - filename: skills/dev-workflow/SKILL.md
+    checksum: 03434201e3aaaa9239aff2f97826d64ac4ca31467b77c07330ac4b608ee24939
+version: "1.0"

AGENTS.md

@@ -0,0 +1,45 @@
+# CLI export-query plugin – Agent guide
+
+**Universal entry point** for contributors and AI agents. Detailed conventions live in **`skills/*/SKILL.md`**.
+
+## What this repo is
+
+| Field | Detail |
+| --- | --- |
+| **Name:** | `@contentstack/cli-cm-export-query` ([repository](https://github.com/contentstack/cli)) |
+| **Purpose:** | OCLIF plugin for **query-based** stack export (`cm:stacks:export-query` / short `EXPRTQRY`); implements `QueryExporter` and related export flow. |
+| **Out of scope (if any):** | Other export/import plugins live in sibling packages; this repo is only the query-export plugin. |
+
+## Tech stack (at a glance)
+
+| Area | Details |
+| --- | --- |
+| **Language** | TypeScript **^4.9** (`tsconfig.json`); Node **>= 14** (`engines`) |
+| **Build** | `tsc -b` → `lib/`; `prepack` runs compile + `oclif manifest` + `oclif readme`; copies `src/config` → `lib/` |
+| **Tests** | Mocha + Chai + Sinon; **nyc** coverage; tests under `test/**/*.test.ts` (see [skills/testing/SKILL.md](skills/testing/SKILL.md)) |
+| **Lint / coverage** | ESLint `src/**/*.ts`; nyc in `npm test` |
+| **Other** | OCLIF v4, Husky |
+
+## Commands (quick reference)
+
+| Command type | Command |
+| --- | --- |
+| **Build** | `npm run build` |
+| **Test** | `npm test` |
+| **Lint** | `npm run lint` |
+
+CI: [.github/workflows/unit-test.yml](.github/workflows/unit-test.yml); also `release.yml`, `sca-scan.yml`, `policy-scan.yml` under [.github/workflows/](.github/workflows/).
+
+## Where the documentation lives: skills
+
+| Skill | Path | What it covers |
+| --- | --- | --- |
+| Development workflow | [skills/dev-workflow/SKILL.md](skills/dev-workflow/SKILL.md) | CI, branches, Husky, PR expectations |
+| Contentstack CLI | [skills/contentstack-cli/SKILL.md](skills/contentstack-cli/SKILL.md) | Commands, `QueryExporter`, APIs |
+| Framework | [skills/framework/SKILL.md](skills/framework/SKILL.md) | Config, logging, errors, utilities |
+| Testing | [skills/testing/SKILL.md](skills/testing/SKILL.md) | Mocha/Chai/Sinon, nyc, TDD |
+| Code review | [skills/code-review/SKILL.md](skills/code-review/SKILL.md) | PR checklist |
+
+## Using Cursor (optional)
+
+If you use **Cursor**, [.cursor/rules/README.md](.cursor/rules/README.md) only points to **`AGENTS.md`**—same docs as everyone else.