flyee 0.1.0

package/core/workflows/atomic.md

@@ -0,0 +1,182 @@
+---
+description: Create Atomic Design components (Atoms, Molecules, Organisms) with design tokens, typing, tests, and quality gates. Stack-agnostic.
+---
+
+# /atomic — Atomic Design Component Builder
+
+> Cria componentes seguindo Atomic Design, independente de stack.
+> Skill: `@[skills/atomic-design]`
+
+---
+
+## Phase 1: Intake Sequencial
+
+> 🔴 **UMA pergunta por vez. Esperar resposta antes de prosseguir.**
+
+### Step 1: Component Name
+```
+Qual o nome do componente?
+(Ex: Button, SearchBar, Header)
+```
+
+### Step 2: Category
+```
+Qual a categoria?
+1. ⚛️ Atom (elemento indivisível: Button, Input, Icon)
+2. 🧬 Molecule (grupo simples: SearchBar, FormField)
+3. 🦠 Organism (seção complexa: Header, Modal, DataTable)
+
+Se tiver dúvida, consulte: @[skills/atomic-design] → classification-guide.md
+```
+
+### Step 3: Stack Detection
+```
+Auto-detectar stack do projeto:
+- next.config.* / vite.config.* + react → React
+- nuxt.config.* / vite.config.* + vue → Vue
+- artisan + resources/views/ → Blade
+
+Se não detectar → Perguntar ao usuário:
+"Qual stack do projeto? (React / Vue / Blade / outro)"
+```
+
+### Step 4: Referência Visual
+```
+Tem referência visual?
+1. 🔗 Link do Figma
+2. 📸 Screenshot/imagem
+3. 📝 Descrição textual
+4. 🚫 Sem referência (criar do zero)
+```
+
+### Step 5: Base Library
+```
+Usar biblioteca UI como base?
+1. shadcn/ui (instalo se necessário)
+2. Headless UI
+3. Radix UI
+4. Nenhuma (construir do zero)
+```
+
+### Step 6: Extras
+```
+Deseja gerar extras?
+- [ ] Storybook story
+- [ ] Testes unitários (recomendado)
+```
+
+---
+
+## Phase 2: Infrastructure Check
+
+> Executar silenciosamente. Só perguntar ao usuário se precisar instalar algo.
+
+### 2.1 Design Tokens
+```
+Verificar se existe arquivo de tokens:
+- variables.css / variables.scss
+- tailwind.config.* com tokens customizados
+- design-system/tokens.*
+
+Se NÃO existir → Criar starter template (ver SKILL.md § Token Starter)
+```
+
+### 2.2 Test Framework
+```
+Se usuário pediu testes:
+- React: vitest.config.* existe?
+- Vue: vitest.config.* existe?
+- Blade: phpunit.xml existe?
+
+Se NÃO → Perguntar: "Framework de testes não encontrado. Instalar [Vitest/PHPUnit]?"
+```
+
+### 2.3 Storybook
+```
+Se usuário pediu Storybook:
+- .storybook/ existe?
+
+Se NÃO → Perguntar: "Storybook não encontrado. Instalar agora?"
+```
+
+### 2.4 UI Library
+```
+Se usuário escolheu shadcn:
+- components.json existe?
+  - SIM → Identificar primitive e instalar: npx shadcn@latest add [primitive]
+  - NÃO → Inicializar: npx shadcn@latest init
+```
+
+---
+
+## Phase 3: Generation
+
+### 3.1 Carregar Stack Adapter
+```
+Ler: @[skills/atomic-design] → references/stacks/stack-{stack}.md
+```
+
+### 3.2 Gerar Arquivos
+```
+Seguir a ordem obrigatória do adapter:
+1. Types/Interface (PRIMEIRO — contrato)
+2. Component implementation
+3. Styles (design tokens + BEM)
+4. Tests (se solicitado)
+5. Barrel export (index)
+6. Story (se solicitado)
+```
+
+### 3.3 Composição com UI Library
+```
+Se shadcn/Headless UI foi escolhido:
+- Importar primitive como base
+- Envolver (wrap) com estilos customizados
+- NÃO reconstruir o que a library já faz
+```
+
+---
+
+## Phase 4: Quality Gate
+
+> 🔴 **OBRIGATÓRIO antes de considerar o componente pronto.**
+
+```
+Executar checklist: @[skills/atomic-design] → references/quality-checklist.md
+
+Verificar:
+[ ] Classificação correta (Atom/Molecule/Organism)
+[ ] Todos os arquivos obrigatórios criados
+[ ] Design tokens usados (zero hardcoded values)
+[ ] Tipagem completa (zero `any`)
+[ ] Testes passando (se gerados)
+[ ] Acessibilidade básica
+[ ] Componente renderiza sem erros
+```
+
+---
+
+## Exemplos de Uso
+
+```bash
+# Criar um Button atom
+/atomic
+
+# O workflow vai perguntar:
+# 1. Nome? → Button
+# 2. Categoria? → Atom
+# 3. Stack detectado: React ✓
+# 4. Referência? → Descrição: "botão com variantes primary/secondary/ghost"
+# 5. Base? → shadcn
+# 6. Extras? → Storybook + Testes
+```
+
+---
+
+## Regras
+
+1. **UMA pergunta por vez** — nunca fazer múltiplas perguntas
+2. **Stack adapter obrigatório** — sempre carregar o adapter correto
+3. **Types PRIMEIRO** — sempre gerar o contrato antes da implementação
+4. **Quality Gate FINAL** — nunca pular o checklist
+5. **Respeitar Design System** — se o projeto já tem tokens via `/ds-init`, usar esses tokens

