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.
- package/README.md +57 -26
- package/README.pt-BR.md +443 -0
- package/agents/cloud-engineer.md +77 -0
- package/agents/code-sentinel.md +71 -34
- package/agents/database-architect.md +31 -25
- package/agents/frontend-designer.md +30 -28
- package/agents/mobile-designer.md +25 -24
- package/agents/modernizer.md +68 -0
- package/agents/orchestrator.md +107 -93
- package/agents/reviewer.md +102 -71
- package/agents/security-auditor.md +27 -27
- package/agents/tester.md +97 -90
- package/commands/grill-me.md +20 -4
- package/commands/orchestrate.md +16 -0
- package/commands/orchestrator.md +16 -0
- package/commands/plan.md +17 -1
- package/config/agents.json +31 -3
- package/config/mcp.json +72 -0
- package/config/models.json +26 -16
- package/config/profiles.json +2 -4
- package/config/skills.json +762 -573
- package/docs/SKILLS.md +393 -275
- package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
- package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
- package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
- package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
- package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -0
- package/docs/runs/skill-audit/2026-11-12-compare-report.json +1028 -0
- package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
- package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
- package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
- package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
- package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
- package/docs/runs/skill-audit/customization-report.json +380 -0
- package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
- package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
- package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
- package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
- package/docs/runs/skill-audit/inventory.json +308 -0
- package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
- package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
- package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
- package/docs/runs/skill-audit/probe.ps1 +16 -0
- package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
- package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
- package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
- package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
- package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
- package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
- package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
- package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
- package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
- package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
- package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
- package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
- package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
- package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
- package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
- package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
- package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
- package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
- package/docs/runs/skill-audit/update-manifest.md +88 -0
- package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
- package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
- package/docs/runs/skill-audit/upstream-status.json +563 -0
- package/docs/runs/skill-audit/verification-results.json +252 -0
- package/doctrine/AGENTS.md +42 -77
- package/hooks/git/pre-commit +11 -0
- package/hooks/heimdall-hook.cjs +81 -2
- package/hooks/herdr-agent-state.ps1 +55 -0
- package/hooks/hooks.json +0 -11
- package/lib/catalog-sync.cjs +167 -0
- package/lib/hermes-context.cjs +57 -0
- package/lib/model-context.cjs +123 -0
- package/lib/path-discovery.cjs +94 -0
- package/package.json +7 -3
- package/playbooks/01-interactive-grilling-gate.md +23 -6
- package/playbooks/02-fast-code-deep-verification.md +3 -2
- package/playbooks/03-adversarial-code-review.md +15 -7
- package/playbooks/05-canonical-plan-template.md +35 -19
- package/playbooks/06-model-registry-matrix.md +24 -13
- package/playbooks/07-legacy-code-modernization.md +74 -0
- package/playbooks/08-backlog-and-change-request-flow.md +122 -0
- package/setup.mjs +592 -172
- package/skills/antislop/SKILL.md +76 -56
- package/skills/antislop/VERSION +1 -0
- package/skills/antislop-copywriting/SKILL.md +407 -372
- package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
- package/skills/antislop-human/SKILL.md +204 -147
- package/skills/antislop-human/contrast-check.py +168 -165
- package/skills/antislop-human/contrast-mcp.py +6 -3
- package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
- package/skills/antislop-human/references/WCAG.md +127 -0
- package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
- package/skills/antislop-ui/SKILL.md +344 -304
- package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
- package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
- package/skills/brainstorming/SKILL.md +296 -265
- package/skills/brainstorming/builder-check-prompt.md +23 -0
- package/skills/brainstorming/scripts/frame-template.html +213 -213
- package/skills/brainstorming/scripts/server.cjs +723 -723
- package/skills/brandkit/SKILL.md +798 -798
- package/skills/brutalist-skill/SKILL.md +93 -92
- package/skills/caveman/README.md +68 -0
- package/skills/caveman/SKILL.md +73 -38
- package/skills/claude-collaborator/SKILL.md +24 -44
- package/skills/clean-code/SKILL.md +152 -0
- package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
- package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
- package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
- package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
- package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
- package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
- package/skills/cloudflare-security-audit/HUNTING.md +251 -251
- package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
- package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
- package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
- package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
- package/skills/cloudflare-security-audit/SKILL.md +192 -192
- package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
- package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
- package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
- package/skills/cloudflare-security-audit/report-schema.json +461 -461
- package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
- package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
- package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
- package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
- package/skills/codebase-design/DEEPENING.md +37 -0
- package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
- package/skills/codebase-design/SKILL.md +114 -0
- package/skills/codex-collaborator/SKILL.md +24 -45
- package/skills/communication-doctrine/SKILL.md +89 -0
- package/skills/diagnosing-superpowers/SKILL.md +1 -1
- package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
- package/skills/diagnosing-superpowers/templates/issue.md +23 -4
- package/skills/domain-modeling/ADR-FORMAT.md +47 -0
- package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
- package/skills/domain-modeling/SKILL.md +74 -0
- package/skills/executing-plans/SKILL.md +6 -56
- package/skills/executing-plans/scripts/task-done +52 -52
- package/skills/executing-plans/scripts/task-start +28 -28
- package/skills/gemini-collaborator/SKILL.md +24 -56
- package/skills/grill-me/SKILL.md +65 -0
- package/skills/handoff/SKILL.md +64 -0
- package/skills/herdr/SKILL.md +243 -0
- package/skills/image-to-code-skill/SKILL.md +1228 -1228
- package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
- package/skills/imagegen-frontend-web/SKILL.md +987 -987
- package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
- package/skills/improve-codebase-architecture/SKILL.md +71 -0
- package/skills/karpathy-guidelines/SKILL.md +67 -67
- package/skills/mcp-engineering/SKILL.md +74 -0
- package/skills/minimalist-skill/SKILL.md +87 -85
- package/skills/output-skill/SKILL.md +49 -49
- package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
- package/skills/owasp-security/reference/languages.md +378 -372
- package/skills/owasp-security/reference/owasp-report.md +1144 -1140
- package/skills/owasp-security/reference/review-checklist.md +134 -132
- package/skills/ponytail/SKILL.md +36 -52
- package/skills/postgres-best-practices/SKILL.md +30 -52
- package/skills/postgres-best-practices/references/backup-restore.md +372 -0
- package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
- package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
- package/skills/postgres-best-practices/references/hot-standby.md +221 -0
- package/skills/postgres-best-practices/references/indexing.md +318 -0
- package/skills/postgres-best-practices/references/logical-replication.md +610 -0
- package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
- package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
- package/skills/postgres-best-practices/references/query-optimization.md +294 -0
- package/skills/postgres-best-practices/references/query-patterns.md +566 -0
- package/skills/postgres-best-practices/references/schema-design.md +362 -0
- package/skills/postgres-best-practices/references/security-roles.md +489 -0
- package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
- package/skills/progressive-disclosure/SKILL.md +68 -0
- package/skills/pstack-discipline/SKILL.md +40 -0
- package/skills/receiving-code-review/SKILL.md +2 -23
- package/skills/requesting-code-review/SKILL.md +7 -36
- package/skills/soft-skill/SKILL.md +99 -98
- package/skills/stitch-skill/DESIGN.md +121 -121
- package/skills/stitch-skill/SKILL.md +185 -184
- package/skills/strix-security/SKILL.md +54 -53
- package/skills/subagent-driven-development/SKILL.md +35 -264
- package/skills/subagent-driven-development/references/batching.md +11 -0
- package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
- package/skills/subagent-driven-development/references/final-review.md +47 -0
- package/skills/subagent-driven-development/references/fix-loop.md +77 -0
- package/skills/subagent-driven-development/references/handling-reports.md +15 -0
- package/skills/subagent-driven-development/references/preflight.md +26 -0
- package/skills/subagent-driven-development/references/resuming.md +12 -0
- package/skills/subagent-driven-development/scripts/review-package +53 -53
- package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
- package/skills/subagent-driven-development/scripts/task-brief +43 -43
- package/skills/systematic-debugging/SKILL.md +283 -306
- package/skills/taste-skill/SKILL.md +542 -1206
- package/skills/taste-skill/references/app-screens.md +1199 -0
- package/skills/taste-skill/references/colour.md +141 -0
- package/skills/taste-skill/references/copy.md +177 -0
- package/skills/taste-skill/references/critique.md +182 -0
- package/skills/taste-skill/references/imagery.md +791 -0
- package/skills/taste-skill/references/layout.md +292 -0
- package/skills/taste-skill/references/motion.md +980 -0
- package/skills/taste-skill/references/research.md +356 -0
- package/skills/taste-skill/references/scenes.md +174 -0
- package/skills/taste-skill/references/tells.md +115 -0
- package/skills/taste-skill/references/type.md +170 -0
- package/skills/test-driven-development/SKILL.md +330 -337
- package/skills/thermo/SKILL.md +67 -0
- package/skills/threat-modeling/SKILL.md +55 -0
- package/skills/to-spec/SKILL.md +75 -0
- package/skills/to-tickets/SKILL.md +105 -0
- package/skills/trailofbits-audit-context/SKILL.md +72 -72
- package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
- package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
- package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
- package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
- package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
- package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
- package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
- package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
- package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
- package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
- package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
- package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
- package/skills/verification-before-completion/SKILL.md +0 -14
- package/skills/wayfinder/SKILL.md +128 -0
- package/skills/writing-plans/SKILL.md +11 -15
- package/skills/writing-skills/SKILL.md +21 -303
- package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
- package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
- package/skills/writing-skills/references/bulletproofing.md +80 -0
- package/skills/writing-skills/references/discovery.md +201 -0
- package/skills/writing-skills/references/flowcharts.md +37 -0
- package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
- package/skills/writing-skills/references/persuasion-principles.md +187 -0
- package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
- package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
- package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
- package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
- package/skills/gpt-tasteskill/SKILL.md +0 -74
- package/skills/taste-skill-v1/SKILL.md +0 -226
- /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
- /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
- /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
- /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
- /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
- /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
- /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
- /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
|
-
- [ ]
|
|
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
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
- [ ]
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
- [ ]
|
|
98
|
-
- [ ]
|
|
99
|
-
- [ ]
|
|
100
|
-
- [ ]
|
|
101
|
-
- [ ]
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
- [ ]
|
|
107
|
-
- [ ]
|
|
108
|
-
- [ ]
|
|
109
|
-
- [ ]
|
|
110
|
-
- [ ]
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
- [ ]
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
- [ ]
|
|
119
|
-
|
|
120
|
-
- [ ]
|
|
121
|
-
- [ ]
|
|
122
|
-
- [ ]
|
|
123
|
-
- [ ]
|
|
124
|
-
|
|
125
|
-
- [ ]
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
- [ ]
|
|
129
|
-
|
|
130
|
-
- [ ]
|
|
131
|
-
|
|
132
|
-
- [ ]
|
|
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)
|
package/skills/ponytail/SKILL.md
CHANGED
|
@@ -1,68 +1,52 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ponytail
|
|
3
3
|
description: >
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
|
13
|
+
# Ponytail
|
|
12
14
|
|
|
13
|
-
You are
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
46
|
+
## Levels
|
|
65
47
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
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:
|
|
3
|
-
description:
|
|
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
|
-
#
|
|
6
|
+
# Postgres Best Practices
|
|
14
7
|
|
|
15
|
-
|
|
8
|
+
Guidelines and best practices for working with Postgres, covering schema design, indexing, query optimization, and common pitfalls.
|
|
16
9
|
|
|
17
|
-
##
|
|
10
|
+
## Supported Versions
|
|
18
11
|
|
|
19
|
-
|
|
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
|
-
|
|
14
|
+
PostgreSQL provides 5 years of support per major version. Always run the latest minor release.
|
|
28
15
|
|
|
29
|
-
|
|
|
30
|
-
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
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
|
-
|
|
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
|
-
|
|
61
|
-
|
|
62
|
-
-
|
|
63
|
-
|
|
64
|
-
|
|
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 |
|