heimdall-agent 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +443 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +71 -34
  5. package/agents/database-architect.md +31 -25
  6. package/agents/frontend-designer.md +30 -28
  7. package/agents/mobile-designer.md +25 -24
  8. package/agents/modernizer.md +68 -0
  9. package/agents/orchestrator.md +107 -93
  10. package/agents/reviewer.md +102 -71
  11. package/agents/security-auditor.md +27 -27
  12. package/agents/tester.md +97 -90
  13. package/commands/grill-me.md +20 -4
  14. package/commands/orchestrate.md +16 -0
  15. package/commands/orchestrator.md +16 -0
  16. package/commands/plan.md +17 -1
  17. package/config/agents.json +31 -3
  18. package/config/mcp.json +72 -0
  19. package/config/models.json +26 -16
  20. package/config/profiles.json +2 -4
  21. package/config/skills.json +762 -573
  22. package/docs/SKILLS.md +393 -275
  23. package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
  24. package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
  25. package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
  26. package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
  27. package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -0
  28. package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
  29. package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
  30. package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
  31. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  32. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  33. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  34. package/docs/runs/skill-audit/customization-report.json +380 -0
  35. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  36. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  37. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  38. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  39. package/docs/runs/skill-audit/inventory.json +308 -0
  40. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  41. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  42. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  43. package/docs/runs/skill-audit/probe.ps1 +16 -0
  44. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  45. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  46. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  47. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  50. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  51. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  52. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  53. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  54. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  55. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  56. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  57. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  58. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  59. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  60. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  61. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  62. package/docs/runs/skill-audit/update-manifest.md +88 -0
  63. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  64. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  65. package/docs/runs/skill-audit/upstream-status.json +563 -0
  66. package/docs/runs/skill-audit/verification-results.json +252 -0
  67. package/doctrine/AGENTS.md +42 -77
  68. package/hooks/git/pre-commit +11 -0
  69. package/hooks/heimdall-hook.cjs +81 -2
  70. package/hooks/herdr-agent-state.ps1 +55 -0
  71. package/hooks/hooks.json +0 -11
  72. package/lib/catalog-sync.cjs +167 -0
  73. package/lib/hermes-context.cjs +57 -0
  74. package/lib/model-context.cjs +123 -0
  75. package/lib/path-discovery.cjs +94 -0
  76. package/package.json +7 -3
  77. package/playbooks/01-interactive-grilling-gate.md +23 -6
  78. package/playbooks/02-fast-code-deep-verification.md +3 -2
  79. package/playbooks/03-adversarial-code-review.md +15 -7
  80. package/playbooks/05-canonical-plan-template.md +35 -19
  81. package/playbooks/06-model-registry-matrix.md +24 -13
  82. package/playbooks/07-legacy-code-modernization.md +74 -0
  83. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  84. package/setup.mjs +592 -172
  85. package/skills/antislop/SKILL.md +76 -56
  86. package/skills/antislop/VERSION +1 -0
  87. package/skills/antislop-copywriting/SKILL.md +407 -372
  88. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  89. package/skills/antislop-human/SKILL.md +204 -147
  90. package/skills/antislop-human/contrast-check.py +168 -165
  91. package/skills/antislop-human/contrast-mcp.py +6 -3
  92. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  93. package/skills/antislop-human/references/WCAG.md +127 -0
  94. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  95. package/skills/antislop-ui/SKILL.md +344 -304
  96. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  97. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  98. package/skills/brainstorming/SKILL.md +296 -265
  99. package/skills/brainstorming/builder-check-prompt.md +23 -0
  100. package/skills/brainstorming/scripts/frame-template.html +213 -213
  101. package/skills/brainstorming/scripts/server.cjs +723 -723
  102. package/skills/brandkit/SKILL.md +798 -798
  103. package/skills/brutalist-skill/SKILL.md +93 -92
  104. package/skills/caveman/README.md +68 -0
  105. package/skills/caveman/SKILL.md +73 -38
  106. package/skills/claude-collaborator/SKILL.md +24 -44
  107. package/skills/clean-code/SKILL.md +152 -0
  108. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  109. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  110. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  111. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  112. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  113. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  114. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  115. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  116. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  117. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  118. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  119. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  120. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  121. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  122. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  123. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  124. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  125. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  126. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  127. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  128. package/skills/codebase-design/DEEPENING.md +37 -0
  129. package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  130. package/skills/codebase-design/SKILL.md +114 -0
  131. package/skills/codex-collaborator/SKILL.md +24 -45
  132. package/skills/communication-doctrine/SKILL.md +89 -0
  133. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  134. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  135. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  136. package/skills/domain-modeling/ADR-FORMAT.md +47 -0
  137. package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
  138. package/skills/domain-modeling/SKILL.md +74 -0
  139. package/skills/executing-plans/SKILL.md +6 -56
  140. package/skills/executing-plans/scripts/task-done +52 -52
  141. package/skills/executing-plans/scripts/task-start +28 -28
  142. package/skills/gemini-collaborator/SKILL.md +24 -56
  143. package/skills/grill-me/SKILL.md +65 -0
  144. package/skills/handoff/SKILL.md +64 -0
  145. package/skills/herdr/SKILL.md +243 -0
  146. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  147. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  148. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  149. package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  150. package/skills/improve-codebase-architecture/SKILL.md +71 -0
  151. package/skills/karpathy-guidelines/SKILL.md +67 -67
  152. package/skills/mcp-engineering/SKILL.md +74 -0
  153. package/skills/minimalist-skill/SKILL.md +87 -85
  154. package/skills/output-skill/SKILL.md +49 -49
  155. package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
  156. package/skills/owasp-security/reference/languages.md +378 -372
  157. package/skills/owasp-security/reference/owasp-report.md +1144 -1140
  158. package/skills/owasp-security/reference/review-checklist.md +134 -132
  159. package/skills/ponytail/SKILL.md +36 -52
  160. package/skills/postgres-best-practices/SKILL.md +30 -52
  161. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  162. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  163. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  164. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  165. package/skills/postgres-best-practices/references/indexing.md +318 -0
  166. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  167. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  168. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  169. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  170. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  171. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  172. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  173. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  174. package/skills/progressive-disclosure/SKILL.md +68 -0
  175. package/skills/pstack-discipline/SKILL.md +40 -0
  176. package/skills/receiving-code-review/SKILL.md +2 -23
  177. package/skills/requesting-code-review/SKILL.md +7 -36
  178. package/skills/soft-skill/SKILL.md +99 -98
  179. package/skills/stitch-skill/DESIGN.md +121 -121
  180. package/skills/stitch-skill/SKILL.md +185 -184
  181. package/skills/strix-security/SKILL.md +54 -53
  182. package/skills/subagent-driven-development/SKILL.md +35 -264
  183. package/skills/subagent-driven-development/references/batching.md +11 -0
  184. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  185. package/skills/subagent-driven-development/references/final-review.md +47 -0
  186. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  187. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  188. package/skills/subagent-driven-development/references/preflight.md +26 -0
  189. package/skills/subagent-driven-development/references/resuming.md +12 -0
  190. package/skills/subagent-driven-development/scripts/review-package +53 -53
  191. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  192. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  193. package/skills/systematic-debugging/SKILL.md +283 -306
  194. package/skills/taste-skill/SKILL.md +542 -1206
  195. package/skills/taste-skill/references/app-screens.md +1199 -0
  196. package/skills/taste-skill/references/colour.md +141 -0
  197. package/skills/taste-skill/references/copy.md +177 -0
  198. package/skills/taste-skill/references/critique.md +182 -0
  199. package/skills/taste-skill/references/imagery.md +791 -0
  200. package/skills/taste-skill/references/layout.md +292 -0
  201. package/skills/taste-skill/references/motion.md +980 -0
  202. package/skills/taste-skill/references/research.md +356 -0
  203. package/skills/taste-skill/references/scenes.md +174 -0
  204. package/skills/taste-skill/references/tells.md +115 -0
  205. package/skills/taste-skill/references/type.md +170 -0
  206. package/skills/test-driven-development/SKILL.md +330 -337
  207. package/skills/thermo/SKILL.md +67 -0
  208. package/skills/threat-modeling/SKILL.md +55 -0
  209. package/skills/to-spec/SKILL.md +75 -0
  210. package/skills/to-tickets/SKILL.md +105 -0
  211. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  212. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  213. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  214. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  215. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  216. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  217. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  218. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  219. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  220. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  221. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  222. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  223. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  224. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  225. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  226. package/skills/verification-before-completion/SKILL.md +0 -14
  227. package/skills/wayfinder/SKILL.md +128 -0
  228. package/skills/writing-plans/SKILL.md +11 -15
  229. package/skills/writing-skills/SKILL.md +21 -303
  230. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  231. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  232. package/skills/writing-skills/references/bulletproofing.md +80 -0
  233. package/skills/writing-skills/references/discovery.md +201 -0
  234. package/skills/writing-skills/references/flowcharts.md +37 -0
  235. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  236. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  237. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  238. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  239. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  240. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  241. package/skills/gpt-tasteskill/SKILL.md +0 -74
  242. package/skills/taste-skill-v1/SKILL.md +0 -226
  243. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  244. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  245. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  246. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  247. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  248. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  249. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  250. /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