package/core/workflows/brainstorm.md

@@ -0,0 +1,134 @@
+---
+description: Structured brainstorming for projects and features. Explores multiple options before implementation.
+---
+
+# /brainstorm - Structured Idea Exploration
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
+
+---
+
+## 🔗 Integração com `/new-project`
+
+> [!TIP]
+> **Se você quer explorar ideias E depois implementar**, use:
+> ```bash
+> /new-project --brainstorm [nome]
+> ```
+> Isso executa o brainstorm como Phase 0 e continua automaticamente para PRD → TDD → Código.
+
+**Use `/brainstorm` standalone quando:**
+- Quer apenas explorar ideias sem compromisso de implementar
+- Precisa comparar abordagens técnicas para uma decisão
+- Está avaliando tecnologias ou arquiteturas
+
+---
+
+## Behavior
+
+When `/brainstorm` is triggered:
+
+**Agentes Envolvidos:**
+- `project-planner` - Estruturação e decomposição de opções
+- `backend-specialist` / `frontend-specialist` / `mobile-developer` - Conforme domínio técnico
+- `security-auditor` - Para avaliar riscos de cada opção
+
+1. **Understand the goal**
+   - What problem are we solving?
+   - Who is the user?
+   - What constraints exist?
+
+2. **Generate options**
+   - Provide at least 3 different approaches
+   - Each with pros and cons
+   - Consider unconventional solutions
+
+3. **Compare and recommend**
+   - Summarize tradeoffs
+   - Give a recommendation with reasoning
+
+---
+
+## Output Format
+
+```markdown
+## 🧠 Brainstorm: [Topic]
+
+### Context
+[Brief problem statement]
+
+---
+
+### Option A: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+- [benefit 2]
+
+❌ **Cons:**
+- [drawback 1]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+### Option B: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+
+❌ **Cons:**
+- [drawback 1]
+- [drawback 2]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+### Option C: [Name]
+[Description]
+
+✅ **Pros:**
+- [benefit 1]
+
+❌ **Cons:**
+- [drawback 1]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+## 💡 Recommendation
+
+**Option [X]** because [reasoning].
+
+What direction would you like to explore?
+```
+
+---
+
+## Examples
+
+```
+/brainstorm authentication system
+/brainstorm state management for complex form
+/brainstorm database schema for social app
+/brainstorm caching strategy
+```
+
+---
+
+## Key Principles
+
+- **No code** - this is about ideas, not implementation
+- **Visual when helpful** - use diagrams for architecture
+- **Honest tradeoffs** - don't hide complexity
+- **Defer to user** - present options, let them decide

