@riligar/agents-kit 1.0.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 (59) hide show
  1. package/.agent/skills/riligar-design-system/SKILL.md +55 -0
  2. package/.agent/skills/riligar-design-system/assets/theme.js +113 -0
  3. package/.agent/skills/riligar-design-system/references/anti-patterns.md +36 -0
  4. package/.agent/skills/riligar-design-system/references/design-system.md +113 -0
  5. package/.agent/skills/riligar-design-system/references/images/1R2bQt3sbej3wnOY1CzfuxBTFGs.jpeg +0 -0
  6. package/.agent/skills/riligar-design-system/references/images/AMHVTwvXORjj3X8El59HL1MsjA.jpeg +0 -0
  7. package/.agent/skills/riligar-design-system/references/images/E4BSw6KHGDGMwsyv95cOa9bcta0.jpeg +0 -0
  8. package/.agent/skills/riligar-design-system/references/images/EwwLnyjifpH8aT4o9OYb4zmuU.jpeg +0 -0
  9. package/.agent/skills/riligar-design-system/references/images/JXpiVPGQAlCoSPheFiv7XIo.jpeg +0 -0
  10. package/.agent/skills/riligar-design-system/references/images/K3aMG2lUKgIMnch6nKHeyaNkY.jpeg +0 -0
  11. package/.agent/skills/riligar-design-system/references/images/PjZ3v7ODdeBewzcBtIB1CwSwY.jpeg +0 -0
  12. package/.agent/skills/riligar-design-system/references/images/St7v862tpyR6MnIY3Lvr0jkd8I.jpeg +0 -0
  13. package/.agent/skills/riligar-design-system/references/images/WLmykbH6cFIJQ2logW1FiST1K3g.jpeg +0 -0
  14. package/.agent/skills/riligar-design-system/references/images/XHjqY7bWbsoyHD8E8K5p0Wm8kWA.jpeg +0 -0
  15. package/.agent/skills/riligar-design-system/references/images/dgn7biiYdKjxwkYGC84E3APk63Q.jpeg +0 -0
  16. package/.agent/skills/riligar-design-system/references/images/dgn7biiYdKjxwkYGC84E3APk63Q_sips.jpeg +0 -0
  17. package/.agent/skills/riligar-design-system/references/images/ioNOnyTfpolkwrFsdoBVsMGQ.jpeg +0 -0
  18. package/.agent/skills/riligar-design-system/references/images/xJVNp4LsZrmOYqTYgnj82rglWcA.jpeg +0 -0
  19. package/.agent/skills/riligar-design-system/references/master-patterns.md +140 -0
  20. package/.agent/skills/riligar-design-system/references/visual-references.md +71 -0
  21. package/.agent/skills/riligar-dev-autopilot/SKILL.md +63 -0
  22. package/.agent/skills/riligar-dev-landing-page/SKILL.md +53 -0
  23. package/.agent/skills/riligar-dev-landing-page/assets/original-2a03320f967a884fd2ad275d788f32e5.webp +0 -0
  24. package/.agent/skills/riligar-dev-landing-page/assets/original-481d7179109272dcaff2516fef62b718.webp +0 -0
  25. package/.agent/skills/riligar-dev-landing-page/assets/original-56d848520060ca714456601d1a7417cd.webp +0 -0
  26. package/.agent/skills/riligar-dev-landing-page/assets/original-93104cd260129cd6b76dac4119622eaf.webp +0 -0
  27. package/.agent/skills/riligar-dev-landing-page/assets/original-c5d259b0497cec98c36c48fc33ebbde6.webp +0 -0
  28. package/.agent/skills/riligar-dev-landing-page/assets/original-e865b2464fdf5ca567af716e1ed4fd16.webp +0 -0
  29. package/.agent/skills/riligar-dev-landing-page/assets/original-f1459f5315f0045705c2ca4937204146.webp +0 -0
  30. package/.agent/skills/riligar-dev-landing-page/assets/original-f67954754fdc2fc57009369fd3437205.webp +0 -0
  31. package/.agent/skills/riligar-dev-landing-page/assets/screencapture-caddaddy-app-2025-11-03-20_16_14.webp +0 -0
  32. package/.agent/skills/riligar-dev-landing-page/assets/screencapture-ciromaciel-click-2026-01-06-17_08_01.webp +0 -0
  33. package/.agent/skills/riligar-dev-landing-page/assets/screencapture-notionsecondbrain-2026-01-06-16_07_56.webp +0 -0
  34. package/.agent/skills/riligar-dev-landing-page/assets/screencapture-skillsmp-2026-01-16-14_40_22.webp +0 -0
  35. package/.agent/skills/riligar-dev-landing-page/references/conversion-framework.md +39 -0
  36. package/.agent/skills/riligar-dev-landing-page/references/copywriting-guide.md +38 -0
  37. package/.agent/skills/riligar-dev-landing-page/references/section-blueprints.md +56 -0
  38. package/.agent/skills/riligar-dev-seo/SKILL.md +200 -0
  39. package/.agent/skills/riligar-dev-seo/references/checklist.md +87 -0
  40. package/.agent/skills/riligar-dev-seo/references/implementation.md +215 -0
  41. package/.agent/skills/riligar-dev-seo/references/structured-data.md +119 -0
  42. package/.agent/skills/riligar-infrastructure/SKILL.md +126 -0
  43. package/.agent/skills/riligar-infrastructure/references/infrastructure.md +229 -0
  44. package/.agent/skills/riligar-marketing-copy/SKILL.md +117 -0
  45. package/.agent/skills/riligar-marketing-copy/references/examples.md +256 -0
  46. package/.agent/skills/riligar-marketing-copy/references/style-guide.md +112 -0
  47. package/.agent/skills/riligar-tech-stack/SKILL.md +114 -0
  48. package/.agent/skills/riligar-tech-stack/references/tech-stack.md +131 -0
  49. package/.agent/skills/skill-creator/LICENSE.txt +202 -0
  50. package/.agent/skills/skill-creator/SKILL.md +356 -0
  51. package/.agent/skills/skill-creator/references/output-patterns.md +82 -0
  52. package/.agent/skills/skill-creator/references/workflows.md +28 -0
  53. package/.agent/skills/skill-creator/scripts/init_skill.py +303 -0
  54. package/.agent/skills/skill-creator/scripts/package_skill.py +110 -0
  55. package/.agent/skills/skill-creator/scripts/quick_validate.py +95 -0
  56. package/LICENSE +201 -0
  57. package/README.md +39 -0
  58. package/bin/cli.js +66 -0
  59. package/package.json +62 -0
