From 061ba9e9b44919e70fb5f618c4c0d22656b73cd2 Mon Sep 17 00:00:00 2001 From: re-vlad Date: Mon, 6 Apr 2026 01:39:04 +0300 Subject: [PATCH 1/5] (fix) Add Cursor commands and core rule for AI tooling #1411 - Add .cursor/commands/ stubs ref to .agents/skills; - Add .cursor/rules/00-core.mdc ref at AGENTS.md; - Fix README contributing links; --- .cursor/commands/address-review.md | 5 +++++ .cursor/commands/commit.md | 5 +++++ .cursor/commands/docs.md | 5 +++++ .cursor/commands/implement.md | 5 +++++ .cursor/commands/issue.md | 5 +++++ .cursor/commands/lint.md | 5 +++++ .cursor/commands/summary.md | 5 +++++ .cursor/rules/00-core.mdc | 9 +++++++++ README.md | 2 +- 9 files changed, 45 insertions(+), 1 deletion(-) create mode 100644 .cursor/commands/address-review.md create mode 100644 .cursor/commands/commit.md create mode 100644 .cursor/commands/docs.md create mode 100644 .cursor/commands/implement.md create mode 100644 .cursor/commands/issue.md create mode 100644 .cursor/commands/lint.md create mode 100644 .cursor/commands/summary.md create mode 100644 .cursor/rules/00-core.mdc diff --git a/.cursor/commands/address-review.md b/.cursor/commands/address-review.md new file mode 100644 index 000000000..272b42b93 --- /dev/null +++ b/.cursor/commands/address-review.md @@ -0,0 +1,5 @@ +--- +description: Address review comments on a GitHub PR +--- + +Follow @.agents/skills/address-review/SKILL.md. diff --git a/.cursor/commands/commit.md b/.cursor/commands/commit.md new file mode 100644 index 000000000..3b6431c2c --- /dev/null +++ b/.cursor/commands/commit.md @@ -0,0 +1,5 @@ +--- +description: Create a Conventional Commit with signoff +--- + +Follow @.agents/skills/commit/SKILL.md. diff --git a/.cursor/commands/docs.md b/.cursor/commands/docs.md new file mode 100644 index 000000000..09bdec8fa --- /dev/null +++ b/.cursor/commands/docs.md @@ -0,0 +1,5 @@ +--- +description: Update project docs per repo guidelines +--- + +Follow @.agents/skills/docs/SKILL.md. diff --git a/.cursor/commands/implement.md b/.cursor/commands/implement.md new file mode 100644 index 000000000..347b1cbdb --- /dev/null +++ b/.cursor/commands/implement.md @@ -0,0 +1,5 @@ +--- +description: Implement a change following repo workflow +--- + +Follow @.agents/skills/implement/SKILL.md. diff --git a/.cursor/commands/issue.md b/.cursor/commands/issue.md new file mode 100644 index 000000000..d341c58bb --- /dev/null +++ b/.cursor/commands/issue.md @@ -0,0 +1,5 @@ +--- +description: Create a GitHub issue markdown file +--- + +Follow @.agents/skills/issue/SKILL.md. diff --git a/.cursor/commands/lint.md b/.cursor/commands/lint.md new file mode 100644 index 000000000..0652b71d2 --- /dev/null +++ b/.cursor/commands/lint.md @@ -0,0 +1,5 @@ +--- +description: Run repo format + lint workflow +--- + +Follow @.agents/skills/lint/SKILL.md. diff --git a/.cursor/commands/summary.md b/.cursor/commands/summary.md new file mode 100644 index 000000000..9f4eedfa1 --- /dev/null +++ b/.cursor/commands/summary.md @@ -0,0 +1,5 @@ +--- +description: Generate a concise PR implementation summary +--- + +Follow @.agents/skills/summary/SKILL.md. diff --git a/.cursor/rules/00-core.mdc b/.cursor/rules/00-core.mdc new file mode 100644 index 000000000..e2038b791 --- /dev/null +++ b/.cursor/rules/00-core.mdc @@ -0,0 +1,9 @@ +--- +description: GitProxy core rules for Cursor +globs: ["**/*"] +alwaysApply: true +--- +Read AGENTS.md for the full project guide. It is the canonical project guide for this repository. +Keep changes aligned with the chain-of-processors architecture. +Prefer the existing build, test, lint, and format commands listed in AGENTS.md. +Project skills are defined in .agents/skills/. diff --git a/README.md b/README.md index ad46000c6..9e5e30cea 100644 --- a/README.md +++ b/README.md @@ -96,7 +96,7 @@ customize for your environment, see the [project's documentation](https://git-pr ## Contributing -Your contributions are at the core of making this a truly open source project. Any contributions you make are **greatly appreciated**. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information. For AI-assisted development, start with [`AGENTS.md`](AGENTS.md). Tool-specific entry points are provided in [`CLAUDE.md`](CLAUDE.md), [`.cursor/rules/00-core.mdc`](.cursor/rules/00-core.mdc), and [`.github/copilot-instructions.md`](.github/copilot-instructions.md). Shared slash-command prompts live in [`.agents/commands`](.agents/commands), with tool-native entry points in [`.claude/commands`](.claude/commands) and [`.cursor/commands`](.cursor/commands). +Your contributions are at the core of making this a truly open source project. Any contributions you make are **greatly appreciated**. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information. For AI-assisted development, start with [`AGENTS.md`](AGENTS.md). Tool-specific entry points are provided in [`CLAUDE.md`](CLAUDE.md), [`.cursor/rules/00-core.mdc`](.cursor/rules/00-core.mdc), and [`.github/copilot-instructions.md`](.github/copilot-instructions.md). Shared slash-command prompts live in [`.agents/skills`](.agents/skills), with tool-native entry points in [`.claude/skills`](.claude/skills) and [`.cursor/commands`](.cursor/commands). ## Security From e0a9db613817e85fc5f18c420279387113b2bfcf Mon Sep 17 00:00:00 2001 From: re-vlad Date: Mon, 6 Apr 2026 01:59:53 +0300 Subject: [PATCH 2/5] Fix the empty "Stack:" field in AGENTS.md --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index d86970c2a..dcec0dfd5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -36,7 +36,7 @@ npm run format:check npm run format ``` -**Stack: ** +**Stack:** TypeScript, Node >=22, Express 5, React 16, Vitest 3, NeDB / MongoDB --- From 66533fbae940031ee362f97b9f7b15c257fd0d73 Mon Sep 17 00:00:00 2001 From: re-vlad Date: Mon, 6 Apr 2026 02:18:08 +0300 Subject: [PATCH 3/5] docs: Add GEMINI.md bridge file --- .gitignore | 3 +++ GEMINI.md | 10 ++++++++++ 2 files changed, 13 insertions(+) create mode 100644 GEMINI.md diff --git a/.gitignore b/.gitignore index f38f3b36a..56c04a9dc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,6 @@ +#QWEN +.qwen/ + # Logs .logs .vscode diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 000000000..c8bb81d09 --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,10 @@ +# Gemini Instructions + +Read and follow `AGENTS.md` first. It is the canonical project guide for this repository. + +Additional Gemini-specific notes: + +- Apply `AGENTS.md` as the source of truth. If this file and `AGENTS.md` ever differ, `AGENTS.md` wins. +- Keep changes aligned with the chain-of-processors architecture. Do not bypass approval gating, `blockForAuth`, waiting-authorization checks, or audit logging. +- Prefer the existing build, test, lint, and format commands listed in `AGENTS.md`. +- Project skills are defined in `.agents/skills/`. From 488da62d47c72190d5258c30ac1619f7ceb4441c Mon Sep 17 00:00:00 2001 From: re-vlad Date: Mon, 6 Apr 2026 02:35:55 +0300 Subject: [PATCH 4/5] docs: add a self-documenting header in AGENTS.md --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index dcec0dfd5..ba604ab23 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -366,6 +366,19 @@ All source files must include the Apache 2.0 license header (see any existing fi --- +## Tool Integration + +This file is the canonical project guide. Tool-specific entry points: + +- Claude Code: `CLAUDE.md` (bridge) + `.claude/skills/` +- GitHub Copilot: `.github/copilot-instructions.md` +- OpenCode: `.opencode/commands/` +- Gemini CLI: `GEMINI.md` (bridge) +- Cursor: `.cursor/rules/00-core.mdc` + `.cursor/commands/` +- Codex: `AGENTS.md` primary — (Codex does not have a dedicated convention file) + +--- + ## Agent Workflow **The main agent must act as an orchestrator.** Never do work inline that can be delegated to a subagent. From 0514e267d7901264844bb3de411e6cb991b28f14 Mon Sep 17 00:00:00 2001 From: re-vlad Date: Mon, 6 Apr 2026 09:20:21 +0300 Subject: [PATCH 5/5] fix: rollback .gitignore changes --- .gitignore | 3 --- 1 file changed, 3 deletions(-) diff --git a/.gitignore b/.gitignore index 56c04a9dc..f38f3b36a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,3 @@ -#QWEN -.qwen/ - # Logs .logs .vscode