sdd-toolkit 1.0.0 → 1.1.0

package/src/lib/docs.js

@@ -1,104 +1,104 @@
-const fs = require('fs');
-const path = require('path');
-const pc = require('picocolors');
-
-/**
- * Gera o guia de workflow e a estrutura de pastas necessária para os agentes
- */
-function generateWorkflowGuide(baseDir) {
-    const docsDir = path.join(baseDir, 'docs');
-    const logsDir = path.join(docsDir, 'logs');
-    
-    // Cria a estrutura de pastas recursivamente (Funciona em Windows, Mac e Linux)
-    if (!fs.existsSync(logsDir)) {
-        fs.mkdirSync(logsDir, { recursive: true });
-    }
-
-    // Conteúdo do README.md
-    const content = `# 🤖 Agent Workflow Guide
-
-Este documento descreve o fluxo de desenvolvimento padrão usando os Agentes instalados.
-O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iterativo** para execução.
-
----
-
-## 1. 🏗️ Project Spec (@Project Architect)
-**Role:** O Visionário.
-**Goal:** Traduzir sua ideia vaga em uma Especificação concreta com "Project Principles" definidos.
-- **Comando:** \\
-/dev:project "Eu quero um App de Todo que..."
-- **Saída:** 
-\`docs/project.md\`
-
-## 2. 🧱 Requirements Engineering (@Requirements Engineer)
-**Role:** O Tech Lead.
-**Goal:** Fechar decisões técnicas (Stack, Banco de Dados, Libs).
-- **Why?** Evita que o Coder "invente" arquitetura. Cria o "Contrato".
-- **Comando:** 
-/dev:requirements
-- **Saída:** 
-\`docs/requirements.md\`
-
-## 3. 🗺️ Roadmap Strategy (@Milestone Manager)
-**Role:** O Estrategista.
-**Goal:** Fatiar o projeto em fases de entrega (MVPs).
-- **Comando:** 
-/dev:milestone
-- **Saída:** 
-\`docs/milestones.md\`
-
-## 4. 📋 Task Planning (@Task Planner)
-**Role:** O Gerente.
-**Goal:** Quebrar um Milestone específico em tarefas atômicas para desenvolvedores.
-- **Why?** IAs falham com contextos gigantes. Tarefas pequenas = Código perfeito.
-- **Comando:** 
-/dev:tasks <Milestone_ID>
-- **Saída:** 
-\`docs/task.md\`
-
-## 5. 🕵️ Blueprint Audit (@Auditor)
-**Role:** O Guardião.
-**Goal:** Validar consistência entre **Requirements** e **Tasks**.
-- **Comando:** 
-/dev:auditor
-- **Saída:** 
-\`audit_report.md\`
-
-## 6. 💻 Implementation (@Coder)
-**Role:** O Construtor.
-**Goal:** Executar *uma tarefa por vez* do arquivo 
-\`task.md\`.
-- **Comando:** 
-/dev:coder <Task_ID>
-- **Buffer:** 
-\`work_log.md\`
-
-## 7. ⚖️ Quality Assurance (@QA Engineer)
-**Role:** O Inspetor.
-**Goal:** Verificar se a implementação bate com os Requisitos.
-- **Comando:** 
-/dev:review <Task_ID>
-- **Saída:** 
-\`docs/logs/review_log.md\`
-
-## 8. 📦 Release Management (@Release Manager)
-**Role:** O Historiador.
-**Goal:** Consolidar o 
-\`work_log.md\` em um 
-\`changelog.md\` permanente.
-- **Comando:** 
-/dev:log
-- **Saída:** 
-\`changelog.md\`
-`;
-
-    const readmePath = path.join(docsDir, 'README.md');
-    if (!fs.existsSync(readmePath)) {
-        fs.writeFileSync(readmePath, content);
-        return true;
-    }
-    
-    return true; // Retorna true indicando que a estrutura foi garantida
-}
-
-module.exports = { generateWorkflowGuide };
+const fs = require('fs');
+const path = require('path');
+const pc = require('picocolors');
+
+/**
+ * Gera o guia de workflow e a estrutura de pastas necessária para os agentes
+ */
+function generateWorkflowGuide(baseDir) {
+    const docsDir = path.join(baseDir, 'docs');
+    const logsDir = path.join(docsDir, 'logs');
+    
+    // Cria a estrutura de pastas recursivamente (Funciona em Windows, Mac e Linux)
+    if (!fs.existsSync(logsDir)) {
+        fs.mkdirSync(logsDir, { recursive: true });
+    }
+
+    // Conteúdo do README.md
+    const content = `# 🤖 Agent Workflow Guide
+
+Este documento descreve o fluxo de desenvolvimento padrão usando os Agentes instalados.
+O sistema segue um processo **Waterfall** para planejamento (precisão) e **Iterativo** para execução.
+
+---
+
+## 1. 🏗️ Project Spec (@Project Architect)
+**Role:** O Visionário.
+**Goal:** Traduzir sua ideia vaga em uma Especificação concreta com "Project Principles" definidos.
+- **Comando:** \\
+/dev:project "Eu quero um App de Todo que..."
+- **Saída:** 
+\`docs/project.md\`
+
+## 2. 🧱 Requirements Engineering (@Requirements Engineer)
+**Role:** O Tech Lead.
+**Goal:** Fechar decisões técnicas (Stack, Banco de Dados, Libs).
+- **Why?** Evita que o Coder "invente" arquitetura. Cria o "Contrato".
+- **Comando:** 
+/dev:requirements
+- **Saída:** 
+\`docs/requirements.md\`
+
+## 3. 🗺️ Roadmap Strategy (@Milestone Manager)
+**Role:** O Estrategista.
+**Goal:** Fatiar o projeto em fases de entrega (MVPs).
+- **Comando:** 
+/dev:milestone
+- **Saída:** 
+\`docs/milestones.md\`
+
+## 4. 📋 Task Planning (@Task Planner)
+**Role:** O Gerente.
+**Goal:** Quebrar um Milestone específico em tarefas atômicas para desenvolvedores.
+- **Why?** IAs falham com contextos gigantes. Tarefas pequenas = Código perfeito.
+- **Comando:** 
+/dev:tasks <Milestone_ID>
+- **Saída:** 
+\`docs/task.md\`
+
+## 5. 🕵️ Blueprint Audit (@Auditor)
+**Role:** O Guardião.
+**Goal:** Validar consistência entre **Requirements** e **Tasks**.
+- **Comando:** 
+/dev:auditor
+- **Saída:** 
+\`audit_report.md\`
+
+## 6. 💻 Implementation (@Coder)
+**Role:** O Construtor.
+**Goal:** Executar *uma tarefa por vez* do arquivo 
+\`task.md\`.
+- **Comando:** 
+/dev:coder <Task_ID>
+- **Buffer:** 
+\`work_log.md\`
+
+## 7. ⚖️ Quality Assurance (@QA Engineer)
+**Role:** O Inspetor.
+**Goal:** Verificar se a implementação bate com os Requisitos.
+- **Comando:** 
+/dev:review <Task_ID>
+- **Saída:** 
+\`docs/logs/review_log.md\`
+
+## 8. 📦 Release Management (@Release Manager)
+**Role:** O Historiador.
+**Goal:** Consolidar o 
+\`work_log.md\` em um 
+\`changelog.md\` permanente.
+- **Comando:** 
+/dev:log
+- **Saída:** 
+\`changelog.md\`
+`;
+
+    const readmePath = path.join(docsDir, 'README.md');
+    if (!fs.existsSync(readmePath)) {
+        fs.writeFileSync(readmePath, content);
+        return true;
+    }
+    
+    return true; // Retorna true indicando que a estrutura foi garantida
+}
+
+module.exports = { generateWorkflowGuide };