@@ -1,132 +1,134 @@
1
- # Security Review Checklist
2
-
3
- Coverage list for step 3 of the review workflow in `SKILL.md`. Skip sections the change does not
4
- touch. A checked-off gap is a lead to trace, not a finding: run it through the triage rubric in
5
- `SKILL.md` before reporting it.
6
-
7
- ## Contents
8
- - Input Handling (A05)
9
- - Authentication & Sessions (A07)
10
- - Access Control (A01)
11
- - Server-Side Request Forgery (A01)
12
- - File Handling (A01)
13
- - Insecure Design (A06)
14
- - Configuration & Hardening (A02)
15
- - Dependencies & Supply Chain (A03)
16
- - Serialization & Data Integrity (A08)
17
- - Data Protection (A04)
18
- - Error Handling & Logging (A09/A10)
19
- - LLM and Agent Features (LLM Top 10 2026, Agentic 2026)
20
-
21
- ## Input Handling (A05)
22
- - [ ] All user input validated server-side
23
- - [ ] Using parameterized queries (not string concatenation)
24
- - [ ] Input length limits enforced
25
- - [ ] Allowlist validation preferred over denylist
26
- - [ ] Output encoded for its context: HTML body, attribute, URL, JS, CSS are different rules
27
- - [ ] No raw HTML sinks fed by user data (`innerHTML`, `dangerouslySetInnerHTML`, `|safe`, `v-html`)
28
- - [ ] OS commands invoked with an argv array, never a shell string
29
- - [ ] XML parsers configured with external entity resolution disabled (XXE, filed under A02 in 2025)
30
- - [ ] Templates never built from user input (SSTI)
31
-
32
- ## Authentication & Sessions (A07)
33
- - [ ] Passwords hashed with Argon2/bcrypt (not MD5/SHA1)
34
- - [ ] Session tokens have sufficient entropy (128+ bits)
35
- - [ ] New session token issued on login (no session fixation)
36
- - [ ] Sessions invalidated on logout, password change, and account disable
37
- - [ ] Cookies set `HttpOnly`, `Secure`, and `SameSite=Lax` or stricter
38
- - [ ] MFA available for sensitive operations
39
- - [ ] JWTs: algorithm pinned server-side (`alg: none` and algorithm confusion rejected),
40
- signature verified, `exp`/`aud`/`iss` checked
41
-
42
- ## Access Control (A01)
43
- - [ ] Authorization checked on every request
44
- - [ ] Using object references user cannot manipulate
45
- - [ ] Deny by default policy
46
- - [ ] Privilege escalation paths reviewed
47
- - [ ] Object-level checks verify ownership/tenancy, not just "is authenticated" (IDOR/BOLA)
48
- - [ ] State-changing requests protected against CSRF (token or `SameSite` + origin check)
49
- - [ ] Redirect targets validated against an allowlist (no open redirect)
50
- - [ ] CORS: no `Access-Control-Allow-Origin: *` combined with credentials, no origin reflection
51
-
52
- ## Server-Side Request Forgery (A01)
53
- - [ ] User-supplied URLs resolved and validated against an allowlist of hosts/schemes
54
- - [ ] Private, loopback, and link-local ranges blocked, including after DNS resolution
55
- - [ ] Redirects not followed blindly to a new host (re-validate each hop)
56
- - [ ] Cloud metadata endpoints (`169.254.169.254`) unreachable from the app
57
-
58
- ## File Handling (A01)
59
- - [ ] Upload type validated by content, not just extension or `Content-Type`
60
- - [ ] Uploads stored outside the web root, served with a non-executable content type
61
- - [ ] File size limits and quota enforced
62
- - [ ] Paths built from user input canonicalized and confined to a base directory (no `../`)
63
- - [ ] Archive extraction guards against path traversal and zip bombs
64
-
65
- ## Insecure Design (A06)
66
- - [ ] Prices, quantities, roles, and state transitions decided server-side, never taken from the client
67
- - [ ] Rate limits on login, password reset, OTP, signup, and expensive operations
68
- - [ ] Multi-step flows can't be skipped, reordered, or replayed (one-time tokens, idempotency keys)
69
- - [ ] Balance, inventory, and coupon updates are atomic (no check-then-write race)
70
-
71
- ## Configuration & Hardening (A02)
72
- - [ ] Debug mode, verbose errors, and dev tooling disabled in production
73
- - [ ] Default credentials and sample/admin accounts removed
74
- - [ ] Unused features, ports, endpoints, and HTTP methods disabled
75
- - [ ] Security headers set: CSP without `unsafe-inline`/`unsafe-eval`, HSTS,
76
- `X-Content-Type-Options: nosniff`, `Referrer-Policy`
77
- - [ ] Cloud storage and object buckets are not publicly readable/writable
78
- - [ ] Container/infra config reviewed (non-root user, no privileged mode, no secrets in image layers)
79
-
80
- ## Dependencies & Supply Chain (A03)
81
- - [ ] Lockfile committed and versions pinned (no floating ranges in production builds)
82
- - [ ] Dependencies scanned for known vulnerabilities and unmaintained packages
83
- - [ ] Package names checked against typosquats and dependency confusion (internal names claimed publicly)
84
- - [ ] Third-party scripts loaded with Subresource Integrity, or self-hosted
85
- - [ ] Build and CI scripts reviewed: install hooks and pipeline steps run with repo write access
86
- - [ ] Artifacts and releases signed; signatures verified before deploy
87
-
88
- ## Serialization & Data Integrity (A08)
89
- - [ ] No deserialization of untrusted data with a native format (`pickle`, `Marshal`,
90
- `ObjectInputStream`, `BinaryFormatter`, `yaml.load`)
91
- - [ ] JSON/schema-validated formats used instead, with a type allowlist
92
- - [ ] Auto-update and plugin loading verify signatures before execution
93
-
94
- ## Data Protection (A04)
95
- - [ ] Sensitive data encrypted at rest
96
- - [ ] TLS for all data in transit
97
- - [ ] No sensitive data in URLs/logs
98
- - [ ] Secrets in environment/vault (not code), and not in git history or container layers
99
- - [ ] Authenticated encryption (AES-GCM/ChaCha20-Poly1305); no ECB, no unauthenticated CBC
100
- - [ ] IVs/nonces unique per encryption; randomness from a CSPRNG, not `Math.random`/`rand()`
101
- - [ ] Secrets and tokens compared in constant time
102
-
103
- ## Error Handling & Logging (A09/A10)
104
- - [ ] No stack traces exposed to users
105
- - [ ] Fail-closed on errors (deny, not allow)
106
- - [ ] All exceptions logged with context
107
- - [ ] Consistent error responses (no user/account enumeration via message or timing)
108
- - [ ] Auth events, authorization failures, and security-control failures logged
109
- - [ ] Logs exclude credentials, tokens, and PII; user input encoded to prevent log injection
110
- - [ ] Empty `catch` blocks and swallowed errors reviewed: silent failure hides attacks
111
-
112
- ## LLM and Agent Features (LLM Top 10 2026, Agentic 2026)
113
- - [ ] Untrusted text (user input, web pages, email, RAG chunks, tool output) can't steer a model
114
- that holds privileged tools (LLM01, ASI01)
115
- - [ ] Model output validated or escaped before any SQL, shell, HTML, code, or tool argument (LLM10)
116
- - [ ] Tools minimal and scoped; no general shell or HTTP tool unless required; destructive
117
- actions need human approval (LLM03, ASI02)
118
- - [ ] Agent credentials short-lived and scoped to the task, never an admin or the user's full session (ASI03)
119
- - [ ] Retrieval enforces the caller's tenant and permissions at query time (LLM02, LLM09)
120
- - [ ] No secrets or authorization logic in the system prompt, tool schemas, or other hidden context (LLM08)
121
- - [ ] MCP servers, plugins, and models pinned and from trusted sources (LLM04, ASI04)
122
- - [ ] Generated code runs in a sandbox (ASI05)
123
- - [ ] Writes to agent memory or the vector store validated, so untrusted content can't persist
124
- instructions (ASI06)
125
- - [ ] Per-user caps on requests, tokens, tool calls, and cost, plus hard timeouts (LLM06)
126
- - [ ] Messages between agents authenticated and integrity-checked; a receiving agent doesn't
127
- trust the sender's claims about identity or authority (ASI07)
128
- - [ ] One agent's failure or bad output can't cascade: step, retry, and fan-out limits, plus
129
- circuit breakers between components (ASI08)
130
- - [ ] AI-generated content labelled; approval prompts show the real action, so an agent can't
131
- talk a user into approving something else (ASI09)
132
- - [ ] Tool calls logged, with a way to stop a running agent (ASI10)
1
+ # Security Review Checklist
2
+
3
+ Coverage list for step 3 of the review workflow in `SKILL.md`. Skip sections the change does not
4
+ touch. A checked-off gap is a lead to trace, not a finding: run it through the triage rubric in
5
+ `SKILL.md` before reporting it.
6
+
7
+ ## Contents
8
+ - Input Handling (A05)
9
+ - Authentication & Sessions (A07)
10
+ - Access Control (A01)
11
+ - Server-Side Request Forgery (A01)
12
+ - File Handling (A01)
13
+ - Insecure Design (A06)
14
+ - Configuration & Hardening (A02)
15
+ - Dependencies & Supply Chain (A03)
16
+ - Serialization & Data Integrity (A08)
17
+ - Data Protection (A04)
18
+ - Error Handling & Logging (A09/A10)
19
+ - LLM and Agent Features (LLM Top 10 2026, Agentic 2026)
20
+
21
+ ## Input Handling (A05)
22
+ - [ ] All user input validated server-side
23
+ - [ ] Using parameterized queries (not string concatenation)
24
+ - [ ] Input length limits enforced
25
+ - [ ] Allowlist validation preferred over denylist
26
+ - [ ] Output encoded for its context: HTML body, attribute, URL, JS, CSS are different rules
27
+ - [ ] No raw HTML sinks fed by user data (`innerHTML`, `dangerouslySetInnerHTML`, `|safe`, `v-html`)
28
+ - [ ] OS commands invoked with an argv array, never a shell string
29
+ - [ ] XML parsers configured with external entity resolution disabled (XXE, filed under A02 in 2025)
30
+ - [ ] Templates never built from user input (SSTI)
31
+
32
+ ## Authentication & Sessions (A07)
33
+ - [ ] Passwords hashed with Argon2/bcrypt (not MD5/SHA1)
34
+ - [ ] Session tokens have sufficient entropy (128+ bits)
35
+ - [ ] New session token issued on login (no session fixation)
36
+ - [ ] Sessions invalidated on logout, password change, and account disable
37
+ - [ ] Cookies set `HttpOnly`, `Secure`, and `SameSite=Lax` or stricter
38
+ - [ ] MFA available for sensitive operations
39
+ - [ ] JWTs: algorithm pinned server-side (`alg: none` and algorithm confusion rejected),
40
+ signature verified, `exp`/`aud`/`iss` checked
41
+
42
+ ## Access Control (A01)
43
+ - [ ] Authorization checked on every request
44
+ - [ ] Using object references user cannot manipulate
45
+ - [ ] Deny by default policy
46
+ - [ ] Privilege escalation paths reviewed
47
+ - [ ] Object-level checks verify ownership/tenancy, not just "is authenticated" (IDOR/BOLA)
48
+ - [ ] State-changing requests protected against CSRF (token or `SameSite` + origin check)
49
+ - [ ] Redirect targets validated against an allowlist (no open redirect)
50
+ - [ ] CORS: no `Access-Control-Allow-Origin: *` combined with credentials, no origin reflection
51
+
52
+ ## Server-Side Request Forgery (A01)
53
+ - [ ] User-supplied URLs resolved and validated against an allowlist of hosts/schemes
54
+ - [ ] Private, loopback, and link-local ranges blocked, including after DNS resolution
55
+ - [ ] The connection goes to the IP that was validated: pin it, or validate inside a custom dialer
56
+ or agent at connect time. Resolve, check, then fetch by hostname is open to DNS rebinding
57
+ - [ ] Redirects not followed blindly to a new host (re-validate each hop)
58
+ - [ ] Cloud metadata endpoints (`169.254.169.254`) unreachable from the app
59
+
60
+ ## File Handling (A01)
61
+ - [ ] Upload type validated by content, not just extension or `Content-Type`
62
+ - [ ] Uploads stored outside the web root, served with a non-executable content type
63
+ - [ ] File size limits and quota enforced
64
+ - [ ] Paths built from user input canonicalized and confined to a base directory (no `../`)
65
+ - [ ] Archive extraction guards against path traversal and zip bombs
66
+
67
+ ## Insecure Design (A06)
68
+ - [ ] Prices, quantities, roles, and state transitions decided server-side, never taken from the client
69
+ - [ ] Rate limits on login, password reset, OTP, signup, and expensive operations
70
+ - [ ] Multi-step flows can't be skipped, reordered, or replayed (one-time tokens, idempotency keys)
71
+ - [ ] Balance, inventory, and coupon updates are atomic (no check-then-write race)
72
+
73
+ ## Configuration & Hardening (A02)
74
+ - [ ] Debug mode, verbose errors, and dev tooling disabled in production
75
+ - [ ] Default credentials and sample/admin accounts removed
76
+ - [ ] Unused features, ports, endpoints, and HTTP methods disabled
77
+ - [ ] Security headers set: CSP without `unsafe-inline`/`unsafe-eval`, HSTS,
78
+ `X-Content-Type-Options: nosniff`, `Referrer-Policy`
79
+ - [ ] Cloud storage and object buckets are not publicly readable/writable
80
+ - [ ] Container/infra config reviewed (non-root user, no privileged mode, no secrets in image layers)
81
+
82
+ ## Dependencies & Supply Chain (A03)
83
+ - [ ] Lockfile committed and versions pinned (no floating ranges in production builds)
84
+ - [ ] Dependencies scanned for known vulnerabilities and unmaintained packages
85
+ - [ ] Package names checked against typosquats and dependency confusion (internal names claimed publicly)
86
+ - [ ] Third-party scripts loaded with Subresource Integrity, or self-hosted
87
+ - [ ] Build and CI scripts reviewed: install hooks and pipeline steps run with repo write access
88
+ - [ ] Artifacts and releases signed; signatures verified before deploy
89
+
90
+ ## Serialization & Data Integrity (A08)
91
+ - [ ] No deserialization of untrusted data with a native format (`pickle`, `Marshal`,
92
+ `ObjectInputStream`, `BinaryFormatter`, `yaml.load`)
93
+ - [ ] JSON/schema-validated formats used instead, with a type allowlist
94
+ - [ ] Auto-update and plugin loading verify signatures before execution
95
+
96
+ ## Data Protection (A04)
97
+ - [ ] Sensitive data encrypted at rest
98
+ - [ ] TLS for all data in transit
99
+ - [ ] No sensitive data in URLs/logs
100
+ - [ ] Secrets in environment/vault (not code), and not in git history or container layers
101
+ - [ ] Authenticated encryption (AES-GCM/ChaCha20-Poly1305); no ECB, no unauthenticated CBC
102
+ - [ ] IVs/nonces unique per encryption; randomness from a CSPRNG, not `Math.random`/`rand()`
103
+ - [ ] Secrets and tokens compared in constant time
104
+
105
+ ## Error Handling & Logging (A09/A10)
106
+ - [ ] No stack traces exposed to users
107
+ - [ ] Fail-closed on errors (deny, not allow)
108
+ - [ ] All exceptions logged with context
109
+ - [ ] Consistent error responses (no user/account enumeration via message or timing)
110
+ - [ ] Auth events, authorization failures, and security-control failures logged
111
+ - [ ] Logs exclude credentials, tokens, and PII; user input encoded to prevent log injection
112
+ - [ ] Empty `catch` blocks and swallowed errors reviewed: silent failure hides attacks
113
+
114
+ ## LLM and Agent Features (LLM Top 10 2026, Agentic 2026)
115
+ - [ ] Untrusted text (user input, web pages, email, RAG chunks, tool output) can't steer a model
116
+ that holds privileged tools (LLM01, ASI01)
117
+ - [ ] Model output validated or escaped before any SQL, shell, HTML, code, or tool argument (LLM10)
118
+ - [ ] Tools minimal and scoped; no general shell or HTTP tool unless required; destructive
119
+ actions need human approval (LLM03, ASI02)
120
+ - [ ] Agent credentials short-lived and scoped to the task, never an admin or the user's full session (ASI03)
121
+ - [ ] Retrieval enforces the caller's tenant and permissions at query time (LLM02, LLM09)
122
+ - [ ] No secrets or authorization logic in the system prompt, tool schemas, or other hidden context (LLM08)
123
+ - [ ] MCP servers, plugins, and models pinned and from trusted sources (LLM04, ASI04)
124
+ - [ ] Generated code runs in a sandbox (ASI05)
125
+ - [ ] Writes to agent memory or the vector store validated, so untrusted content can't persist
126
+ instructions (ASI06)
127
+ - [ ] Per-user caps on requests, tokens, tool calls, and cost, plus hard timeouts (LLM06)
128
+ - [ ] Messages between agents authenticated and integrity-checked; a receiving agent doesn't
129
+ trust the sender's claims about identity or authority (ASI07)
130
+ - [ ] One agent's failure or bad output can't cascade: step, retry, and fan-out limits, plus
131
+ circuit breakers between components (ASI08)
132
+ - [ ] AI-generated content labelled; approval prompts show the real action, so an agent can't
133
+ talk a user into approving something else (ASI09)
134
+ - [ ] Tool calls logged, with a way to stop a running agent (ASI10)
@@ -1,68 +1,52 @@
1
1
  ---
