@daniel-da-silva-alves/sddk 2.0.0 → 2.1.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 (30) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/README.md +21 -4
  3. package/bin/cli.js +4 -4
  4. package/package.json +7 -2
  5. package/sddk/plugin.json +1 -1
  6. package/sddk/skills/code-review/SKILL.md +142 -141
  7. package/sddk/skills/code-review/references/anti-ai-design-patterns.md +90 -90
  8. package/sddk/skills/code-review/references/refactoring-severity-guide.md +60 -60
  9. package/sddk/skills/code-review/references/security-checklist.md +59 -59
  10. package/sddk/skills/fullstack-development/SKILL.md +79 -78
  11. package/sddk/skills/fullstack-development/references/clean-code-rules.md +65 -65
  12. package/sddk/skills/fullstack-development/references/self-review-checklist.md +42 -42
  13. package/sddk/skills/implementation-planning/SKILL.md +65 -64
  14. package/sddk/skills/implementation-planning/references/manual-tests-template.md +53 -53
  15. package/sddk/skills/implementation-planning/references/microtask-template.md +47 -47
  16. package/sddk/skills/software-requirements-specification/SKILL.md +46 -45
  17. package/sddk/skills/software-requirements-specification/references/checklist-template.md +48 -48
  18. package/sddk/skills/software-requirements-specification/references/ieee-830-template.md +94 -94
  19. package/sddk/skills/software-requirements-specification/references/socratic-interview-guide.md +65 -65
  20. package/sddk/skills/system-design-document/SKILL.md +108 -107
  21. package/sddk/skills/system-design-document/references/architecture-patterns.md +59 -59
  22. package/sddk/skills/system-design-document/references/documentation-sources-guide.md +69 -69
  23. package/sddk/skills/system-design-document/references/sdd-template.md +117 -117
  24. package/sddk/skills/system-design-document/references/standards-api-template.md +47 -47
  25. package/sddk/skills/system-design-document/references/standards-architecture-template.md +42 -42
  26. package/sddk/skills/system-design-document/references/standards-coding-template.md +64 -64
  27. package/sddk/skills/system-design-document/references/standards-design-system-template.md +81 -81
  28. package/sddk/skills/system-design-document/references/standards-naming-template.md +59 -59
  29. package/sddk/skills/system-design-document/references/standards-onboarding-guide.md +80 -80
  30. package/sddk/skills/system-design-document/references/tech-stack-analysis.md +37 -37
package/sddk/skills/system-design-document/references/tech-stack-analysis.md CHANGED
@@ -1,12 +1,12 @@
1
- # Guia de Análise e Sugestão de Stack Tecnológica
1
+ # Technology Stack Analysis and Suggestion Guide
2
2
 
3
- ## Como Detectar a Stack Existente
3
+ ## How to Detect the Existing Stack
4
4
 
5
- Antes de sugerir qualquer tecnologia, analise o projeto existente do usuário:
5
+ Before suggesting any technology, analyze the user's existing project:
6
6
 
7
- ### Arquivos Indicadores
7
+ ### Indicator Files
8
8
 
9
- | Arquivo | Indica |
9
+ | File | Indicates |
10
10
  |:---|:---|
11
11
  | `package.json` | Node.js / JavaScript / TypeScript |
12
12
  | `tsconfig.json` | TypeScript |
@@ -17,22 +17,22 @@ Antes de sugerir qualquer tecnologia, analise o projeto existente do usuário:
17
17
  | `Gemfile` | Ruby |
18
18
  | `composer.json` | PHP |
19
19
 
20
- ### Dentro do `package.json` — Detectar Framework
20
+ ### Inside `package.json` — Detect Framework
21
21
 
22
- | Dependência | Framework |
22
+ | Dependency | Framework |
23
23
  |:---|:---|
24
24
  | `next` | Next.js |
25
25
  | `nuxt` | Nuxt.js |
26
- | `react` (sem next) | React SPA (provavelmente Vite) |
27
- | `vue` (sem nuxt) | Vue.js SPA |
26
+ | `react` (without next) | React SPA (probably Vite) |
27
+ | `vue` (without nuxt) | Vue.js SPA |
28
28
  | `@angular/core` | Angular |
29
29
  | `express` | Express.js |
30
30
  | `@nestjs/core` | NestJS |
31
31
  | `fastify` | Fastify |
32
32
 
