JustGoodPractices/registry/categories.json at main · gosuda/JustGoodPractices · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "AgentBestPracticeCategoryRegistry",
  "version": "1.0.0",
  "categories": [
    {
      "id": "testing_strategy",
      "name": "Testing Strategy & Reliability",
      "domain": "testing",
      "description": "Rules on test sizing, flakiness elimination, hermeticity, and test suite balance (SMURF / Pyramid).",
      "skill": "testing-practices",
      "trigger_contexts": ["writing_tests", "fixing_flaky_tests", "test_architecture"]
    },
    {
      "id": "test_doubles",
      "name": "Test Doubles (Mocks, Fakes, Stubs)",
      "domain": "testing",
      "description": "Rules on preferring real/fake implementations over interaction mocks, and maintaining test fidelity.",
      "skill": "testing-practices",
      "trigger_contexts": ["mocking", "unit_tests", "dependency_injection"]
    },
    {
      "id": "test_design",
      "name": "Test Design & Assertions",
      "domain": "testing",
      "description": "Rules for clear, robust, actionable, and focused test cases and narrow assertions.",
      "skill": "testing-practices",
      "trigger_contexts": ["writing_assertions", "test_refactoring", "test_naming"]
    },
    {
      "id": "control_flow",
      "name": "Control Flow & Readability",
      "domain": "code_health",
      "description": "Rules on reducing nesting, early returns, positive boolean logic, and eliminating redundant else blocks.",
      "skill": "code-health",
      "trigger_contexts": ["refactoring", "writing_logic", "code_review"]
    },
    {
      "id": "functions_and_data",
      "name": "Functions & Data Manipulation",
      "domain": "code_health",
      "description": "Rules on pure functions, functional core / imperative shell, single map lookup, and clear data flow.",
      "skill": "code-health",
      "trigger_contexts": ["function_design", "performance_optimization", "data_structures"]
    },
    {
      "id": "code_hygiene",
      "name": "Code Hygiene & Clarity",
      "domain": "code_health",
      "description": "Rules on self-explanatory code, minimal comments, safe defaults, exception handling, and dead code cleanup.",
      "skill": "code-health",
      "trigger_contexts": ["commenting", "error_handling", "cleanup"]
    },
    {
      "id": "interface_design",
      "name": "API & Interface Design",
      "domain": "architecture_and_design",
      "description": "Rules on making interfaces hard to misuse, separating collaborators from work data, and Demeter's law.",
      "skill": "api-design",
      "trigger_contexts": ["api_design", "interface_definition", "oop_design"]
    },
    {
      "id": "design_principles",
      "name": "Architectural Principles",
      "domain": "architecture_and_design",
      "description": "Rules on premature DRY avoidance, domain objects, dependency injection, and avoiding singletons.",
      "skill": "api-design",
      "trigger_contexts": ["module_architecture", "refactoring", "domain_modeling"]
    },
    {
      "id": "collaboration_and_reviews",
      "name": "Code Review & PR Hygiene",
      "domain": "collaboration",
      "description": "Rules on small PRs, respectful feedback, commit message context, and prefactoring.",
      "skill": "code-review",
      "trigger_contexts": ["code_review", "commit_creation", "pull_request"]
    },
    {
      "id": "tooling_and_scripts",
      "name": "Tooling, Linters & Shell Scripts",
      "domain": "tooling",
      "description": "Rules on small/simple shell scripts, deterministic linting, and coverage practices.",
      "skill": "code-health",
      "trigger_contexts": ["writing_scripts", "ci_cd", "linting"]
    }
  ]
}