2
2
  name: ponytail
3
3
  description: >
4
- Forces AI coding agents to think like a pragmatic, lazy senior developer. Enforces the
5
- Decision Ladder: YAGNI checks, codebase reuse, standard library first, native platform features,
6
- and zero premature abstractions while strictly preserving security and error handling.
7
- upstream: https://github.com/DietrichGebert/ponytail
8
- version: 1.0.0
4
+ Lazy senior dev mode: the smallest change that fully solves the task, and a
5
+ reply a busy human understands in one read. Use on any coding task (writing,
6
+ fixing, refactoring, reviewing, choosing dependencies) and when the user says
7
+ "ponytail", "be lazy", "simplest solution", "yagni", or complains about
8
+ over-engineering or bloat. Levels: lite, full (default), ultra.
9
+ argument-hint: "[lite|full|ultra|off]"
10
+ license: MIT
9
11
  ---
10
12
 
11
- # Ponytail — The Pragmatic Senior Developer Skill
13
+ # Ponytail
12
14
 
13
- You are operating under the **Ponytail** engineering discipline. Your mandate is to combat AI over-engineering, eliminate speculative bloat, and write the absolute minimum code necessary to solve the problem cleanly.
15
+ You are a lazy senior developer. The best code is the code never written. You solve the whole problem with the least new code. End your reply with one or two lines: what you skipped or did not check, and any risk the user must know.
14
16
 
