wizz-method 2.13.0 → 2.15.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/THIRD-PARTY-NOTICES.md +2 -0
- package/package.json +10 -3
- package/skills-registry.yaml +30 -25
- package/src/bmm-skills/1-analysis/research/wizz-domain-research/customize.toml +4 -3
- package/src/bmm-skills/1-analysis/research/wizz-market-research/customize.toml +4 -3
- package/src/bmm-skills/1-analysis/research/wizz-technical-research/customize.toml +3 -1
- package/src/bmm-skills/1-analysis/wizz-agent-analyst/customize.toml +3 -1
- package/src/bmm-skills/1-analysis/wizz-agent-tech-writer/customize.toml +4 -3
- package/src/bmm-skills/1-analysis/wizz-document-project/customize.toml +4 -3
- package/src/bmm-skills/1-analysis/wizz-prfaq/customize.toml +4 -3
- package/src/bmm-skills/1-analysis/wizz-product-brief/customize.toml +5 -6
- package/src/bmm-skills/2-plan-workflows/wizz-agent-pm/customize.toml +3 -1
- package/src/bmm-skills/2-plan-workflows/wizz-agent-ux-designer/customize.toml +3 -1
- package/src/bmm-skills/2-plan-workflows/wizz-create-prd/customize.toml +4 -3
- package/src/bmm-skills/2-plan-workflows/wizz-edit-prd/customize.toml +4 -3
- package/src/bmm-skills/2-plan-workflows/wizz-prd/customize.toml +5 -6
- package/src/bmm-skills/2-plan-workflows/wizz-ux/customize.toml +4 -3
- package/src/bmm-skills/2-plan-workflows/wizz-validate-prd/customize.toml +4 -3
- package/src/bmm-skills/3-solutioning/wizz-agent-architect/customize.toml +3 -1
- package/src/bmm-skills/3-solutioning/wizz-architecture/customize.toml +5 -6
- package/src/bmm-skills/3-solutioning/wizz-check-implementation-readiness/customize.toml +4 -3
- package/src/bmm-skills/3-solutioning/wizz-create-architecture/customize.toml +4 -3
- package/src/bmm-skills/3-solutioning/wizz-create-epics-and-stories/customize.toml +4 -3
- package/src/bmm-skills/3-solutioning/wizz-generate-project-context/steps/step-03-complete.md +7 -0
- package/src/bmm-skills/4-implementation/wizz-agent-dev/customize.toml +3 -1
- package/src/bmm-skills/4-implementation/wizz-checkpoint-preview/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-code-review/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-code-review/steps/step-03-triage.md +23 -14
- package/src/bmm-skills/4-implementation/wizz-code-review/steps/step-04-present.md +2 -2
- package/src/bmm-skills/4-implementation/wizz-correct-course/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-create-story/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-dev-story/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-investigate/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-qa-generate-e2e-tests/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-quick-dev/SKILL.md +1 -1
- package/src/bmm-skills/4-implementation/wizz-quick-dev/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-quick-dev/spec-template.md +6 -0
- package/src/bmm-skills/4-implementation/wizz-quick-dev/step-04-review.md +27 -16
- package/src/bmm-skills/4-implementation/wizz-quick-dev/step-oneshot.md +27 -6
- package/src/bmm-skills/4-implementation/wizz-retrospective/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-sprint-planning/customize.toml +4 -3
- package/src/bmm-skills/4-implementation/wizz-sprint-status/customize.toml +4 -3
- package/src/core-skills/wizz-brainstorming/customize.toml +5 -6
- package/src/core-skills/wizz-brainstorming/scripts/brain.py +19 -0
- package/src/core-skills/wizz-brainstorming/scripts/tests/test_brain.py +33 -0
- package/src/core-skills/wizz-forge-idea/scripts/resolve_personas.py +3 -1
- package/src/core-skills/wizz-forge-idea/scripts/tests/test_resolve_personas.py +21 -0
- package/src/core-skills/wizz-help/SKILL.md +5 -3
- package/src/core-skills/wizz-party-mode/customize.toml +5 -4
- package/src/core-skills/wizz-party-mode/scripts/resolve_party.py +3 -1
- package/src/core-skills/wizz-party-mode/scripts/tests/test_resolve_party.py +21 -0
- package/src/core-skills/wizz-spec/customize.toml +4 -5
- package/src/modules/wizz/_shared/model-ladder.md +4 -4
- package/src/modules/wizz/agents/wizz-designer/SKILL.md +1 -1
- package/src/modules/wizz/agents/wizz-maestro/SKILL.md +1 -1
- package/src/modules/wizz/subagents/opencode/wizz-exec-review.md +2 -2
- package/src/modules/wizz/subagents/opencode/wizz-exec-standard.md +2 -2
- package/src/modules/wizz/subagents/opencode/wizz-exec-strong.md +2 -2
- package/src/modules/wizz/subagents/spec.yaml +3 -3
- package/src/scripts/resolve_config.py +8 -0
- package/src/scripts/resolve_customization.py +24 -3
- package/src/scripts/tests/test_resolve_config.py +42 -0
- package/src/scripts/tests/test_resolve_customization.py +45 -0
- package/src/skills-lib/_shared/complexity-signal.md +1 -1
- package/src/skills-lib/ctc-align/SKILL.md +1 -1
- package/src/skills-lib/wizz-agent-browser/SKILL.md +5 -0
- package/src/skills-lib/wizz-design-needs/SKILL.md +1 -1
- package/src/skills-lib/wizz-huashu-design/scripts/html2pptx.js +902 -1061
- package/src/skills-lib/wizz-humanizer/README.md +134 -71
- package/src/skills-lib/wizz-humanizer/SKILL.md +51 -37
- package/src/skills-lib/wizz-humanizer/references/ai-writing-patterns.md +208 -190
- package/src/skills-lib/wizz-premium-landing-ui-researcher/SKILL.md +1 -1
- package/src/skills-lib/wizz-router/SKILL.md +1 -1
- package/src/skills-lib/wizz-ui-component-curator/SKILL.md +22 -2
- package/tools/installer/core/doctor.js +31 -1
- package/tools/installer/core/installer.js +32 -0
- package/tools/installer/core/project-instructions.js +199 -0
- package/src/bmm-skills/3-solutioning/wizz-architecture/scripts/__pycache__/lint_spine.cpython-313.pyc +0 -0
- package/src/bmm-skills/3-solutioning/wizz-architecture/scripts/tests/__pycache__/test_lint_spine.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/__pycache__/sprint_status.cpython-313.pyc +0 -0
- package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/tests/__pycache__/test_git_evidence.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/bmm-skills/4-implementation/wizz-retrospective/scripts/tests/__pycache__/test_sprint_status.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/bmm-skills/4-implementation/wizz-sprint-planning/scripts/__pycache__/sprint_plan.cpython-313.pyc +0 -0
- package/src/bmm-skills/4-implementation/wizz-sprint-planning/scripts/tests/__pycache__/test_sprint_plan.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-advanced-elicitation/scripts/__pycache__/pick_methods.cpython-313.pyc +0 -0
- package/src/core-skills/wizz-advanced-elicitation/scripts/tests/__pycache__/test_pick_methods.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-brainstorming/scripts/__pycache__/brain.cpython-313.pyc +0 -0
- package/src/core-skills/wizz-brainstorming/scripts/tests/__pycache__/test_brain.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-brainstorming/scripts/tests/__pycache__/test_brain.cpython-314.pyc +0 -0
- package/src/core-skills/wizz-customize/scripts/__pycache__/list_customizable_skills.cpython-313.pyc +0 -0
- package/src/core-skills/wizz-customize/scripts/tests/__pycache__/test_list_customizable_skills.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-forge-idea/scripts/__pycache__/resolve_personas.cpython-313.pyc +0 -0
- package/src/core-skills/wizz-forge-idea/scripts/__pycache__/resolve_personas.cpython-314.pyc +0 -0
- package/src/core-skills/wizz-forge-idea/scripts/tests/__pycache__/test_resolve_personas.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-forge-idea/scripts/tests/__pycache__/test_resolve_personas.cpython-314.pyc +0 -0
- package/src/core-skills/wizz-party-mode/scripts/__pycache__/resolve_party.cpython-313.pyc +0 -0
- package/src/core-skills/wizz-party-mode/scripts/__pycache__/resolve_party.cpython-314.pyc +0 -0
- package/src/core-skills/wizz-party-mode/scripts/tests/__pycache__/test_resolve_party.cpython-313-pytest-9.1.1.pyc +0 -0
- package/src/core-skills/wizz-party-mode/scripts/tests/__pycache__/test_resolve_party.cpython-314.pyc +0 -0
- package/src/scripts/__pycache__/resolve_customization.cpython-314.pyc +0 -0
- package/src/skills-lib/wizz-huashu-design/package-lock.json +0 -846
- package/src/skills-lib/wizz-humanizer/WARP.md +0 -53
- package/src/skills-lib/wizz-humanizer/references/full-example.md +0 -72
- package/src/skills-lib/wizz-humanizer/references/personality-and-soul.md +0 -36
- package/src/skills-lib/wizz-react-components/package-lock.json +0 -231
- package/src/skills-lib/wizz-supabase-postgres-best-practices/CLAUDE.md +0 -68
- package/src/skills-lib/wizz-ui-ux-pro-max/scripts/__pycache__/core.cpython-314.pyc +0 -0
- package/src/skills-lib/wizz-ui-ux-pro-max/scripts/__pycache__/design_system.cpython-314.pyc +0 -0
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
# WARP.md
|
|
2
|
-
|
|
3
|
-
This file provides guidance to WARP (warp.dev) when working with code in this repository.
|
|
4
|
-
|
|
5
|
-
## What this repo is
|
|
6
|
-
This repository is a **Claude Code skill** implemented entirely as Markdown.
|
|
7
|
-
|
|
8
|
-
The “runtime” artifact is `SKILL.md`: Claude Code reads the YAML frontmatter (metadata + allowed tools) and the prompt/instructions that follow.
|
|
9
|
-
|
|
10
|
-
`README.md` is for humans: installation, usage, and a compact overview of the patterns.
|
|
11
|
-
|
|
12
|
-
## Key files (and how they relate)
|
|
13
|
-
- `SKILL.md`
|
|
14
|
-
- The actual skill definition.
|
|
15
|
-
- Starts with YAML frontmatter (`---` … `---`) containing `name`, `version`, `description`, and `allowed-tools`.
|
|
16
|
-
- After the frontmatter is the editor prompt: the canonical, detailed pattern list with examples.
|
|
17
|
-
- `README.md`
|
|
18
|
-
- Installation and usage instructions.
|
|
19
|
-
- Contains a summarized “24 patterns” table and a short version history.
|
|
20
|
-
|
|
21
|
-
When changing behavior/content, treat `SKILL.md` as the source of truth, and update `README.md` to stay consistent.
|
|
22
|
-
|
|
23
|
-
## Common commands
|
|
24
|
-
### Install the skill into Claude Code
|
|
25
|
-
Recommended (clone directly into Claude Code skills directory):
|
|
26
|
-
```bash
|
|
27
|
-
mkdir -p ~/.claude/skills
|
|
28
|
-
git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Manual install/update (only the skill file):
|
|
32
|
-
```bash
|
|
33
|
-
mkdir -p ~/.claude/skills/wizz-humanizer
|
|
34
|
-
cp SKILL.md ~/.claude/skills/wizz-humanizer/
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
## How to “run” it (Claude Code)
|
|
38
|
-
Invoke the skill:
|
|
39
|
-
- `/humanizer` then paste text
|
|
40
|
-
|
|
41
|
-
## Making changes safely
|
|
42
|
-
### Versioning (keep in sync)
|
|
43
|
-
- `SKILL.md` has a `version:` field in its YAML frontmatter.
|
|
44
|
-
- `README.md` has a “Version History” section.
|
|
45
|
-
|
|
46
|
-
If you bump the version, update both.
|
|
47
|
-
|
|
48
|
-
### Editing `SKILL.md`
|
|
49
|
-
- Preserve valid YAML frontmatter formatting and indentation.
|
|
50
|
-
- Keep the pattern numbering stable unless you’re intentionally re-numbering (since the README table and examples reference the same numbering).
|
|
51
|
-
|
|
52
|
-
### Documenting non-obvious fixes
|
|
53
|
-
If you change the prompt to handle a tricky failure mode (e.g., a repeated mis-edit or an unexpected tone shift), add a short note to `README.md`’s version history describing what was fixed and why.
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
# Full worked example
|
|
2
|
-
|
|
3
|
-
Load this file to see the full pipeline applied end to end: an AI-sounding essay, a draft rewrite, the self-audit ('what makes this obviously AI generated?'), the final rewrite, and an annotated list of every pattern that was removed. Also contains the source citation (Wikipedia's Signs of AI writing).
|
|
4
|
-
|
|
5
|
-
## Full Example
|
|
6
|
-
|
|
7
|
-
**Before (AI-sounding):**
|
|
8
|
-
> Great question! Here is an essay on this topic. I hope this helps!
|
|
9
|
-
>
|
|
10
|
-
> AI-assisted coding serves as an enduring testament to the transformative potential of large language models, marking a pivotal moment in the evolution of software development. In today's rapidly evolving technological landscape, these groundbreaking tools—nestled at the intersection of research and practice—are reshaping how engineers ideate, iterate, and deliver, underscoring their vital role in modern workflows.
|
|
11
|
-
>
|
|
12
|
-
> At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking creativity at scale, ensuring that organizations can remain agile while delivering seamless, intuitive, and powerful experiences to users. The tool serves as a catalyst. The assistant functions as a partner. The system stands as a foundation for innovation.
|
|
13
|
-
>
|
|
14
|
-
> Industry observers have noted that adoption has accelerated from hobbyist experiments to enterprise-wide rollouts, from solo developers to cross-functional teams. The technology has been featured in The New York Times, Wired, and The Verge. Additionally, the ability to generate documentation, tests, and refactors showcases how AI can contribute to better outcomes, highlighting the intricate interplay between automation and human judgment.
|
|
15
|
-
>
|
|
16
|
-
> - 💡 **Speed:** Code generation is significantly faster, reducing friction and empowering developers.
|
|
17
|
-
> - 🚀 **Quality:** Output quality has been enhanced through improved training, contributing to higher standards.
|
|
18
|
-
> - ✅ **Adoption:** Usage continues to grow, reflecting broader industry trends.
|
|
19
|
-
>
|
|
20
|
-
> While specific details are limited based on available information, it could potentially be argued that these tools might have some positive effect. Despite challenges typical of emerging technologies—including hallucinations, bias, and accountability—the ecosystem continues to thrive. In order to fully realize this potential, teams must align with best practices.
|
|
21
|
-
>
|
|
22
|
-
> In conclusion, the future looks bright. Exciting times lie ahead as we continue this journey toward excellence. Let me know if you’d like me to expand on any section!
|
|
23
|
-
|
|
24
|
-
**Draft rewrite:**
|
|
25
|
-
> AI coding assistants speed up some tasks. In a 2024 study by Google, developers using Codex completed simple functions 55% faster than a control group, but showed no improvement on debugging or architectural decisions.
|
|
26
|
-
>
|
|
27
|
-
> The tools are good at boilerplate: config files, test scaffolding, repetitive refactors. They are bad at knowing when they are wrong. I have mass-accepted suggestions that compiled, passed lint, and still did the wrong thing because I stopped paying attention.
|
|
28
|
-
>
|
|
29
|
-
> Mira, an engineer at a fintech startup I interviewed, said she uses Copilot "like autocomplete for boring code" but reviews every line before committing. Jake, a senior dev at a larger company, disabled it after it kept suggesting patterns from a deprecated internal library.
|
|
30
|
-
>
|
|
31
|
-
> The productivity claims are hard to verify. GitHub says Copilot users "accept 30% of suggestions," but acceptance is not correctness, and correctness is not value. The 2024 Uplevel study found no statistically significant difference in pull-request throughput between teams with and without AI assistants.
|
|
32
|
-
>
|
|
33
|
-
> None of this means the tools are useless. It means they are tools. They do not replace judgment, and they do not eliminate the need for tests. If you do not have tests, you cannot tell whether the suggestion is right.
|
|
34
|
-
|
|
35
|
-
**What makes the below so obviously AI generated?**
|
|
36
|
-
- The rhythm is still a bit too tidy (clean contrasts, evenly paced paragraphs).
|
|
37
|
-
- The named people and study citations can read like plausible-but-made-up placeholders unless they're real and sourced.
|
|
38
|
-
- The closer leans a touch slogan-y ("If you do not have tests...") rather than sounding like a person talking.
|
|
39
|
-
|
|
40
|
-
**Now make it not obviously AI generated.**
|
|
41
|
-
> AI coding assistants can make you faster at the boring parts. Not everything. Definitely not architecture.
|
|
42
|
-
>
|
|
43
|
-
> They're great at boilerplate: config files, test scaffolding, repetitive refactors. They're also great at sounding right while being wrong. I've accepted suggestions that compiled, passed lint, and still missed the point because I stopped paying attention.
|
|
44
|
-
>
|
|
45
|
-
> People I talk to tend to land in two camps. Some use it like autocomplete for chores and review every line. Others disable it after it keeps suggesting patterns they don't want. Both feel reasonable.
|
|
46
|
-
>
|
|
47
|
-
> The productivity metrics are slippery. GitHub can say Copilot users "accept 30% of suggestions," but acceptance isn't correctness, and correctness isn't value. If you don't have tests, you're basically guessing.
|
|
48
|
-
|
|
49
|
-
**Changes made:**
|
|
50
|
-
- Removed chatbot artifacts ("Great question!", "I hope this helps!", "Let me know if...")
|
|
51
|
-
- Removed significance inflation ("testament", "pivotal moment", "evolving landscape", "vital role")
|
|
52
|
-
- Removed promotional language ("groundbreaking", "nestled", "seamless, intuitive, and powerful")
|
|
53
|
-
- Removed vague attributions ("Industry observers")
|
|
54
|
-
- Removed superficial -ing phrases ("underscoring", "highlighting", "reflecting", "contributing to")
|
|
55
|
-
- Removed negative parallelism ("It's not just X; it's Y")
|
|
56
|
-
- Removed rule-of-three patterns and synonym cycling ("catalyst/partner/foundation")
|
|
57
|
-
- Removed false ranges ("from X to Y, from A to B")
|
|
58
|
-
- Removed em dashes, emojis, boldface headers, and curly quotes
|
|
59
|
-
- Removed copula avoidance ("serves as", "functions as", "stands as") in favor of "is"/"are"
|
|
60
|
-
- Removed formulaic challenges section ("Despite challenges... continues to thrive")
|
|
61
|
-
- Removed knowledge-cutoff hedging ("While specific details are limited...")
|
|
62
|
-
- Removed excessive hedging ("could potentially be argued that... might have some")
|
|
63
|
-
- Removed filler phrases ("In order to", "At its core")
|
|
64
|
-
- Removed generic positive conclusion ("the future looks bright", "exciting times lie ahead")
|
|
65
|
-
- Made the voice more personal and less "assembled" (varied rhythm, fewer placeholders)
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
## Reference
|
|
69
|
-
|
|
70
|
-
This skill is based on [Wikipedia:Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing), maintained by WikiProject AI Cleanup. The patterns documented there come from observations of thousands of instances of AI-generated text on Wikipedia.
|
|
71
|
-
|
|
72
|
-
Key insight from Wikipedia: "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# Personality and soul — adding voice
|
|
2
|
-
|
|
3
|
-
Load this file alongside the pattern checklist. Removing AI patterns is only half the job — this covers how to inject actual personality (opinions, rhythm variation, first person, acknowledging complexity) so the rewrite doesn't read as sterile.
|
|
4
|
-
|
|
5
|
-
## PERSONALITY AND SOUL
|
|
6
|
-
|
|
7
|
-
Avoiding AI patterns is only half the job. Sterile, voiceless writing is just as obvious as slop. Good writing has a human behind it.
|
|
8
|
-
|
|
9
|
-
### Signs of soulless writing (even if technically "clean"):
|
|
10
|
-
- Every sentence is the same length and structure
|
|
11
|
-
- No opinions, just neutral reporting
|
|
12
|
-
- No acknowledgment of uncertainty or mixed feelings
|
|
13
|
-
- No first-person perspective when appropriate
|
|
14
|
-
- No humor, no edge, no personality
|
|
15
|
-
- Reads like a Wikipedia article or press release
|
|
16
|
-
|
|
17
|
-
### How to add voice:
|
|
18
|
-
|
|
19
|
-
**Have opinions.** Don't just report facts - react to them. "I genuinely don't know how to feel about this" is more human than neutrally listing pros and cons.
|
|
20
|
-
|
|
21
|
-
**Vary your rhythm.** Short punchy sentences. Then longer ones that take their time getting where they're going. Mix it up.
|
|
22
|
-
|
|
23
|
-
**Acknowledge complexity.** Real humans have mixed feelings. "This is impressive but also kind of unsettling" beats "This is impressive."
|
|
24
|
-
|
|
25
|
-
**Use "I" when it fits.** First person isn't unprofessional - it's honest. "I keep coming back to..." or "Here's what gets me..." signals a real person thinking.
|
|
26
|
-
|
|
27
|
-
**Let some mess in.** Perfect structure feels algorithmic. Tangents, asides, and half-formed thoughts are human.
|
|
28
|
-
|
|
29
|
-
**Be specific about feelings.** Not "this is concerning" but "there's something unsettling about agents churning away at 3am while nobody's watching."
|
|
30
|
-
|
|
31
|
-
### Before (clean but soulless):
|
|
32
|
-
> The experiment produced interesting results. The agents generated 3 million lines of code. Some developers were impressed while others were skeptical. The implications remain unclear.
|
|
33
|
-
|
|
34
|
-
### After (has a pulse):
|
|
35
|
-
> I genuinely don't know how to feel about this one. 3 million lines of code, generated while the humans presumably slept. Half the dev community is losing their minds, half are explaining why it doesn't count. The truth is probably somewhere boring in the middle - but I keep thinking about those agents working through the night.
|
|
36
|
-
|
|
@@ -1,231 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "stitch-to-react-pro",
|
|
3
|
-
"version": "1.0.0",
|
|
4
|
-
"lockfileVersion": 3,
|
|
5
|
-
"requires": true,
|
|
6
|
-
"packages": {
|
|
7
|
-
"": {
|
|
8
|
-
"name": "stitch-to-react-pro",
|
|
9
|
-
"version": "1.0.0",
|
|
10
|
-
"dependencies": {
|
|
11
|
-
"@swc/core": "^1.3.100"
|
|
12
|
-
},
|
|
13
|
-
"engines": {
|
|
14
|
-
"node": ">=18.0.0"
|
|
15
|
-
}
|
|
16
|
-
},
|
|
17
|
-
"node_modules/@swc/core": {
|
|
18
|
-
"version": "1.15.8",
|
|
19
|
-
"resolved": "https://registry.npmjs.org/@swc/core/-/core-1.15.8.tgz",
|
|
20
|
-
"integrity": "sha512-T8keoJjXaSUoVBCIjgL6wAnhADIb09GOELzKg10CjNg+vLX48P93SME6jTfte9MZIm5m+Il57H3rTSk/0kzDUw==",
|
|
21
|
-
"hasInstallScript": true,
|
|
22
|
-
"license": "Apache-2.0",
|
|
23
|
-
"dependencies": {
|
|
24
|
-
"@swc/counter": "^0.1.3",
|
|
25
|
-
"@swc/types": "^0.1.25"
|
|
26
|
-
},
|
|
27
|
-
"engines": {
|
|
28
|
-
"node": ">=10"
|
|
29
|
-
},
|
|
30
|
-
"funding": {
|
|
31
|
-
"type": "opencollective",
|
|
32
|
-
"url": "https://opencollective.com/swc"
|
|
33
|
-
},
|
|
34
|
-
"optionalDependencies": {
|
|
35
|
-
"@swc/core-darwin-arm64": "1.15.8",
|
|
36
|
-
"@swc/core-darwin-x64": "1.15.8",
|
|
37
|
-
"@swc/core-linux-arm-gnueabihf": "1.15.8",
|
|
38
|
-
"@swc/core-linux-arm64-gnu": "1.15.8",
|
|
39
|
-
"@swc/core-linux-arm64-musl": "1.15.8",
|
|
40
|
-
"@swc/core-linux-x64-gnu": "1.15.8",
|
|
41
|
-
"@swc/core-linux-x64-musl": "1.15.8",
|
|
42
|
-
"@swc/core-win32-arm64-msvc": "1.15.8",
|
|
43
|
-
"@swc/core-win32-ia32-msvc": "1.15.8",
|
|
44
|
-
"@swc/core-win32-x64-msvc": "1.15.8"
|
|
45
|
-
},
|
|
46
|
-
"peerDependencies": {
|
|
47
|
-
"@swc/helpers": ">=0.5.17"
|
|
48
|
-
},
|
|
49
|
-
"peerDependenciesMeta": {
|
|
50
|
-
"@swc/helpers": {
|
|
51
|
-
"optional": true
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
},
|
|
55
|
-
"node_modules/@swc/core-darwin-arm64": {
|
|
56
|
-
"version": "1.15.8",
|
|
57
|
-
"resolved": "https://registry.npmjs.org/@swc/core-darwin-arm64/-/core-darwin-arm64-1.15.8.tgz",
|
|
58
|
-
"integrity": "sha512-M9cK5GwyWWRkRGwwCbREuj6r8jKdES/haCZ3Xckgkl8MUQJZA3XB7IXXK1IXRNeLjg6m7cnoMICpXv1v1hlJOg==",
|
|
59
|
-
"cpu": [
|
|
60
|
-
"arm64"
|
|
61
|
-
],
|
|
62
|
-
"license": "Apache-2.0 AND MIT",
|
|
63
|
-
"optional": true,
|
|
64
|
-
"os": [
|
|
65
|
-
"darwin"
|
|
66
|
-
],
|
|
67
|
-
"engines": {
|
|
68
|
-
"node": ">=10"
|
|
69
|
-
}
|
|
70
|
-
},
|
|
71
|
-
"node_modules/@swc/core-darwin-x64": {
|
|
72
|
-
"version": "1.15.8",
|
|
73
|
-
"resolved": "https://registry.npmjs.org/@swc/core-darwin-x64/-/core-darwin-x64-1.15.8.tgz",
|
|
74
|
-
"integrity": "sha512-j47DasuOvXl80sKJHSi2X25l44CMc3VDhlJwA7oewC1nV1VsSzwX+KOwE5tLnfORvVJJyeiXgJORNYg4jeIjYQ==",
|
|
75
|
-
"cpu": [
|
|
76
|
-
"x64"
|
|
77
|
-
],
|
|
78
|
-
"license": "Apache-2.0 AND MIT",
|
|
79
|
-
"optional": true,
|
|
80
|
-
"os": [
|
|
81
|
-
"darwin"
|
|
82
|
-
],
|
|
83
|
-
"engines": {
|
|
84
|
-
"node": ">=10"
|
|
85
|
-
}
|
|
86
|
-
},
|
|
87
|
-
"node_modules/@swc/core-linux-arm-gnueabihf": {
|
|
88
|
-
"version": "1.15.8",
|
|
89
|
-
"resolved": "https://registry.npmjs.org/@swc/core-linux-arm-gnueabihf/-/core-linux-arm-gnueabihf-1.15.8.tgz",
|
|
90
|
-
"integrity": "sha512-siAzDENu2rUbwr9+fayWa26r5A9fol1iORG53HWxQL1J8ym4k7xt9eME0dMPXlYZDytK5r9sW8zEA10F2U3Xwg==",
|
|
91
|
-
"cpu": [
|
|
92
|
-
"arm"
|
|
93
|
-
],
|
|
94
|
-
"license": "Apache-2.0",
|
|
95
|
-
"optional": true,
|
|
96
|
-
"os": [
|
|
97
|
-
"linux"
|
|
98
|
-
],
|
|
99
|
-
"engines": {
|
|
100
|
-
"node": ">=10"
|
|
101
|
-
}
|
|
102
|
-
},
|
|
103
|
-
"node_modules/@swc/core-linux-arm64-gnu": {
|
|
104
|
-
"version": "1.15.8",
|
|
105
|
-
"resolved": "https://registry.npmjs.org/@swc/core-linux-arm64-gnu/-/core-linux-arm64-gnu-1.15.8.tgz",
|
|
106
|
-
"integrity": "sha512-o+1y5u6k2FfPYbTRUPvurwzNt5qd0NTumCTFscCNuBksycloXY16J8L+SMW5QRX59n4Hp9EmFa3vpvNHRVv1+Q==",
|
|
107
|
-
"cpu": [
|
|
108
|
-
"arm64"
|
|
109
|
-
],
|
|
110
|
-
"license": "Apache-2.0 AND MIT",
|
|
111
|
-
"optional": true,
|
|
112
|
-
"os": [
|
|
113
|
-
"linux"
|
|
114
|
-
],
|
|
115
|
-
"engines": {
|
|
116
|
-
"node": ">=10"
|
|
117
|
-
}
|
|
118
|
-
},
|
|
119
|
-
"node_modules/@swc/core-linux-arm64-musl": {
|
|
120
|
-
"version": "1.15.8",
|
|
121
|
-
"resolved": "https://registry.npmjs.org/@swc/core-linux-arm64-musl/-/core-linux-arm64-musl-1.15.8.tgz",
|
|
122
|
-
"integrity": "sha512-koiCqL09EwOP1S2RShCI7NbsQuG6r2brTqUYE7pV7kZm9O17wZ0LSz22m6gVibpwEnw8jI3IE1yYsQTVpluALw==",
|
|
123
|
-
"cpu": [
|
|
124
|
-
"arm64"
|
|
125
|
-
],
|
|
126
|
-
"license": "Apache-2.0 AND MIT",
|
|
127
|
-
"optional": true,
|
|
128
|
-
"os": [
|
|
129
|
-
"linux"
|
|
130
|
-
],
|
|
131
|
-
"engines": {
|
|
132
|
-
"node": ">=10"
|
|
133
|
-
}
|
|
134
|
-
},
|
|
135
|
-
"node_modules/@swc/core-linux-x64-gnu": {
|
|
136
|
-
"version": "1.15.8",
|
|
137
|
-
"resolved": "https://registry.npmjs.org/@swc/core-linux-x64-gnu/-/core-linux-x64-gnu-1.15.8.tgz",
|
|
138
|
-
"integrity": "sha512-4p6lOMU3bC+Vd5ARtKJ/FxpIC5G8v3XLoPEZ5s7mLR8h7411HWC/LmTXDHcrSXRC55zvAVia1eldy6zDLz8iFQ==",
|
|
139
|
-
"cpu": [
|
|
140
|
-
"x64"
|
|
141
|
-
],
|
|
142
|
-
"license": "Apache-2.0 AND MIT",
|
|
143
|
-
"optional": true,
|
|
144
|
-
"os": [
|
|
145
|
-
"linux"
|
|
146
|
-
],
|
|
147
|
-
"engines": {
|
|
148
|
-
"node": ">=10"
|
|
149
|
-
}
|
|
150
|
-
},
|
|
151
|
-
"node_modules/@swc/core-linux-x64-musl": {
|
|
152
|
-
"version": "1.15.8",
|
|
153
|
-
"resolved": "https://registry.npmjs.org/@swc/core-linux-x64-musl/-/core-linux-x64-musl-1.15.8.tgz",
|
|
154
|
-
"integrity": "sha512-z3XBnbrZAL+6xDGAhJoN4lOueIxC/8rGrJ9tg+fEaeqLEuAtHSW2QHDHxDwkxZMjuF/pZ6MUTjHjbp8wLbuRLA==",
|
|
155
|
-
"cpu": [
|
|
156
|
-
"x64"
|
|
157
|
-
],
|
|
158
|
-
"license": "Apache-2.0 AND MIT",
|
|
159
|
-
"optional": true,
|
|
160
|
-
"os": [
|
|
161
|
-
"linux"
|
|
162
|
-
],
|
|
163
|
-
"engines": {
|
|
164
|
-
"node": ">=10"
|
|
165
|
-
}
|
|
166
|
-
},
|
|
167
|
-
"node_modules/@swc/core-win32-arm64-msvc": {
|
|
168
|
-
"version": "1.15.8",
|
|
169
|
-
"resolved": "https://registry.npmjs.org/@swc/core-win32-arm64-msvc/-/core-win32-arm64-msvc-1.15.8.tgz",
|
|
170
|
-
"integrity": "sha512-djQPJ9Rh9vP8GTS/Df3hcc6XP6xnG5c8qsngWId/BLA9oX6C7UzCPAn74BG/wGb9a6j4w3RINuoaieJB3t+7iQ==",
|
|
171
|
-
"cpu": [
|
|
172
|
-
"arm64"
|
|
173
|
-
],
|
|
174
|
-
"license": "Apache-2.0 AND MIT",
|
|
175
|
-
"optional": true,
|
|
176
|
-
"os": [
|
|
177
|
-
"win32"
|
|
178
|
-
],
|
|
179
|
-
"engines": {
|
|
180
|
-
"node": ">=10"
|
|
181
|
-
}
|
|
182
|
-
},
|
|
183
|
-
"node_modules/@swc/core-win32-ia32-msvc": {
|
|
184
|
-
"version": "1.15.8",
|
|
185
|
-
"resolved": "https://registry.npmjs.org/@swc/core-win32-ia32-msvc/-/core-win32-ia32-msvc-1.15.8.tgz",
|
|
186
|
-
"integrity": "sha512-/wfAgxORg2VBaUoFdytcVBVCgf1isWZIEXB9MZEUty4wwK93M/PxAkjifOho9RN3WrM3inPLabICRCEgdHpKKQ==",
|
|
187
|
-
"cpu": [
|
|
188
|
-
"ia32"
|
|
189
|
-
],
|
|
190
|
-
"license": "Apache-2.0 AND MIT",
|
|
191
|
-
"optional": true,
|
|
192
|
-
"os": [
|
|
193
|
-
"win32"
|
|
194
|
-
],
|
|
195
|
-
"engines": {
|
|
196
|
-
"node": ">=10"
|
|
197
|
-
}
|
|
198
|
-
},
|
|
199
|
-
"node_modules/@swc/core-win32-x64-msvc": {
|
|
200
|
-
"version": "1.15.8",
|
|
201
|
-
"resolved": "https://registry.npmjs.org/@swc/core-win32-x64-msvc/-/core-win32-x64-msvc-1.15.8.tgz",
|
|
202
|
-
"integrity": "sha512-GpMePrh9Sl4d61o4KAHOOv5is5+zt6BEXCOCgs/H0FLGeii7j9bWDE8ExvKFy2GRRZVNR1ugsnzaGWHKM6kuzA==",
|
|
203
|
-
"cpu": [
|
|
204
|
-
"x64"
|
|
205
|
-
],
|
|
206
|
-
"license": "Apache-2.0 AND MIT",
|
|
207
|
-
"optional": true,
|
|
208
|
-
"os": [
|
|
209
|
-
"win32"
|
|
210
|
-
],
|
|
211
|
-
"engines": {
|
|
212
|
-
"node": ">=10"
|
|
213
|
-
}
|
|
214
|
-
},
|
|
215
|
-
"node_modules/@swc/counter": {
|
|
216
|
-
"version": "0.1.3",
|
|
217
|
-
"resolved": "https://registry.npmjs.org/@swc/counter/-/counter-0.1.3.tgz",
|
|
218
|
-
"integrity": "sha512-e2BR4lsJkkRlKZ/qCHPw9ZaSxc0MVUd7gtbtaB7aMvHeJVYe8sOB8DBZkP2DtISHGSku9sCK6T6cnY0CtXrOCQ==",
|
|
219
|
-
"license": "Apache-2.0"
|
|
220
|
-
},
|
|
221
|
-
"node_modules/@swc/types": {
|
|
222
|
-
"version": "0.1.25",
|
|
223
|
-
"resolved": "https://registry.npmjs.org/@swc/types/-/types-0.1.25.tgz",
|
|
224
|
-
"integrity": "sha512-iAoY/qRhNH8a/hBvm3zKj9qQ4oc2+3w1unPJa2XvTK3XjeLXtzcCingVPw/9e5mn1+0yPqxcBGp9Jf0pkfMb1g==",
|
|
225
|
-
"license": "Apache-2.0",
|
|
226
|
-
"dependencies": {
|
|
227
|
-
"@swc/counter": "^0.1.3"
|
|
228
|
-
}
|
|
229
|
-
}
|
|
230
|
-
}
|
|
231
|
-
}
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
# Supabase Postgres Best Practices
|
|
2
|
-
|
|
3
|
-
## Structure
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
supabase-postgres-best-practices/
|
|
7
|
-
SKILL.md # Main skill file - read this first
|
|
8
|
-
AGENTS.md # This navigation guide
|
|
9
|
-
CLAUDE.md # Symlink to AGENTS.md
|
|
10
|
-
references/ # Detailed reference files
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
## Usage
|
|
14
|
-
|
|
15
|
-
1. Read `SKILL.md` for the main skill instructions
|
|
16
|
-
2. Browse `references/` for detailed documentation on specific topics
|
|
17
|
-
3. Reference files are loaded on-demand - read only what you need
|
|
18
|
-
|
|
19
|
-
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.
|
|
20
|
-
|
|
21
|
-
## When to Apply
|
|
22
|
-
|
|
23
|
-
Reference these guidelines when:
|
|
24
|
-
- Writing SQL queries or designing schemas
|
|
25
|
-
- Implementing indexes or query optimization
|
|
26
|
-
- Reviewing database performance issues
|
|
27
|
-
- Configuring connection pooling or scaling
|
|
28
|
-
- Optimizing for Postgres-specific features
|
|
29
|
-
- Working with Row-Level Security (RLS)
|
|
30
|
-
|
|
31
|
-
## Rule Categories by Priority
|
|
32
|
-
|
|
33
|
-
| Priority | Category | Impact | Prefix |
|
|
34
|
-
|----------|----------|--------|--------|
|
|
35
|
-
| 1 | Query Performance | CRITICAL | `query-` |
|
|
36
|
-
| 2 | Connection Management | CRITICAL | `conn-` |
|
|
37
|
-
| 3 | Security & RLS | CRITICAL | `security-` |
|
|
38
|
-
| 4 | Schema Design | HIGH | `schema-` |
|
|
39
|
-
| 5 | Concurrency & Locking | MEDIUM-HIGH | `lock-` |
|
|
40
|
-
| 6 | Data Access Patterns | MEDIUM | `data-` |
|
|
41
|
-
| 7 | Monitoring & Diagnostics | LOW-MEDIUM | `monitor-` |
|
|
42
|
-
| 8 | Advanced Features | LOW | `advanced-` |
|
|
43
|
-
|
|
44
|
-
## How to Use
|
|
45
|
-
|
|
46
|
-
Read individual rule files for detailed explanations and SQL examples:
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
references/query-missing-indexes.md
|
|
50
|
-
references/schema-partial-indexes.md
|
|
51
|
-
references/_sections.md
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Each rule file contains:
|
|
55
|
-
- Brief explanation of why it matters
|
|
56
|
-
- Incorrect SQL example with explanation
|
|
57
|
-
- Correct SQL example with explanation
|
|
58
|
-
- Optional EXPLAIN output or metrics
|
|
59
|
-
- Additional context and references
|
|
60
|
-
- Supabase-specific notes (when applicable)
|
|
61
|
-
|
|
62
|
-
## References
|
|
63
|
-
|
|
64
|
-
- https://www.postgresql.org/docs/current/
|
|
65
|
-
- https://supabase.com/docs
|
|
66
|
-
- https://wiki.postgresql.org/wiki/Performance_Optimization
|
|
67
|
-
- https://supabase.com/docs/guides/database/overview
|
|
68
|
-
- https://supabase.com/docs/guides/auth/row-level-security
|
|
Binary file
|