package/core/workflows/check-task.md

@@ -0,0 +1,242 @@
+---
+description: Consultar status de uma task no Tracker. Verifica progresso, subitens e se está concluída.
+---
+
+# /check-task - Verificar Status de Task
+
+$ARGUMENTS
+
+**Arguments:**
+
+| Argumento | Descrição | Exemplo |
+|-----------|-----------|---------|
+| `<busca>` | Título, ID parcial ou termo de busca | `/check-task "autenticação"` |
+| `--subitems` | Mostrar checklist de subitens | `/check-task 1.1 --subitems` |
+| `--history` | Mostrar histórico de comentários | `/check-task "login" --history` |
+
+---
+
+## 🎯 PROPÓSITO
+
+Consultar o status de uma task específica no Flyee **sem iniciar execução**.
+
+Útil para:
+- Verificar se uma task foi concluída
+- Checar progresso e subitens pendentes
+- Validar antes de dar continuidade
+
+---
+
+## 📌 COMO IDENTIFICAR UMA TASK
+
+### Convenção de Identificação
+
+As tasks usam o **título** como identificador, geralmente com padrão:
+
+```
+{Épico}.{Sequência} - {Descrição}
+```
+
+**Exemplos:**
+- `1.1 - Implementar autenticação OAuth`
+- `2.3 - Criar componente de listagem`
+- `Adicionar filtro de busca` (sem número)
+
+### Formas de Buscar
+
+| Método | Exemplo | O que busca |
+|--------|---------|-------------|
+| **ID parcial** | `/check-task 1.1` | Título contendo "1.1" |
+| **Nome parcial** | `/check-task "autenticação"` | Título contendo "autenticação" |
+| **Nome completo** | `/check-task "1.1 - Implementar..."` | Match exato |
+
+> [!TIP]
+> **Onde encontrar o ID?**
+> - No Flyee: é o início do título da task
+> - No TDD: seção de breakdown lista tasks com IDs
+> - No relatório do `/discovery`: mostra IDs criados
+
+---
+
+## 🔴 FLUXO
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│    BUSCAR    │───▶│   ANALISAR   │───▶│   REPORTAR   │
+│   (Flyee)   │    │   (Status)   │    │  (Resultado) │
+└──────────────┘    └──────────────┘    └──────────────┘
+```
+
+---
+
+### Fase 1: BUSCAR TASK
+
+**Trigger:**
+```
+/check-task <busca>
+```
+
+**Ações:**
+1. Buscar no Tracker:
+   ```
+   Use: Flyee API: list_tasks()
+   query: "{busca}"
+   filter: { "property": "object", "value": "page" }
+   ```
+
+2. **Se encontrar múltiplas:**
+   ```
+   🔍 MÚLTIPLAS TASKS ENCONTRADAS
+   
+   | # | Título | Status | % |
+   |---|--------|--------|---|
+   | 1 | 1.1 - Autenticação OAuth | Em Progresso | 50% |
+   | 2 | 1.2 - Autenticação JWT | Concluído | 100% |
+   
+   Qual você quer verificar? (digite o número)
+   ```
+
+3. **Se não encontrar:**
+   ```
+   ❌ TASK NÃO ENCONTRADA
+   
+   Nenhuma task com "{busca}" foi encontrada.
+   
+   💡 Dica: Verifique se o termo está correto ou use parte do título.
+   ```
+
+---
+
+### Fase 2: ANALISAR TASK
+
+**Trigger:** Task encontrada (única ou selecionada)
+
+**Ações:**
+1. Recuperar propriedades da task:
+   ```
+   Use: Flyee API: get_task()
+   page_id: {task_id}
+   ```
+
+2. Extrair dados:
+   - Título
+   - Status
+   - Última edição
+   - Categoria
+   - Prioridade
+   - Última edição
+
+3. Se `--subitems`: Recuperar corpo da página:
+   ```
+   Use: Flyee API: get_task()
+   block_id: {task_id}
+   ```
+   - Contar itens marcados `[x]` vs `[ ]`
+
+4. Se `--history`: Recuperar comentários:
+   ```
+   Use: Flyee API: get_task()
+   block_id: {task_id}
+   ```
+
+---
+
+### Fase 3: REPORTAR STATUS
+
+**Ações:**
+
+1. **Task CONCLUÍDA (100%):**
+   ```
+   ✅ TASK CONCLUÍDA
+   
+   📋 Título: 1.1 - Implementar autenticação OAuth
+   📊 Status: Concluído
+   📈 Progresso: 100%
+   📅 Concluída em: 2026-01-15
+   
+   Esta task está totalmente finalizada.
+   ```
+
+2. **Task EM PROGRESSO (1-99%):**
+   ```
+   🟡 TASK EM PROGRESSO
+   
+   📋 Título: 2.3 - Criar componente de listagem
+   📊 Status: Em Progresso
+   📈 Progresso: 65%
+   🎯 Categoria: Feature
+   
+   📝 Subitens:
+   - [x] Criar estrutura base
+   - [x] Implementar filtros
+   - [ ] Adicionar paginação
+   - [ ] Testes unitários
+   
+   Pendente: 2 de 4 itens
+   ```
+
+3. **Task NÃO INICIADA (0%):**
+   ```
+   ⏳ TASK NÃO INICIADA
+   
+   📋 Título: 3.1 - Integrar pagamento
+   📊 Status: A Fazer
+   📈 Progresso: 0%
+   🎯 Prioridade: P0
+   
+   Use `/execute 3.1` para iniciar esta task.
+   ```
+
+---
+
+## 📋 EXEMPLOS DE USO
+
+```bash
+# Verificar task por ID parcial
+/check-task 1.1
+
+# Buscar por nome
+/check-task "autenticação"
+
+# Ver detalhes com subitens
+/check-task 2.3 --subitems
+
+# Ver histórico de comentários
+/check-task "login" --history
+
+# Combinar flags
+/check-task 1.1 --subitems --history
+```
+
+---
+
+## 🔗 INTEGRAÇÃO COM OUTROS WORKFLOWS
+
+| Após `/check-task` | Comando Sugerido | Quando usar |
+|-------------------|------------------|-------------|
+| Task não iniciada | `/execute {id}` | Iniciar execução |
+| Task em progresso | `/task-update {id} progress "msg"` | Atualizar progresso |
+| Task com bug | `/debug` | Investigar problema |
+| Task incompleta | `/new-task --resume` | Continuar trabalho |
+
+---
+
+## 📊 Propriedades Lidas
+
+| Propriedade | Obrigatória | Descrição |
+|-------------|-------------|-----------|
+| Título | ✅ | Identificação da task |
+| Status | ✅ | Não iniciado / Em andamento / Concluído |
+| Última edição | ✅ | Data/hora da última modificação (automático) |
+| Categoria | ❌ | Feature, Melhoria, Bug, etc. |
+| Prioridade | ❌ | P0, P1, P2, P3 |
+| last_edited_time | ❌ | Data da última edição |
+
+---
+
+## 🔴 REGRAS
+
+1. **Apenas consulta** - Este workflow NÃO modifica a task
+2. **Busca flexível** - Aceita ID (1.1), nome parcial ou completo
+3. **Múltiplos resultados** - Pergunta ao usuário qual verificar
+4. **Sem execução** - Para executar, use `/execute`