15
- > *"Think like the laziest senior developer in the room. If you can solve it without writing code, do that. If you must write code, stop at the simplest rung that works."*
17
+ Active for the whole session until the user says "stop ponytail" or "normal mode". Switch level: `/ponytail lite|full|ultra`.
16
18
 
17
- ---
18
-
19
- ## 1. The Decision Ladder
19
+ ## Before you write
20
20
 
21
- Before writing a single line of new implementation code, climb down this sequential ladder. **Stop at the very first rung that solves the requirement:**
21
+ Read the task and the code it touches. List every place your change must reach: callers, tests, fixtures, config, exports. Check what your change could break for users: data it would destroy or expose, callers that stop working. That is scope. Extra features are not.
22
22
 
23
- 1. **Does this need to exist at all? (YAGNI)**
24
- - Reject unrequested features, premature config toggles, speculative plugin architectures, and "just-in-case" parameter options.
25
- - If the requirement does not explicitly ask for it, do not build it.
26
- 2. **Does it already exist in this codebase? (Research & Reuse First)**
27
- - Search the repository before creating a new utility, helper, type, or component.
28
- - Check standard library primitives (`crypto`, `fs`, `path`, `fetch`, `URL`, `Intl`) and installed dependencies before writing custom code.
29
- - Reuse existing functions and established patterns. Do not create parallel abstractions or reinvent the wheel.
30
- 3. **Can the standard library do it? (Built-in first)**
31
- - Prioritize Node.js/browser built-in modules (`crypto`, `fs`, `path`, `fetch`, `URL`, `Intl`) before installing third-party libraries.
32
- 4. **Is there a native platform feature for it? (Platform primitives)**
33
- - Use semantic HTML and native browser capabilities (e.g. `<input type="date">`, `<dialog>`, CSS flex/grid, CSS `:has()`) instead of installing heavy UI packages or state wrappers.
34
- 5. **Does an already-installed dependency solve it?**
35
- - Check `package.json` for existing tools before proposing new dependencies.
36
- 6. **Can it be written in one line?**
37
- - Prefer concise standard idioms over 30-line boilerplate wrappers.
38
- 7. **Only then: Write the minimum custom code that works.**
39
- - Simple, readable, surgical, and clear.
23
+ ## The smallest complete change
40
24
 
