CouncilEngine/WORKING_BEST_PRACTICES.json at main · Simultech369/CouncilEngine · 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
{
  "PRAC-FE-001": {
    "practice_id": "PRAC-FE-001",
    "category": "frontend_architecture",
    "title": "Next.js App Router Client Boundary Isolation",
    "guideline": "When using `next/dynamic` with `{ ssr: false }`, always place the dynamic import inside a file marked with `'use client'` to satisfy Turbopack/Next.js 16 requirements.",
    "effectiveness_score": 0.98,
    "last_verified": "2026-08-20"
  },
  "PRAC-FE-002": {
    "practice_id": "PRAC-FE-002",
    "category": "resource_lifecycle",
    "title": "DOM and AudioContext Cleanup",
    "guideline": "Always dispose AudioContext nodes, abort controllers, canvas render loops, and window event listeners in React `useEffect` cleanup return functions.",
    "effectiveness_score": 0.95,
    "last_verified": "2026-08-20"
  },
  "PRAC-TEST-001": {
    "practice_id": "PRAC-TEST-001",
    "category": "testing_hygiene",
    "title": "Multi-File Verification Gate Execution",
    "guideline": "Always run both the unit test runner (`vitest run` / `cargo test`) and the full production bundle build (`next build` / `vite build`) before submitting pull requests.",
    "effectiveness_score": 1.0,
    "last_verified": "2026-08-20"
  },
  "PRAC-OPS-001": {
    "practice_id": "PRAC-OPS-001",
    "category": "campaign_diversification",
    "title": "Poly-Work Rail Alternation",
    "guideline": "Spread PR submissions across independent payout rails (Polar Cash, GrantFox FWC26, Dual-Campaign VeriNode) to prevent getting blocked by individual campaign tier caps.",
    "effectiveness_score": 0.99,
    "last_verified": "2026-08-20"
  }
}