@@ -0,0 +1,117 @@
1
+ ---
2
+ name: riligar-marketing-copy
3
+ description: Generate compelling marketing copy using the Elevated Direct Response framework. Use this skill when creating landing pages, headlines, email campaigns, ad copy, CTAs, value propositions, or any persuasive marketing content. Applies contrarian educator tone and direct response principles.
4
+ allowed-tools: Read, Glob, Grep, Write, Edit
5
+ ---
6
+
7
+ # Elevated Direct Response Copywriter
8
+
9
+ You are an expert direct response copywriter. Generate compelling marketing copy following the Elevated Direct Response framework.
10
+
11
+ ## Copy Elements Framework
12
+
13
+ | Element | Approach |
14
+ | ------------ | ------------------------------------ |
15
+ | **HEADLINE** | Contrarian hook + specific promise |
16
+ | **SUBHEAD** | Specifics + proof + friction reducer |
17
+ | **BODY** | Short paragraphs, operator voice |
18
+ | **PROOF** | Numbers > testimonials > claims |
19
+ | **CTA** | Action verb + what they get + → |
20
+
21
+ ## Tone & Style
22
+
23
+ - **TONE**: Smart friend who built it themselves
24
+ - **AVOID**: Corporate jargon, guru hype, vague language
25
+ - **ALWAYS**: Specificity, systems thinking, proof
26
+ - **NEVER**: Inflated claims, fake scarcity, fluff
27
+
28
+ ## Core Principles
29
+
30
+ ### 1. Contrarian Educator
31
+
32
+ - Use "boring" as antidote to shiny object syndrome
33
+ - Focus on compound growth while operating on bleeding edge
34
+ - Challenge conventional wisdom with data and logic
35
+
36
+ ### 2. Direct Response DNA
37
+
38
+ - Long-form when needed, speak to ONE person
39
+ - Clear CTAs that tell them exactly what to do
40
+ - Benefit-driven, story-led, objection-handling
41
+ - Every sentence earns the next sentence
42
+
43
+ ### 3. Systems Over Hacks
44
+
45
+ - Workflows > tactics, automation > manual
46
+ - "Build once, distribute forever" mindset
47
+ - Show the system, not just the result
48
+
49
+ ### 4. Creator-First Language
50
+
51
+ - Real person sharing discoveries, not corporate brand
52
+ - Include vulnerabilities, learning moments, specific examples
53
+ - Write like you're texting a smart friend
54
+
55
+ ## Landing Page Structure
56
+
57
+ When creating full landing pages, use this 8-section structure:
58
+
59
+ ### 1. HERO
60
+
61
+ - Eyebrow → Headline → Subheadline → CTA → Trust Signals
62
+ - **Job:** Get email or get scroll
63
+
64
+ ### 2. SUCCESS (conditional - post-signup)
65
+
66
+ - Checkmark → Confirmation → Deliverable list
67
+ - **Job:** Kill Buyer's remorse
68
+
69
+ ### 3. PROBLEM-AGITATE
70
+
71
+ - 3 problems with agitation → Personal transition
72
+ - **Job:** Make status quo painful
73
+
74
+ ### 4. VALUE STACK
75
+
76
+ - 4 tiers descending → Total value → Your price
77
+ - **Job:** Make saying no feel stupid
78
+
79
+ ### 5. SOCIAL PROOF
80
+
81
+ - Header → 3 testimonials with specific results
82
+ - **Job:** Let others convince them
83
+
84
+ ### 6. TRANSFORMATION
85
+
86
+ - 4 stages: Quick win → Compound → Advantage → 10x
87
+ - **Job:** Make outcome tangible
88
+
89
+ ### 7. SECONDARY CTA
90
+
91
+ - Anchor stack → Question headline → "Yes" button
92
+ - **Job:** Catch the scrollers
93
+
94
+ ### 8. FOOTER
95
+
96
+ - Logo → Nav → Legal → Social
97
+ - **Job:** Professional legitimacy
98
+
99
+ ## Process
100
+
101
+ 1. **Gather Context**: Ask about target audience, product/service, proof points, and desired action
102
+ 2. **Apply Framework**: Use the Elevated Direct Response principles
103
+ 3. **Generate Options**: Provide multiple variations when appropriate
104
+ 4. **Optimize**: Focus on specificity and conversion
105
+
106
+ ## Resources
107
+
108
+ - **Exemplos**: Veja [references/examples.md](references/examples.md) para modelos de headlines, subheadlines, body copy e CTAs.
109
+ - **Guia de Estilo**: Consulte [references/style-guide.md](references/style-guide.md) para diretrizes detalhadas sobre tom de voz, ritmo e palavras a evitar.
110
+
111
+ ## Clarifying Questions to Ask
112
+
113
+ - Who is the target audience (be specific)?
114
+ - What specific problem does this solve?
115
+ - What proof points/numbers can we use?
116
+ - What's the primary CTA/desired action?
117
+ - What objections might they have?
@@ -0,0 +1,256 @@
1
+ # Marketing Copy Examples
2
+
3
+ ## Headlines (Contrarian Hook + Specific Promise)
4
+
5
+ **Bad (Generic)**:
6
+
7
+ - "The Best AI Tool for Your Business"
8
+ - "Transform Your Workflow Today"
9
+
10
+ **Good (Elevated Direct Response)**:
11
+
12
+ - "I Deleted 47 Apps and Built a $2M Business with Spreadsheets"
13
+ - "Why 'Boring' Marketing Beats Viral Content (My 3-Year Case Study)"
14
+ - "The $0 Tool That Replaced My $500/mo Tech Stack"
15
+
16
+ ### Product-Specific Headlines
17
+
18
+ **Hero Headlines:**
19
+
20
+ - "Skip the $400 Photographer. Get 40 Headshots for $19."
21
+ - "Your LinkedIn Photo Is 3 Years Old. Fix It in 2 Hours."
22
+ - "Look Like You Have a PR Team. Spend $19."
23
+
24
+ **LinkedIn Ad Headlines:**
25
+
26
+ - "40 Professional Headshots. $19. 2 Hours."
27
+ - "I Paid $400 for a Photographer. Then Found This."
28
+ - "Your Profile Photo Is Costing You Interviews"
29
+
30
+ **Email Subject Lines:**
31
+
32
+ - "The real cost of your 2019 headshot"
33
+ - "3 new clients in 4 days (one photo change)"
34
+ - "Your competitors updated their headshots"
35
+
36
+ ## Subheadlines (Specifics + Proof + Friction Reducer)
37
+
38
+ **Bad**:
39
+
40
+ - "Sign up to learn more"
41
+
42
+ **Good**:
43
+
44
+ - "Join 12,847 founders who get the weekly breakdown. Free. No spam. Unsubscribe anytime."
45
+ - "The exact 5-step system I used to grow from $0 to $47k MRR. Takes 10 minutes to implement."
46
+
47
+ ## Body Copy (Short Paragraphs, Operator Voice)
48
+
49
+ **Bad**:
50
+
51
+ ```
52
+ Our innovative solution leverages cutting-edge technology to deliver
53
+ best-in-class results for your organization's digital transformation journey.
54
+ ```
55
+
56
+ **Good**:
57
+
58
+ ```
59
+ Here's what actually happened:
60
+
61
+ I spent 6 months building the "perfect" system.
62
+ It had 12 integrations, 3 automation tools, and a 47-step workflow.
63
+
64
+ Then I deleted everything and started over.
65
+
66
+ The result? 3x the output with 1/10th the complexity.
67
+ ```
68
+
69
+ ## CTAs (Action Verb + What They Get + →)
70
+
71
+ **Bad**:
72
+
73
+ - "Submit"
74
+ - "Learn More"
75
+ - "Click Here"
76
+
77
+ **Good**:
78
+
79
+ - "Get the free template →"
80
+ - "Start your 14-day trial (no card required) →"
81
+ - "Download the 2024 benchmark report →"
82
+ - "See the exact workflow →"
83
+
84
+ ## Problem-Agitate Section
85
+
86
+ **Template**:
87
+
88
+ ```
89
+ You've tried [common solution #1]. Didn't work.
90
+ You've tried [common solution #2]. Still stuck.
91
+ You've even tried [common solution #3]. Nothing.
92
+
93
+ The problem isn't you. It's the approach.
94
+
95
+ [Personal transition story]
96
+
97
+ That's when I discovered [insight].
98
+ ```
99
+
100
+ **Example**:
101
+
102
+ ```
103
+ You've tried posting every day. Crickets.
104
+ You've tried the trending audio. 47 views.
105
+ You've even hired that "growth expert." $2,000 gone.
106
+
107
+ The problem isn't your content. It's the distribution.
108
+
109
+ I spent 18 months building an audience of 200 people.
110
+ Then I changed ONE thing and hit 50,000 in 90 days.
111
+
112
+ That's when I discovered: systems beat hustle.
113
+ ```
114
+
115
+ ## Value Stack
116
+
117
+ **Format**:
118
+
119
+ ```
120
+ What you get:
121
+
122
+ ✓ [Core deliverable] - Value $X
123
+ ✓ [Bonus #1] - Value $X
124
+ ✓ [Bonus #2] - Value $X
125
+ ✓ [Bonus #3] - Value $X
126
+
127
+ Total value: $X,XXX
128
+
129
+ Your investment: $XX
130
+ ```
131
+
132
+ ## Social Proof (Specific Results)
133
+
134
+ **Bad**:
135
+
136
+ - "Great product!" - John D.
137
+ - "Highly recommend" - Sarah
138
+
139
+ **Good**:
140
+
141
+ - "Went from 0 to 1,247 subscribers in 60 days using this exact system." - John D., Founder @ StartupX
142
+ - "Cut my content creation time from 20 hours/week to 4. The ROI paid for itself in week one." - Sarah M., Marketing Director
143
+
144
+ ### Product-Specific Testimonials
145
+
146
+ **Template**: [Specific result] + [Comparison/context] + [Name, Role]
147
+
148
+ **Examples:**
149
+
150
+ - "Spent $400 on a photographer last year. Got 12 usable shots. This gave me 40 for $19." - Marcus T., Startup CEO
151
+ - "Updated my LinkedIn photo on Tuesday. Had 3 new client inquiries by Friday." - Jennifer W., Financial Advisor
152
+ - "My partners couldn't tell the difference from studio photos. Neither could my mom." - David K., Attorney at Law
153
+ - "Got corporate for LinkedIn, friendly for Zillow, professional for my website. One upload, 8 different looks." - Rachel S., Real Estate Agent
154
+
155
+ ---
156
+
157
+ ## Ad Copy Templates
158
+
159
+ ### LinkedIn Single Image Ad
160
+
161
+ ```
162
+ Your LinkedIn photo is from 2019.
163
+ Before the promotion. Before the haircut.
164
+ Before you looked like someone who knows what they're doing.
165
+
166
+ Professional photographers charge $300-500.
167
+ For 10-20 photos.
168
+ One outfit. One background.
169
+ Two weeks of scheduling.
170
+
171
+ Or: Upload 5 selfies.
172
+ Get 40 studio-quality headshots.
173
+ $19. Ready in 2 hours.
174
+
175
+ 196,000+ professionals already upgraded.
176
+ 14-day money-back guarantee.
177
+
178
+ Get your headshots →
179
+ ```
180
+
181
+ ### Google Search Ad
182
+
183
+ ```
184
+ Headline 1: 40 AI Headshots for $19
185
+ Headline 2: Skip the $400 Photographer
186
+ Headline 3: Ready in 2 Hours
187
+ Description: Upload 5 selfies, get 40 professional headshots. 4 styles. Full commercial rights. 14-day guarantee. Trusted by 196K+ professionals.
188
+ ```
189
+
190
+ ### Email - Abandoned Cart
191
+
192
+ ```
193
+ Subject: Your headshots are waiting
194
+
195
+ You uploaded your photos but didn't finish.
196
+
197
+ I get it. Maybe you're wondering if they'll actually look good.
198
+
199
+ Here's what 196,000+ professionals discovered:
200
+ → Results indistinguishable from $400 studio photos
201
+ → 4 different styles from one upload
202
+ → Ready in 2 hours, not 2 weeks
203
+ → 14-day money-back guarantee (no questions)
204
+
205
+ Your photos are still saved. Pick up where you left off:
206
+ [Continue →]
207
+
208
+ The worst that happens? You get your $19 back.
209
+ The best? You finally have a headshot that matches your career.
210
+
211
+ - The Team
212
+ ```
213
+
214
+ ### Twitter/X Thread Opening
215
+
216
+ ```
217
+ I spent $400 on a professional photographer last year.
218
+
219
+ Got 12 usable photos.
220
+ Waited 3 weeks.
221
+ Had to take a half-day off work.
222
+
223
+ Yesterday I got 40 AI headshots for $19 in 2 hours.
224
+
225
+ My partners can't tell the difference.
226
+
227
+ Here's what I learned 🧵
228
+ ```
229
+
230
+ ---
231
+
232
+ ## Segment-Specific Messaging
233
+
234
+ ### Job Seekers
235
+
236
+ **Pain:** Need professional image fast, on a budget
237
+ **Message:** "Land your dream job. Look the part."
238
+ **Proof:** "Your profile photo affects interview callbacks by 40%"
239
+
240
+ ### Founders/Entrepreneurs
241
+
242
+ **Pain:** Bootstrap mentality, time-poor, image matters for funding
243
+ **Message:** "Look funded. Spend $19."
244
+ **Proof:** "First impressions matter. VCs check your LinkedIn before the pitch."
245
+
246
+ ### Sales Professionals
247
+
248
+ **Pain:** Profile views = pipeline, trust signals matter
249
+ **Message:** "More profile views = more pipeline"
250
+ **Proof:** "3 new clients in 4 days. One new headshot."
251
+
252
+ ### Real Estate/Financial Advisors
253
+
254
+ **Pain:** Multiple platforms, trust-based business
255
+ **Message:** "One upload. Every platform covered."
256
+ **Proof:** "8 different looks for LinkedIn, Zillow, and your website."
@@ -0,0 +1,112 @@
1
+ # Elevated Direct Response Style Guide
2
+
3
+ ## Voice Characteristics
4
+
5
+ ### DO
6
+
7
+ - Write like a smart friend texting you
8
+ - Use specific numbers ("47 apps" not "many apps")
9
+ - Share the system, not just the result
10
+ - Include your failures and learning moments
11
+ - Use short sentences. Like this.
12
+ - Break paragraphs after 2-3 lines max
13
+ - Lead with contrarian takes backed by data
14
+
15
+ ### DON'T
16
+
17
+ - Sound like a corporation ("leverage synergies")
18
+ - Use vague superlatives ("best-in-class", "world-class")
19
+ - Promise without proof
20
+ - Write long, dense paragraphs
21
+ - Use fake urgency ("Only 3 spots left!")
22
+ - Add unnecessary exclamation marks!!!
23
+
24
+ ## Sentence Structure
25
+
26
+ **Vary length for rhythm:**
27
+
28
+ ```
29
+ Long sentence that sets up the context and gives background.
30
+ Short punch.
31
+ Another longer sentence that expands on the point.
32
+ Then this.
33
+ ```
34
+
35
+ **Use fragments intentionally:**
36
+
37
+ ```
38
+ The result?
39
+ 3x growth. Half the effort. Zero burnout.
40
+ ```
41
+
42
+ ## Formatting Patterns
43
+
44
+ ### Lists
45
+
46
+ Use bullets for scanability:
47
+
48
+ - Start each with an action verb
49
+ - Keep parallel structure
50
+ - End with the strongest point
51
+
52
+ ### Numbers
53
+
54
+ - Specific > round ("$47,293" not "$50,000")
55
+ - Percentages for improvements ("43% faster")
56
+ - Time frames for credibility ("in 90 days")
57
+
58
+ ### Emphasis
59
+
60
+ - **Bold** for key phrases
61
+ - Use sparingly
62
+ - Never bold entire paragraphs
63
+
64
+ ## Words to Avoid
65
+
66
+ | Instead of... | Use... |
67
+ | ------------- | ------------------------------ |
68
+ | Leverage | Use |
69
+ | Utilize | Use |
70
+ | Innovative | [Be specific about what's new] |
71
+ | Best-in-class | [Show the data] |
72
+ | Synergy | [Just explain what happens] |
73
+ | Transform | [Specific outcome] |
74
+ | Revolutionary | [Proof of what changed] |
75
+ | Exclusive | Limited to [specific criteria] |
76
+
77
+ ## Words That Work
78
+
79
+ - Exact ("the exact system")
80
+ - Specific ("this specific approach")
81
+ - Simple ("simple 3-step process")
82
+ - Free (when true)
83
+ - New (when actually new)
84
+ - Now ("available now")
85
+ - Proven ("proven by X")
86
+
87
+ ## Proof Hierarchy
88
+
89
+ **Strongest to weakest:**
90
+
91
+ 1. Specific numbers with context
92
+ 2. Named testimonials with results
93
+ 3. Aggregate data ("12,000+ users")
94
+ 4. Third-party validation (press, awards)
95
+ 5. General testimonials
96
+ 6. Claims without proof (avoid)
97
+
98
+ ## CTA Psychology
99
+
100
+ **Good CTAs answer:**
101
+
102
+ - What will I get?
103
+ - What do I need to do?
104
+ - What happens next?
105
+
106
+ **Formula:** [Action verb] + [What they get] + [→]
107
+
108
+ Examples:
109
+
110
+ - "Download the free checklist →"
111
+ - "Start your trial →"
112
+ - "Get instant access →"
@@ -0,0 +1,114 @@
1
+ ---
2
+ name: riligar-tech-stack
3
+ description: Especialista na Tech Stack da RiLiGar. Use para criar projetos React/Vite, componentes com Mantine, APIs Bun/Elysia, e garantir padrões de código e estrutura de projetos.
4
+ license: Apache-2.0
5
+ metadata:
6
+ author: riligar
7
+ version: '1.0'
8
+ ---
9
+
10
+ # RiLiGar Tech Stack Expert
11
+
12
+ Você é um especialista em desenvolvimento seguindo a stack técnica da RiLiGar. Sua missão é garantir que qualquer código gerado siga os padrões, ferramentas e estruturas definidos.
13
+
14
+ ## 1. Filosofia de Desenvolvimento
15
+
16
+ - **Simplicidade:** Código limpo, legível e fácil de manter.
17
+ - **Modularidade:** Componentes reutilizáveis e bem isolados.
18
+ - **Consistência:** Padrões uniformes em todos os projetos.
19
+ - **Developer Experience:** Ferramentas que aceleram o desenvolvimento.
20
+
21
+ ## 2. Stack Frontend
22
+
23
+ ### Core
24
+
25
+ - **React 19+** (Functional Components, Hooks)
26
+ - **Vite 5+** (Build tool)
27
+ - **JavaScript** (ES6+, sem TypeScript por padrão)
28
+ - **Zustand 5+** (State Management)
29
+ - **React Router 7+** (Routing)
30
+ - **ky 1+** (HTTP client)
31
+
32
+ ### UI & Estilização
33
+
34
+ - **Mantine 8** (Component Library)
35
+ - **Tabler Icons** (Iconografia)
36
+ - **Sem CSS Modules, Custom CSS ou CSS In-line** (user apenas o Mantine)
37
+
38
+ ### Estrutura de Projeto React
39
+
40
+ ```
41
+ src/
42
+ ├── components/ # Componentes reutilizáveis
43
+ ├── pages/ # Páginas/Views
44
+ ├── hooks/ # Custom Hooks
45
+ ├── services/ # API calls e lógica de negócio
46
+ ├── store.js # Estado global (Zustand)
47
+ ├── routes.jsx # Configuração de rotas
48
+ └── index.js # Entry point
49
+ ```
50
+
51
+ ## 3. Stack Backend
52
+
53
+ ### Core
54
+
55
+ - **Bun** (Runtime)
56
+ - **Elysia** (Framework HTTP)
57
+ - **JavaScript** (ES6+, sem TypeScript por padrão)
58
+ - **SQLite** (Database padrão, com bun-sqlite)
59
+ - **Drizzle** (ORM)
60
+
61
+ ### Estrutura de Projeto Backend
62
+
63
+ ```
64
+ src/
65
+ ├── routes/ # Endpoints da API
66
+ ├── services/ # Lógica de negócio
67
+ ├── database/ # Configuração e migrations
68
+ └── index.js # Entry point
69
+ ```
70
+
71
+ ## 4. Ferramentas de Desenvolvimento
72
+
73
+ - **ESLint** (Linting)
74
+ - **Prettier** (Formatação)
75
+ - **Semantic Release** (Versionamento automático)
76
+ - **GitHub Actions** (CI/CD)
77
+
78
+ ```json
79
+ {
80
+ "printWidth": 300,
81
+ "singleAttributePerLine": true,
82
+ "tabWidth": 4,
83
+ "useTabs": false,
84
+ "semi": false,
85
+ "singleQuote": true,
86
+ "quoteProps": "as-needed",
87
+ "trailingComma": "es5",
88
+ "bracketSpacing": true,
89
+ "bracketSameLine": false,
90
+ "arrowParens": "avoid",
91
+ "endOfLine": "lf"
92
+ }
93
+ ```
94
+
95
+ ## 5. Convenções de Código
96
+
97
+ - **Nomes de arquivos:** `kebab-case` para componentes, `camelCase` para utils
98
+ - **Componentes:** PascalCase exportados como default
99
+ - **Funções:** camelCase
100
+ - **Constantes:** UPPER_SNAKE_CASE
101
+
102
+ ## 6. Regras para Geração de Código
103
+
104
+ 1. **SEMPRE** use Mantine para UI components
105
+ 2. **SEMPRE** use Tabler Icons (`@tabler/icons-react`)
106
+ 3. **EVITE** TypeScript, nunca use
107
+ 4. **EVITE** Tailwind CSS, CSS Modules, CSS In-line, nunca use
108
+ 5. **PREFIRA** funções simples sobre classes
109
+ 6. **INCLUA** tratamento de erros adequado
110
+ 7. **EVITE** funções complexas, prefira funções simples
111
+
112
+ ## 7. Referências
113
+
114
+ Para detalhes completos, consulte `references/tech-stack.md`.