41
- ---
25
+ Take the first option that fully works:
42
26
 
43
- ## 2. Lazy vs. Negligent (Non-Negotiable Guardrails)
27
+ 1. Does it need to exist? Skip features, options and flexibility nobody asked for, and name them in one line. A vague request ("build me X") gets the smallest version that does the core job.
28
+ 2. Already in this codebase (a helper, component, service, pattern)? Use it the way the surrounding code does.
29
+ 3. Standard library or a platform feature? Use it, unless the project has its own. A house component beats a native widget.
30
+ 4. An installed dependency? Use it. Never add a dependency for a few lines.
31
+ 5. Can it be one line a reader gets at a glance? One line.
32
+ 6. Otherwise: the minimum code that works.
44
33
 
45
- Being "lazy" applies **only to code generation and speculative architecture**. It **never** applies to correctness, reliability, or safety.
34
+ - Be lazy about the solution, never about the change itself: finish every part the task needs, including the callers, tests and fixtures your change breaks.
35
+ - No abstraction, wrapper, type conversion, option, config, boilerplate or "for later" code nobody asked for. Keep values in the form the platform already gives you. Deletion beats addition. Keep the structure the codebase already has: its layers, interfaces and conventions.
36
+ - The shortest working diff wins, once you know everything it must touch. A one-liner that needs decoding is not short.
37
+ - Comment only the why the code cannot show, in one line.
38
+ - Bug fix: before you edit, grep every caller of the function you touch, then fix the root cause once in the shared code.
39
+ - Code you move or merge keeps its error handling and validation.
40
+ - Between options of equal size, take the one that is correct on edge cases.
41
+ - Lazy code without its check is unfinished: new non-trivial logic (a branch, a loop, a parser, money or security, or a whole new script or app) leaves one small test or an assert-based self-check. Trivial changes need none.
42
+ - A shortcut with a known limit gets a code comment in this form: `shortcut: <the limit>, <when to upgrade>`.
46
43
 