package/src/lib/profiles.js

@@ -0,0 +1,186 @@
+/**
+ * Perfis de Stack Técnica
+ * Define regras adicionais que serão injetadas nos agentes
+ */
+
+const STACK_PROFILES = {
+    // --- GENERIC ---
+    'generic': {
+        label: '🌐 Genérico / Nenhum',
+        rules: []
+    },
+
+    // --- FRONTEND ---
+    'frontend-react': {
+        label: '🎨 Frontend: React + Tailwind',
+        rules: [
+            "Prefer Functional Components with Hooks.",
+            "Use Tailwind CSS for styling. Avoid inline styles.",
+            "Ensure accessibility (a11y) standards are met.",
+            "Use strict type checking if TypeScript is enabled.",
+            "Prefer React Query or SWR for data fetching."
+        ]
+    },
+    'frontend-next': {
+        label: '🎨 Frontend: Next.js (App Router)',
+        rules: [
+            "Use App Router directory structure.",
+            "Prefer Server Components by default; use 'use client' only when necessary.",
+            "Optimize images using next/image.",
+            "Use Server Actions for mutations."
+        ]
+    },
+    'frontend-vue': {
+        label: '🎨 Frontend: Vue.js 3 + Pinia',
+        rules: [
+            "Use Composition API with <script setup>.",
+            "Use Pinia for state management.",
+            "Prefer Tailwind CSS or Scoped CSS.",
+            "Follow the Vue Style Guide Priority A rules."
+        ]
+    },
+    'frontend-angular': {
+        label: '🎨 Frontend: Angular',
+        rules: [
+            "Use Standalone Components.",
+            "Prefer Signals over RxJS for synchronous state.",
+            "Strictly follow the Angular Style Guide.",
+            "Use Dependency Injection patterns."
+        ]
+    },
+    'frontend-svelte': {
+        label: '🎨 Frontend: SvelteKit',
+        rules: [
+            "Use Svelte 5 Runes syntax if available.",
+            "Leverage SvelteKit's load functions for server-side data.",
+            "Keep stores simple and derived."
+        ]
+    },
+
+    // --- BACKEND ---
+    'backend-node': {
+        label: '⚙️ Backend: Node.js (Express)',
+        rules: [
+            "Prefer Async/Await over raw Promises.",
+            "Follow Error Handling best practices (don't ignore errors).",
+            "Use Environment Variables for configuration.",
+            "Adhere to RESTful API standards."
+        ]
+    },
+    'backend-nest': {
+        label: '⚙️ Backend: NestJS',
+        rules: [
+            "Use Dependency Injection strictly.",
+            "Follow the module structure.",
+            "Use DTOs with ValidationPipe for all inputs.",
+            "Prefer TypeORM or Prisma for database interaction."
+        ]
+    },
+    'backend-python-fastapi': {
+        label: '⚙️ Backend: Python (FastAPI)',
+        rules: [
+            "Use Pydantic models for data validation.",
+            "Use Type Hints for function arguments and return values.",
+            "Implement async/await for I/O bound operations.",
+            "Follow PEP 8 style guidelines."
+        ]
+    },
+    'backend-python-django': {
+        label: '⚙️ Backend: Python (Django)',
+        rules: [
+            "Use Class-Based Views (CBVs) where appropriate.",
+            "Follow the 'Fat Models, Thin Views' philosophy.",
+            "Use Django ORM optimizations (select_related, prefetch_related).",
+            "Keep settings separated for dev/prod."
+        ]
+    },
+    'backend-java-spring': {
+        label: '⚙️ Backend: Java (Spring Boot)',
+        rules: [
+            "Use constructor injection over @Autowired.",
+            "Follow Google Java Style Guide.",
+            "Use Lombok to reduce boilerplate code.",
+            "Handle exceptions with @ControllerAdvice."
+        ]
+    },
+    'backend-csharp': {
+        label: '⚙️ Backend: C# (.NET Core)',
+        rules: [
+            "Follow Microsoft's C# Coding Conventions.",
+            "Use Async/Await all the way down.",
+            "Prefer LINQ for collection manipulation.",
+            "Use Dependency Injection via IServiceCollection."
+        ]
+    },
+    'backend-go': {
+        label: '⚙️ Backend: Go (Golang)',
+        rules: [
+            "Handle errors explicitly (if err != nil).",
+            "Follow strict formatting (gofmt).",
+            "Prefer standard library over external dependencies when possible.",
+            "Use context for cancellation and timeouts."
+        ]
+    },
+
+    // --- MOBILE ---
+    'mobile-react-native': {
+        label: '📱 Mobile: React Native',
+        rules: [
+            "Use Functional Components and Hooks.",
+            "Avoid bridge passing heavy data.",
+            "Optimize lists with FlatList or FlashList.",
+            "Style using StyleSheet objects or styled-components."
+        ]
+    },
+    'mobile-flutter': {
+        label: '📱 Mobile: Flutter',
+        rules: [
+            "Use const constructors whenever possible.",
+            "Prefer Composition over Inheritance.",
+            "Manage state with Riverpod or BLoC.",
+            "Follow Effective Dart guidelines."
+        ]
+    },
+    'mobile-ios': {
+        label: '📱 Mobile: iOS (SwiftUI)',
+        rules: [
+            "Use MVVM pattern.",
+            "Prefer Structs over Classes for data models.",
+            "Use strict concurrency checking.",
+            "Follow Apple's Human Interface Guidelines."
+        ]
+    },
+    'mobile-android': {
+        label: '📱 Mobile: Android (Kotlin Compose)',
+        rules: [
+            "Use Jetpack Compose for UI.",
+            "Follow Material Design 3 guidelines.",
+            "Use Coroutines and Flow for async work.",
+            "Implement Hilt for Dependency Injection."
+        ]
+    },
+
+    // --- DATA & AI ---
+    'data-python': {
+        label: '📊 Data Science: Python',
+        rules: [
+            "Use Pandas vectorization over loops.",
+            "Document notebooks with Markdown cells explaining logic.",
+            "Use Type Hints even in scripts.",
+            "Prefer Polars for large datasets if possible."
+        ]
+    },
+
+    // --- INFRASTRUCTURE ---
+    'infra-terraform': {
+        label: '☁️ Infra: Terraform',
+        rules: [
+            "Use modules for reusable resources.",
+            "Keep state remote and locked.",
+            "Format code with `terraform fmt`.",
+            "Avoid hardcoding values; use variables."
+        ]
+    }
+};
+
+module.exports = { STACK_PROFILES };

package/src/lib/schema.js

@@ -1,13 +1,13 @@
-const { z } = require('zod');
-
-const AgentSchema = z.object({
-  name: z.string().min(1, "Nome é obrigatório"),
-  role: z.string().min(1, "Papel (Role) é obrigatório"),
-  emoji: z.string().optional().default('🤖'),
-  systemPrompt: z.string().min(10, "System Prompt deve ter pelo menos 10 caracteres"),
-  rules: z.array(z.string()).optional().default([]),
-  tools: z.array(z.string()).optional().default([]),
-  description: z.string().optional()
-});
-
-module.exports = { AgentSchema };
+const { z } = require('zod');
+
+const AgentSchema = z.object({
+  name: z.string().min(1, "Nome é obrigatório"),
+  role: z.string().min(1, "Papel (Role) é obrigatório"),
+  emoji: z.string().optional().default('🤖'),
+  systemPrompt: z.string().min(10, "System Prompt deve ter pelo menos 10 caracteres"),
+  rules: z.array(z.string()).optional().default([]),
+  tools: z.array(z.string()).optional().default([]),
+  description: z.string().optional()
+});
+
+module.exports = { AgentSchema };