chore: enhance project for AI-assisted development

[TomerFi]

Summary

• Enhanced CodeRabbit config with tone and path-specific instructions for better AI code reviews
• Added Cursor agents (code-reviewer, docs-writer) for AI-assisted development workflows
• Added Cursor skill for adding stats modules with step-by-step guidance
• Created CONTRIBUTING.md with comprehensive development setup and Cursor IDE documentation
• Added workflow concurrency groups to prevent duplicate runs and save CI resources
• Added path filters to lint workflow to run only on relevant file changes
• Enhanced .gitignore with OS, IDE, and environment patterns
• Removed .gitattributes (not needed for Node.js project)
• Cleaned up project rules (removed Git-specific sections)

These changes make the project more AI-friendly and maintainable with less manual effort.

Summary by CodeRabbit

• Chores

  • Improved CI workflows with concurrency controls and path-based triggers
  • Cleaned and reorganized repository config and ignore rules; removed obsolete attributes file

• Documentation

  • Added extensive developer docs: contribution guide, testing commands, linting, and project rules
  • Added checklists and how-tos for adding and testing new statistics modules and CLI usage

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds project review/configuration and extensive documentation: CodeRabbit review rules, Cursor IDE agents/commands/skills, CONTRIBUTING and project rules, GitHub Actions workflow tweaks (concurrency, path filters), lint/test command docs, .gitignore cleanup, and removal of .gitattributes — no application code changes.

Changes

Cohort / File(s)	Summary
CodeRabbit config \.coderabbit.yaml	Adds tone_instructions and narrowed JS review rules targeting src/api.js, adds CLI and stats-module review entries, and workflow review guidance.
Cursor agents & rules .cursor/agents/code-reviewer.md, .cursor/agents/docs-writer.md, .cursor/rules/project-rules.mdc	Adds code-review checklist and docs-writer guidance; introduces project rules covering style, API usage, singleton GraphQL client pattern, and tooling.
Cursor command docs .cursor/commands/lint.md, .cursor/commands/test-contribs.md, .cursor/commands/test-org.md, .cursor/commands/test-repo.md	New command documentation for lint and local test commands (contribs/org/repo) including prerequisites, GITHUB_TOKEN scopes, and example run instructions.
Cursor skill .cursor/skills/add-stats-module/SKILL.md	Guides authors to add new stats modules: async structure, GraphQL queries, error handling, CLI wiring, npm scripts, and docs/testing checklist.
GitHub Workflows .github/workflows/lint.yml, .github/workflows/release.yml, .github/workflows/test_run.yml	Adds concurrency blocks to workflows; lint workflow gains path filters and concurrency cancel behavior; release/test_run workflows add concurrency group settings.
Repository config .gitignore, .gitattributes	.gitignore reorganized and expanded (env files, IDE swaps, my_org, Thumbs.db); .gitattributes removed entirely.
Contribution guide CONTRIBUTING.md	New comprehensive CONTRIBUTING.md covering setup, Cursor integration, coding standards, testing, PR workflow, token scopes, and adding stats modules.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• chore: add coderabbit configuration #254: Overlaps on changes to CodeRabbit review configuration and path-specific JavaScript review rules.

Poem

🐰 Configs stitched neat, a burrow of rules and light,

Workflows hum softly through day and night,
Checklists hop in, docs polished and clear,
No app code harmed — just order drawing near,
I nibble on changes, and give a tiny cheer! 🥕

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'chore: enhance project for AI-assisted development' clearly and directly describes the main change across all modified files, which involve adding AI-friendly configurations, documentation, and tooling.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch chore/ai-friendly-makeover

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In @.github/workflows/release.yml:
- Around line 15-17: The workflow uses concurrency with "group: ${{
github.workflow }}-${{ github.ref }}" but has "cancel-in-progress: true", which
can abort a release mid-publish; change the concurrency setting to keep the
group but set "cancel-in-progress" to false (or remove that key) so in-progress
release runs are not canceled during publishing/tag creation, ensuring npm
publish or other non‑idempotent release steps complete.

🧹 Nitpick comments (3)

CONTRIBUTING.md (2)

67-75: Consider adding a language specifier for the project structure block.

The static analysis tool flagged this fenced code block for lacking a language specifier. While directory trees don't have a standard language identifier, you could use text or plaintext to satisfy linters without implying syntax highlighting.

Proposed fix

-```
+```text
 src/
 ├── api.js      # GraphQL client factory (singleton pattern)

---

135-140: Consider adding a language specifier for the commit examples block.

Same as above - using text would satisfy the markdown linter while maintaining the intended presentation.

Proposed fix

-```
+```text
 feat: add support for repository discussions statistics

.cursor/skills/add-stats-module/SKILL.md (1)

109-109: Convert bare URL to a markdown link.

The static analysis tool flagged the bare URL. Converting it to a proper markdown link improves accessibility and satisfies the linter.

Proposed fix

-- Use the GitHub GraphQL Explorer: https://docs.github.com/en/graphql/overview/explorer
+- Use the [GitHub GraphQL Explorer](https://docs.github.com/en/graphql/overview/explorer)

[TomerFi]

@coderabbitai resolve

[coderabbitai]

✅ Actions performed

Comments resolved.