juniors-best-practice

Files (28)

• AGENTS.md
• README.md
• SKILL.md
• metadata.json
• _sections.md · rules/
• _template.md · rules/
• assets-svg-files.md · rules/
• beginner-const-vs-let.md · rules/
• beginner-double-negation.md · rules/
• beginner-early-return.md · rules/
• beginner-nullish-vs-or.md · rules/
• beginner-unnecessary-destructuring.md · rules/
• beginner-uppercase-constants.md · rules/
• beginner-useless-return-arrow.md · rules/
• devtools-formatter-linter.md · rules/
• devtools-package-manager-lock.md · rules/
• devtools-sorting-imports.md · rules/
• git-commit-convention.md · rules/
• react-children-prop.md · rules/
• react-extends-component.md · rules/
• react-props-typing.md · rules/
• react-string-props.md · rules/
• rest-naming-openapi.md · rules/
• rest-scalability-abstractions.md · rules/
• styling-classnames-function.md · rules/
• styling-css-states.md · rules/
• typescript-alias-naming.md · rules/
• typescript-flat-translations.md · rules/

SKILL.md (first lines)

# Juniors Best Practice

Juniors-focused best practices for React and TypeScript projects. The rules are short, practical, and organized by scope to guide consistent code reviews, refactoring, and new feature work.

## When to Apply

Reference these guidelines when:

- Writing or reviewing React/TypeScript code for clarity and consistency
- Teaching junior developers or establishing baseline team conventions
- Refactoring code to align with simple, maintainable patterns
- Standardizing project-wide practices (imports, tooling, naming, commits)

## Rule Categories by Priority

| Priority | Category             | Impact     | Prefix        |
| -------- | -------------------- | ---------- | ------------- |
| 1        | Beginner Foundations | HIGH       | `beginner-`   |
| 2        | TypeScript           | MEDIUM     | `typescript-` |
| 3        | React                | MEDIUM     | `react-`      |
| 4        | Styling              | MEDIUM     | `styling-`    |
| 5        | Devtools             | MEDIUM     | `devtools-`   |
| 6        | Assets               | LOW-MEDIUM | `assets-`     |
| 7        | Git                  | LOW        | `git-`        |
| 8        | REST                 | MEDIUM     | `rest-`       |

## Quick Reference

### 1. Beginner Foundations (HIGH)

- `beginner-early-return` - Prefer early returns to reduce nesting
- `beginner-double-negation` - Avoid `!isNotX` patterns
- `beginner-unnecessary-destructuring` - Keep objects intact for clarity
- `beginner-const-vs-let` - Default to const
- `beginner-nullish-vs-or` - Use ?? for defaults
- `beginner-useless-return-arrow` - Remove redundant return
- `beginner-uppercase-constants` - Use UPPER_CASE only for stable constants

### 2. TypeScript (MEDIUM)

- `typescript-alias-naming` - Use safe path alias prefixes
- `typescript-flat-translations` - Prefer flat translation keys to reduce duplication

### 3. React (MEDIUM)

- `react-string-props` - Use string literals when possible
- `react-children-prop` - Use children for composition
- `react-extends-component` - Extend native element props
- `react-props-typing` - Keep props typing readable

### 4. Styling (MEDIUM)

- `styling-classnames-function` - Use clsx for conditional classes
- `styling-css-states` - Prefer CSS selectors for component states

### 5. Devtools (MEDIUM)

- `devtools-formatter-linter` - Use formatter and linter
- `devtools-sorting-imports` - Keep imports ordered and grouped
- `devtools-package-manager-lock` - Use a single package manager

### 6. Assets (LOW-MEDIUM)

- `assets-svg-files` - Use SVGs as components

### 7. Git (LOW)

- `git-commit-convention` - Use consistent commit conventions

### 8. REST (MEDIUM)

- `rest-scalability-abstractions` - Build REST layer around reusable transport abstractions
- `rest-naming-openapi` - Keep REST naming aligned with OpenAPI contracts

## How to Use

Read individual rule files for detailed explanations and examples:

```
rules/beginner-early-return.md
rules/react-props-typing.md
```

Each rule file contains:

- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references

## Full Compiled Document

For the complete guide with all rules expanded: `AGENTS.md`

From siberiacancode/agent-skills, MIT.

More from siberiacancode/agent-skills