47
- You must **never** skip:
48
- - **Trust Boundaries & Input Validation**: Always validate external inputs, API parameters, and environment data.
49
- - **Security & Permissions**: Never bypass authentication, authorization, or sanitize checks.
50
- - **Data-Loss Prevention**: Never execute destructive operations without verified safety gates.
51
- - **Error Handling**: Never catch and swallow exceptions with empty handlers. Handle failures gracefully.
52
- - **Accessibility & Contrast**: Never sacrifice semantic structure or visual usability.
53
-
54
- ---
55
-
56
- ## 3. Intensity Levels
57
-
58
- - **Lite**: Polite nudge to question unnecessary dependencies and prefer standard library methods.
59
- - **Full (Default)**: Strictly halts at the first rung of the Decision Ladder that solves the problem.
60
- - **Ultra**: Ruthlessly strips all boilerplate, rejects any wrapper that only has one callsite, and deletes dead code on sight.
61
-
62
- ---
44
+ Never cut: validation at trust boundaries, error handling that prevents data loss, security, accessibility, the calibration real hardware needs, anything the user asked for.
63
45
 
64
- ## Upstream Provenance & Governance Protocol
46
+ ## Levels
65
47
 
66
- - **Source Repository**: [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail)
67
- - **Update Directive**:
68
- > *Update the selected skill or plugin through its supported mechanism. Review changed instructions/references and repeat a bounded review after material updates. Record source revision, reviewed range, actual tests and remaining validation in the private report.*
48
+ | Level | Behavior |
49
+ |-------|----------|
50
+ | **lite** | Build what was asked. Name the smaller option in one line and let the user pick. |
51
+ | **full** | The rules above. Default. |
52
+ | **ultra** | Also question the request: before building, push back on any part the need does not justify. |
@@ -1,64 +1,42 @@
1
1
  ---
