Skip to content

Commit c7c318d

Browse files
chore: update AI coding rules
- Added/Updated: 408 files - Deleted: 0 files - Generated from: bitsoex/ai-code-instructions@3b7bfa9 [skip ci]
1 parent 7a67c58 commit c7c318d

408 files changed

Lines changed: 64825 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.ai-rules-manifest.json

Lines changed: 440 additions & 0 deletions
Large diffs are not rendered by default.
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Never work directly on main. Always verify your branch and create a new one if needed before making changes.
2+
3+
**Applies to:** **/*
4+
5+
# Never work directly on main. Always verify your branch and create a new one if needed before making changes.
6+
7+
**Rule**: Never commit directly to `main`. All work must happen on a feature/fix/chore branch.
8+
9+
## Quick Reference
10+
11+
```bash
12+
# Fetch latest
13+
git fetch --all
14+
15+
# Check current branch
16+
git branch --show-current
17+
18+
# If on main, create feature branch
19+
git checkout main
20+
git pull origin main
21+
22+
## 📚 Full Documentation
23+
24+
For complete guidelines, scripts, and references, see the skill:
25+
26+
```
27+
.claude/skills/pr-lifecycle/SKILL.md
28+
```
29+
30+
The skill includes:
31+
- **SKILL.md** - Complete instructions and quick start
32+
- **scripts/** - Executable automation scripts
33+
- **references/** - Detailed documentation
34+
- **assets/** - Templates and resources
35+
36+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
37+
38+
39+
---
40+
*This rule is part of the java category.*
41+
*Source: global/rules/branch-protection-workflow.md*
42+
43+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
44+
<!-- Source: bitsoex/ai-code-instructions → global/rules/branch-protection-workflow.md -->
45+
<!-- To modify, edit the source file and run the distribution workflow -->

.claude/coderabbit-setup.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# CodeRabbit Setup
2+
3+
4+
# CodeRabbit Setup
5+
6+
CodeRabbit CLI integrates code review capabilities into your development workflow, identifying issues like race conditions, memory leaks, security vulnerabilities, and logic errors.
7+
8+
## Quick Installation
9+
10+
```bash
11+
# Install
12+
curl -fsSL https://cli.coderabbit.ai/install.sh | sh
13+
14+
# Restart shell
15+
source ~/.zshrc
16+
17+
# Authenticate
18+
coderabbit auth login
19+
20+
# Verify
21+
22+
## 📚 Full Documentation
23+
24+
For complete guidelines, scripts, and references, see the skill:
25+
26+
```
27+
.claude/skills/coderabbit-workflow/SKILL.md
28+
```
29+
30+
The skill includes:
31+
- **SKILL.md** - Complete instructions and quick start
32+
- **scripts/** - Executable automation scripts
33+
- **references/** - Detailed documentation
34+
- **assets/** - Templates and resources
35+
36+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
37+
38+
39+
---
40+
*This rule is part of the java category.*
41+
*Source: global/rules/coderabbit-setup.md*
42+
43+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
44+
<!-- Source: bitsoex/ai-code-instructions → global/rules/coderabbit-setup.md -->
45+
<!-- To modify, edit the source file and run the distribution workflow -->

.claude/general-principles.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# General AI Coding Principles
2+
3+
4+
# General AI Coding Principles
5+
6+
These principles apply to all repositories regardless of technology stack.
7+
8+
## Quick Reference
9+
10+
### Code Quality
11+
12+
- Write self-documenting code with clear names
13+
- Security first: never hardcode secrets
14+
- Optimize for readability first, performance second
15+
- Fail fast with meaningful error messages
16+
17+
### Development Practices
18+
19+
- Never downgrade pre-existing dependency versions
20+
- Make atomic commits with descriptive messages
21+
22+
## 📚 Full Documentation
23+
24+
For complete guidelines, scripts, and references, see the skill:
25+
26+
```
27+
.claude/skills/coding-standards/SKILL.md
28+
```
29+
30+
The skill includes:
31+
- **SKILL.md** - Complete instructions and quick start
32+
- **scripts/** - Executable automation scripts
33+
- **references/** - Detailed documentation
34+
- **assets/** - Templates and resources
35+
36+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
37+
38+
39+
---
40+
*This rule is part of the java category.*
41+
*Source: global/rules/general-principles.md*
42+
43+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
44+
<!-- Source: bitsoex/ai-code-instructions → global/rules/general-principles.md -->
45+
<!-- To modify, edit the source file and run the distribution workflow -->

.claude/github-cli-pr-lifecycle.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# GitHub CLI PR Lifecycle
2+
3+
4+
# GitHub CLI PR Lifecycle
5+
6+
Best practices for AI agents using GitHub CLI (`gh`) to manage pull requests, CI checks, CodeRabbit reviews, and reviewer interactions.
7+
8+
## Quick Reference
9+
10+
- Auto-assign PRs using `gh api user --jq '.login'`
11+
- Use echo wrapper for `gh` commands: `echo "..." ; gh command ; echo "Done"`
12+
- Always specify `--repo owner/repo`
13+
- Use conventional commit format
14+
15+
## 📚 Full Documentation
16+
17+
For complete guidelines, scripts, and references, see the skill:
18+
19+
```
20+
.claude/skills/pr-workflow/SKILL.md
21+
```
22+
23+
The skill includes:
24+
- **SKILL.md** - Complete instructions and quick start
25+
- **scripts/** - Executable automation scripts
26+
- **references/** - Detailed documentation
27+
- **assets/** - Templates and resources
28+
29+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
30+
31+
32+
---
33+
*This rule is part of the java category.*
34+
*Source: global/rules/github-cli-pr-lifecycle.md*
35+
36+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
37+
<!-- Source: bitsoex/ai-code-instructions → global/rules/github-cli-pr-lifecycle.md -->
38+
<!-- To modify, edit the source file and run the distribution workflow -->

.claude/hooks.toml

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# AUTO-GENERATED FILE - Do not edit directly
2+
# Source: bitsoex/ai-code-instructions
3+
# To modify, edit the source files and run the distribution workflow
4+
#
5+
# This file is discovered by mise via task_config.includes = [".claude/*.toml"]
6+
# Requires mise 2026.2.5+ for glob pattern support
7+
8+
9+
# Hook tasks - run hook scripts directly via mise
10+
# Usage: mise run hook:<name>
11+
12+
["hook:secret-guard"]
13+
description = "Block shell commands that could expose secrets in cloud agent environments. Pure bash, no Node.js dependency."
14+
run = "mise exec -- node --experimental-strip-types .cursor/scripts/secret-guard.sh"
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Java Code Review Standards
2+
3+
**Applies to:** **/*.java
4+
5+
# Java Code Review Standards
6+
7+
When reviewing Java code, follow these standards:
8+
9+
## Java 21 Standards
10+
11+
- Review code using Java 21 standards.
12+
13+
## 📚 Full Documentation
14+
15+
For complete guidelines, scripts, and references, see the skill:
16+
17+
```
18+
.claude/skills/java-standards/SKILL.md
19+
```
20+
21+
The skill includes:
22+
- **SKILL.md** - Complete instructions and quick start
23+
- **scripts/** - Executable automation scripts
24+
- **references/** - Detailed documentation
25+
- **assets/** - Templates and resources
26+
27+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
28+
29+
30+
---
31+
*This rule is part of the java category.*
32+
*Source: java/rules/java-code-review-standards.md*
33+
34+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
35+
<!-- Source: bitsoex/ai-code-instructions → java/rules/java-code-review-standards.md -->
36+
<!-- To modify, edit the source file and run the distribution workflow -->
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Fix strategy hierarchy for Dependabot vulnerabilities in Java projects
2+
3+
**Applies to:** gradle/libs.versions.toml, build.gradle
4+
5+
# Fix strategy hierarchy for Dependabot vulnerabilities in Java projects
6+
7+
Fix strategies for Dependabot vulnerabilities in Java/Gradle projects.
8+
9+
## Skill Location
10+
11+
| Skill | Coverage |
12+
|-------|----------|
13+
| [fix-vulnerabilities](.claude/skills/fix-vulnerabilities/SKILL.md) | Fix strategies, severity processing, verification |
14+
15+
## 📚 Full Documentation
16+
17+
For complete guidelines, scripts, and references, see the skill:
18+
19+
```
20+
.claude/skills/fix-vulnerabilities/SKILL.md
21+
```
22+
23+
The skill includes:
24+
- **SKILL.md** - Complete instructions and quick start
25+
- **scripts/** - Executable automation scripts
26+
- **references/** - Detailed documentation
27+
- **assets/** - Templates and resources
28+
29+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
30+
31+
32+
---
33+
*This rule is part of the java category.*
34+
*Source: java/rules/java-dependabot-security.md*
35+
36+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
37+
<!-- Source: bitsoex/ai-code-instructions → java/rules/java-dependabot-security.md -->
38+
<!-- To modify, edit the source file and run the distribution workflow -->
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# RFC-44 compliant distributed locking with PostgreSQL advisory locks or Redis
2+
3+
**Applies to:** **/*Lock*.java, **/*Scheduler*.java, **/application*.yml
4+
5+
# RFC-44 compliant distributed locking with PostgreSQL advisory locks or Redis
6+
7+
RFC-44 compliant distributed locking for scheduled jobs and critical sections.
8+
9+
## Skill Location
10+
11+
| Skill | Coverage |
12+
|-------|----------|
13+
| [distributed-locking-rfc-44](.claude/skills/distributed-locking-rfc-44/SKILL.md) | Migration workflow, lock patterns, Redis integration |
14+
15+
## 📚 Full Documentation
16+
17+
For complete guidelines, scripts, and references, see the skill:
18+
19+
```
20+
.claude/skills/distributed-locking-rfc-44/SKILL.md
21+
```
22+
23+
The skill includes:
24+
- **SKILL.md** - Complete instructions and quick start
25+
- **scripts/** - Executable automation scripts
26+
- **references/** - Detailed documentation
27+
- **assets/** - Templates and resources
28+
29+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
30+
31+
32+
---
33+
*This rule is part of the java category.*
34+
*Source: java/rules/java-distributed-locking-rfc44.md*
35+
36+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
37+
<!-- Source: bitsoex/ai-code-instructions → java/rules/java-distributed-locking-rfc44.md -->
38+
<!-- To modify, edit the source file and run the distribution workflow -->
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Flyway SQL Migration Review Safety Issues Guidelines
2+
3+
**Applies to:** **/*.sql
4+
5+
# Flyway SQL Migration Review Safety Issues Guidelines
6+
7+
This document lists the database migration safety issues that code owners MUST look out for when reviewing PRs. A number of these issues were taken from the Strong Migrations (see Resources). Wherever possible, checks should be automated into our pgsqlcheck static analysis tool.
8+
9+
## 📚 Full Documentation
10+
11+
For complete guidelines, scripts, and references, see the skill:
12+
13+
```
14+
.claude/skills/database-integration/SKILL.md
15+
```
16+
17+
The skill includes:
18+
- **SKILL.md** - Complete instructions and quick start
19+
- **scripts/** - Executable automation scripts
20+
- **references/** - Detailed documentation
21+
- **assets/** - Templates and resources
22+
23+
> **Note**: This is a shallow reference. The full content is maintained in the skill to avoid duplication.
24+
25+
26+
---
27+
*This rule is part of the java category.*
28+
*Source: java/rules/java-flyway-migrations-safety-issues.md*
29+
30+
<!-- AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY -->
31+
<!-- Source: bitsoex/ai-code-instructions → java/rules/java-flyway-migrations-safety-issues.md -->
32+
<!-- To modify, edit the source file and run the distribution workflow -->

0 commit comments

Comments
 (0)