Smithery is now a part of Arcade.dev! Read more in our announcement here
Community superstitions - unverified observations from pattern development. Use when encountering undocumented edge cases or framework quirks not in official docs...
Location: community-docs/ in community-patterns repo
CRITICAL: These are NOT official framework documentation. Always check
~/Code/labs/docs/common/ first.
Community docs capture empirical observations discovered during pattern development - unverified things that seemed to work but may be coincidence or context-specific.
Location: superstitions/
Single observations only. May be wrong, incomplete, or context-specific.
After checking official labs/docs/ first:
Do NOT consult before official docs - labs/docs/ is always more authoritative!
# Search superstitions
grep -r "Cell.*handler" community-docs/superstitions/
# List superstitions by topic
ls community-docs/superstitions/ | grep "types-"
ls community-docs/superstitions/ | grep "reactivity-"
Upstream it to labs docs instead of keeping it here:
~/Code/labs/docs/common/The goal is for verified knowledge to live in official docs, not here.
Only after solving something not in any docs:
Search first - Check it's not already documented:
grep -r "your topic" ~/Code/labs/docs/common/
grep -r "your topic" community-docs/superstitions/
Create file:
community-docs/superstitions/YYYY-MM-DD-topic-brief-description.md
types-, reactivity-, jsx-, handlers-, llm-,
patterns-, etc.Copy template from community-docs/superstitions/README.md
Include full ⚠️ disclaimer at top
Document:
Commit: "Add superstition: [brief description]"
Remember: You're creating a hypothesis, not stating fact! Be humble about uncertainty.
The blessed/ and folk_wisdom/ directories are deprecated. Previously we
had a three-tier promotion system. Now, verified knowledge should be upstreamed
directly to labs docs.
Skepticism is critical:
Do NOT:
DO:
Superstitions are a safety net for edge cases, not a primary reference!