33
- ### Dentro do `requirements.txt` / `pyproject.toml` — Detectar Framework Python
33
+ ### Inside `requirements.txt` / `pyproject.toml` — Detect Python Framework
34
34
 
35
- | Dependência | Framework |
35
+ | Dependency | Framework |
36
36
  |:---|:---|
37
37
  | `django` | Django |
38
38
  | `fastapi` | FastAPI |
@@ -41,44 +41,44 @@ Antes de sugerir qualquer tecnologia, analise o projeto existente do usuário:
41
41
 
42
42
  ---
43
43
 
44
- ## Como Sugerir Stack (Quando Não Há Projeto)
44
+ ## How to Suggest a Stack (When There's No Project)
45
45
 
46
- Se o usuário está começando do zero, use estas perguntas para guiar a sugestão:
46
+ If the user is starting from scratch, use these questions to guide the suggestion:
47
47
 
48
- ### Pergunta 1: Tipo de Aplicação
48
+ ### Question 1: Application Type
49
49
 
50
- | Tipo | Stack Sugerida |
50
+ | Type | Suggested Stack |
51
51
  |:---|:---|
52
52
  | **Web fullstack (SSR)** | Next.js + TypeScript + Prisma + PostgreSQL |
53
- | **Web SPA + API separada** | Vite + React + TypeScript (front) + NestJS ou FastAPI (back) |
54
- | **API/Backend only** | NestJS (TS) ou FastAPI (Python) |
55
- | **Mobile** | React Native + Expo ou Flutter |
56
- | **CLI tool** | Node.js + Commander ou Python + Click |
53
+ | **Web SPA + separate API** | Vite + React + TypeScript (front) + NestJS or FastAPI (back) |
54
+ | **API/Backend only** | NestJS (TS) or FastAPI (Python) |
55
+ | **Mobile** | React Native + Expo or Flutter |
56
+ | **CLI tool** | Node.js + Commander or Python + Click |
57
57
 
58
- ### Pergunta 2: Prioridades do Projeto
58
+ ### Question 2: Project Priorities
59
59
 
60
- | Prioridade | Influência na Stack |
60
+ | Priority | Stack Influence |
61
61
  |:---|:---|
62
- | **Performance** | Considerar Rust, Go, ou otimizações específicas |
63
- | **Velocidade de desenvolvimento** | Frameworks com mais abstrações (Next.js, Django) |
64
- | **Escalabilidade** | Microserviços, filas, cache distribuído |
65
- | **Simplicidade** | Monolito, ORM, framework full-featured |
62
+ | **Performance** | Consider Rust, Go, or specific optimizations |
63
+ | **Development speed** | Frameworks with more abstractions (Next.js, Django) |
64
+ | **Scalability** | Microservices, queues, distributed cache |
65
+ | **Simplicity** | Monolith, ORM, full-featured framework |
66
66
 
67
- ### Pergunta 3: Equipe
67
+ ### Question 3: Team
68
68
 
69
- | Contexto | Influência |
69
+ | Context | Influence |
70
70
  |:---|:---|
71
- | Dev solo | Menos abstrações, full-stack frameworks |
72
- | Equipe pequena (2-5) | Monorepo, TypeScript end-to-end |
73
- | Equipe grande (5+) | Módulos bem definidos, CI/CD robusto |
71
+ | Solo dev | Fewer abstractions, full-stack frameworks |
72
+ | Small team (2-5) | Monorepo, end-to-end TypeScript |
73
+ | Large team (5+) | Well-defined modules, robust CI/CD |
74
74
 
75
75
  ---
76
76
 
77
- ## Regras para Sugestão
77
+ ## Suggestion Rules
78
78
 
79
- 1. **NUNCA sugira uma stack sem justificativa** — sempre explique o "porquê"
80
- 2. **Considere a experiência do usuário** — não sugira Rust se o usuário é iniciante
81
- 3. **Apresente no máximo 3 opções** — excesso de escolha paralisa
82
- 4. **Inclua prós e contras** de cada opção
83
- 5. **Use `ask_question`** para que o usuário escolha formalmente
84
- 6. **Registre a decisão** com justificativa no SDD
79
+ 1. **NEVER suggest a stack without justification** — always explain the "why"
80
+ 2. **Consider the user's experience** — don't suggest Rust if the user is a beginner
81
+ 3. **Present at most 3 options** — excess choice paralyzes
82
+ 4. **Include pros and cons** of each option
83
+ 5. **Use `ask_question`** so the user can formally choose
84
+ 6. **Record the decision** with justification in the SDD