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/AGENTS.md b/AGENTS.md index d86970c2a..ba604ab23 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 --- @@ -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. 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/`. 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