2
- name: supabase-postgres-best-practices
3
- description: "Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pg_cron, pgmq), vector/semantic search (pgvector), and restoring dumps (pg_restore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query."
4
- license: MIT
5
- metadata:
6
- author: supabase
7
- version: "1.1.1"
8
- organization: Supabase
9
- date: January 2026
10
- abstract: Comprehensive Postgres performance optimization guide for developers using Supabase and Postgres. Contains performance rules across 8 categories, prioritized by impact from critical (query performance, connection management) to incremental (advanced features). Each rule includes detailed explanations, incorrect vs. correct SQL examples, query plan analysis, and specific performance metrics to guide automated optimization and code generation.
2
+ name: postgres-best-practices
3
+ description: Best practices and guidelines for working with Postgres. Covers schema design, indexing strategies, query optimization, migrations, and common pitfalls. Use when writing SQL, designing database schemas, optimizing queries, or setting up a Postgres database.
11
4
  ---
12
5
 
13
- # Supabase Postgres Best Practices
6
+ # Postgres Best Practices
14
7
 
15
- Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.
8
+ Guidelines and best practices for working with Postgres, covering schema design, indexing, query optimization, and common pitfalls.
16
9
 
17
- ## When to Apply
10
+ ## Supported Versions
18
11
 
19
- Reference these guidelines when:
20
- - Writing SQL queries or designing schemas
21
- - Implementing indexes or query optimization
22
- - Reviewing database performance issues
23
- - Configuring connection pooling or scaling
24
- - Optimizing for Postgres-specific features
25
- - Working with Row-Level Security (RLS)
12
+ This skill covers PostgreSQL 14 through 18. Version-specific features are tagged (e.g., `[PG15+]`, `[PG18+]`); environment-dependent examples identify required privileges, extensions, or multi-node setup.
26
13
 
27
- ## Rule Categories by Priority
14
+ PostgreSQL provides 5 years of support per major version. Always run the latest minor release.
28
15
 
29
- | Priority | Category | Impact | Prefix |
30
- |----------|----------|--------|--------|
31
- | 1 | Query Performance | CRITICAL | `query-` |
32
- | 2 | Connection Management | CRITICAL | `conn-` |
33
- | 3 | Security & RLS | CRITICAL | `security-` |
34
- | 4 | Schema Design | HIGH | `schema-` |
35
- | 5 | Concurrency & Locking | MEDIUM-HIGH | `lock-` |
36
- | 6 | Data Access Patterns | MEDIUM | `data-` |
37
- | 7 | Monitoring & Diagnostics | LOW-MEDIUM | `monitor-` |
38
- | 8 | Advanced Features | LOW | `advanced-` |
16
+ | Version | Initial Release | End of Life |
17
+ | ------- | ------------------ | ------------------ |
18
+ | 18 | September 2025 | November 2030 |
19
+ | 17 | September 2024 | November 2029 |
20
+ | 16 | September 2023 | November 2028 |
21
+ | 15 | October 2022 | November 2027 |
22
+ | 14 | September 2021 | November 2026 |
39
23
 
40
- ## How to Use
41
-
42
- Read individual rule files for detailed explanations and SQL examples:
43
-
44
- ```
45
- references/query-missing-indexes.md
46
- references/query-partial-indexes.md
47
- references/_sections.md
48
- ```
49
-
50
- Each rule file contains:
51
- - Brief explanation of why it matters
52
- - Incorrect SQL example with explanation
53
- - Correct SQL example with explanation
54
- - Optional EXPLAIN output or metrics
55
- - Additional context and references
56
- - Supabase-specific notes (when applicable)
24
+ Source: [postgresql.org/support/versioning](https://www.postgresql.org/support/versioning/)
57
25
 
58
26
  ## References
59
27
 
60
- - https://www.postgresql.org/docs/current/
61
- - https://supabase.com/docs
62
- - https://wiki.postgresql.org/wiki/Performance_Optimization
63
- - https://supabase.com/docs/guides/database/overview
64
- - https://supabase.com/docs/guides/auth/row-level-security
28
+ | Area | Resource | When to Use |
29
+ | ----------------------- | --------------------------------------- | ------------------------------------------------------------------ |
30
+ | Schema Design | `references/schema-design.md` | Designing tables, choosing data types, normalizing, partitioning |
31
+ | Indexing | `references/indexing.md` | Choosing index types, composite indexes, partial/covering indexes |
32
+ | Query Optimization | `references/query-optimization.md` | Reading EXPLAIN ANALYZE, fixing bottlenecks, planner tuning |
33
+ | Query Patterns | `references/query-patterns.md` | CTEs, window functions, lateral joins, UPSERT, JSONB, anti-patterns|
34
+ | Performance Diagnostics | `references/performance-diagnostics.md` | pg_stat views, lock analysis, VACUUM, connection management |
35
+ | Logical Replication | `references/logical-replication.md` | Pub/sub replication, live migrations, CDC |
36
+ | Hot Standby | `references/hot-standby.md` | Streaming replication, read replicas, failover |
37
+ | Transaction Isolation | `references/transaction-isolation.md` | Isolation levels, lost updates, serialization failures, retry logic |
38
+ | Backup & Restore | `references/backup-restore.md` | pg_dump/pg_restore, pg_basebackup, PITR, recovery |
39
+ | Security & Roles | `references/security-roles.md` | Privileges, RLS, pg_hba.conf, authentication, SSL |
40
+ | Bulk Data Loading | `references/bulk-loading.md` | COPY patterns, ETL staging, optimizing large loads, batch ops |
41
+ | Connection Pooling | `references/connection-pooling.md` | PgBouncer config, pool modes, prepared statements, sizing |
42
+ | Major Version Upgrades | `references/major-version-upgrades.md` | pg_upgrade, logical replication migration, pre/post checklists |