VibeTachyon Workflows

Personas, squads, missões, o Story Development Cycle e todos os workflows do VibeTachyon OS.

O coração do VibeTachyon é seu sistema de workflows — estruturas que transformam trabalho caótico em execução previsível e de alta qualidade.

As 8 Personas

Cada persona é um especialista com autoridade exclusiva no seu domínio. Ative com /vibe-dev, /vibe-architect, etc., ou via vibe_persona_activate.

┌─────────────────────────────────────────────────────────────┐
│                    VIBETACHYON PERSONAS                      │
├──────────────┬──────────────────────────────────────────────┤
│  @vibe-dev   │ Implementação, TypeScript, componentes, git  │
│  @vibe-qa    │ Review, quality gate, testes, validação      │
│  @vibe-arch  │ Arquitetura, tech selection, complexidade     │
│  @vibe-pm    │ Requisitos, epics, specs, roadmap            │
│  @vibe-data  │ Schema, queries, RLS, migrations             │
│  @vibe-ux    │ UI/UX, design system, acessibilidade         │
│  @vibe-devop │ Git push, PR, CI/CD, releases                │
│  @vibe-anal  │ Pesquisa, benchmarks, relatórios             │
└──────────────┴──────────────────────────────────────────────┘

Os 5 Squads

Squads são configurações pré-definidas de personas que colaboram em um objetivo específico. Ative com /vibe-squad.

┌─────────────────┬────────────────────────────┬──────────────────────────┐
│ Squad           │ Personas                   │ Melhor para              │
├─────────────────┼────────────────────────────┼──────────────────────────┤
│ fullstack       │ arch + dev + qa + devops   │ Feature completa         │
│ qa-focused      │ qa + dev                   │ Resolução de issues      │
│ minimal         │ dev                        │ Tasks simples, rápidas   │
│ design          │ ux + dev + qa              │ Componentes UI/UX        │
│ release         │ qa + devops + analyst      │ Preparação de release    │
└─────────────────┴────────────────────────────┴──────────────────────────┘

Sistema de Missões

Missões são o mecanismo de rastreamento de objetivos do VibeTachyon. Cada missão tem tasks, artifacts e um debrief ao final.

                    LIFECYCLE DE UMA MISSÃO

  draft ──► active ──► [blocked?] ──► completed

  .vibetachyon/missions/mission_abc123.json
  {
    "title": "Implementar checkout",
    "goal": "Usuário consegue pagar com cartão",
    "status": "active",
    "tasks": ["task_x1", "task_x2"],
    "artifacts": [],
    "blockers": []
  }

Comandos: /vibe-mission-start, /vibe-mission

Sistema de Memória

A memória é o que torna o VibeTachyon mais inteligente com o tempo. Cada projeto acumula 4 tipos de conhecimento:

.vibetachyon/memory/
  decisions.json    ← "Escolhemos Zustand porque Redux era overkill para esse caso"
  patterns.json     ← "Sempre usar Server Components para data fetching no Next.js"
  gotchas.json      ← "next/image exige domínio configurado em next.config.js"
  preferences.json  ← "Preferimos Tailwind a CSS modules nesse projeto"

Essas memórias são carregadas automaticamente pelo agente no contexto de cada sessão — o agente nunca repete os mesmos erros.

Comando: /vibe-memory

Sistema de ADR (Architecture Decision Records)

Todo projeto tem decisões técnicas que, sem documentação, viram dívida de conhecimento. O sistema ADR do VibeTachyon registra essas decisões em formato padronizado — pesquisável pelo agente em sessões futuras.

.vibetachyon/decisions/
  ADR-X1Y2Z3.md        ← decisão completa em formato ADR
  ADR-X1Y2Z3.json      ← dados estruturados para busca
  INDEX.md             ← índice de todas as decisões

Exemplo:
# ADR-A1B2C3: Usar Zustand para gerenciamento de estado

Date: 2025-03-15 | Type: library
Context: Redux estava adicionando boilerplate sem benefício claro
Decision: Usar Zustand como state manager global
Reason: API simples, TypeScript-first, sem providers
Alternatives: Redux Toolkit, Jotai, React Context
Consequences: Bundle menor; sem DevTools avançado como Redux

Comandos: /vibe-adr [decisão] · vibe_decision_log · vibe_decision_search

Sistema de Métricas

Rastreie a performance do seu processo de desenvolvimento ao longo do tempo:

.vibetachyon/metrics/
  2025-03-15.jsonl   ← entradas do dia (formato JSONL)
  2025-03-16.jsonl

Métricas comuns:
  story-cycle-time   → minutos do início ao Done
  build-duration     → segundos de build
  test-coverage      → percentual de cobertura
  bug-density        → bugs encontrados por feature
  qa-iterations      → rodadas do QA loop antes do approve
  deploy-time        → minutos do commit ao deploy

O dashboard (/vibe-metrics) mostra avg/min/max por métrica nos últimos 7 dias (ou o período que você configurar).

Comandos: /vibe-metrics · vibe_metrics_track · vibe_metrics_show

Backlog de Features

O backlog do VibeTachyon é um gerenciador leve de prioridades persistido em .vibetachyon/backlog/backlog.json:

.vibetachyon/backlog/
  backlog.json   ← lista completa de itens

Exemplo de item:
  [BL-A1B2] Implementar dark mode toggle    (🔴 critical)
  [BL-C3D4] Adicionar testes de integração  (🟠 high)
  [BL-E5F6] Refatorar AuthProvider          (🟡 medium)
  [BL-G7H8] Atualizar README                (🟢 low)

Itens são automaticamente ordenados por prioridade: critical → high → medium → low.

Comando: /vibe-backlog [list|add|done]

Seleção Inteligente de Workflow

Não sabe qual workflow usar? O VibeTachyon decide por você:

Situação	Workflow Recomendado
`new-feature`	Story Development Cycle
`bug-fix`	Rapid Fix Cycle
`qa-issues`	QA Loop
`new-project`	Project Bootstrap
`legacy-codebase`	Brownfield Discovery
`release`	Release Workflow
`research`	Spec Pipeline

Comando: /vibe-workflow [sua situação]

Mapa Mental Completo

                        VIBETACHYON OS
                              │
         ┌────────────────────┼────────────────────┐
         │                    │                    │
    PERSONAS              WORKFLOWS            RUNTIME
    (8 total)             (4 + smart)         (.vibetachyon/)
         │                    │                    │
   @dev @qa           SDC (features)          missions/
   @arch @pm          QA Loop (quality)       tasks/
   @data @ux          Spec Pipeline           stories/
   @devops @anal      Brownfield              memory/
         │                    │               debriefs/
    SQUADS                 TOOLS              gates/
    (5 configs)          (40+ MCP)            releases/
         │                    │               specs/
   fullstack            search/design         brownfield/
   qa-focused           security/speed        decisions/ ← ADR
   minimal/design       missions/memory       metrics/   ← KPIs
   release              adr/audit/commit      backlog/   ← features
                        metrics/backlog

Ver todos os comandos

Referência completa dos 28 slash commands e 40+ skills.

Quickstart

Instale o VibeTachyon no seu agente agora.

O coração do VibeTachyon é seu sistema de workflows — estruturas que transformam trabalho caótico em execução previsível e de alta qualidade.

As 8 Personas

Cada persona é um especialista com autoridade exclusiva no seu domínio. Ative com /vibe-dev, /vibe-architect, etc., ou via vibe_persona_activate.

┌─────────────────────────────────────────────────────────────┐
│                    VIBETACHYON PERSONAS                      │
├──────────────┬──────────────────────────────────────────────┤
│  @vibe-dev   │ Implementação, TypeScript, componentes, git  │
│  @vibe-qa    │ Review, quality gate, testes, validação      │
│  @vibe-arch  │ Arquitetura, tech selection, complexidade     │
│  @vibe-pm    │ Requisitos, epics, specs, roadmap            │
│  @vibe-data  │ Schema, queries, RLS, migrations             │
│  @vibe-ux    │ UI/UX, design system, acessibilidade         │
│  @vibe-devop │ Git push, PR, CI/CD, releases                │
│  @vibe-anal  │ Pesquisa, benchmarks, relatórios             │
└──────────────┴──────────────────────────────────────────────┘

Os 5 Squads

Squads são configurações pré-definidas de personas que colaboram em um objetivo específico. Ative com /vibe-squad.

┌─────────────────┬────────────────────────────┬──────────────────────────┐
│ Squad           │ Personas                   │ Melhor para              │
├─────────────────┼────────────────────────────┼──────────────────────────┤
│ fullstack       │ arch + dev + qa + devops   │ Feature completa         │
│ qa-focused      │ qa + dev                   │ Resolução de issues      │
│ minimal         │ dev                        │ Tasks simples, rápidas   │
│ design          │ ux + dev + qa              │ Componentes UI/UX        │
│ release         │ qa + devops + analyst      │ Preparação de release    │
└─────────────────┴────────────────────────────┴──────────────────────────┘

Os 4 Workflows Principais

1. Story Development Cycle (SDC) — Para features novas

O workflow primário. 4 fases ordenadas com gate de qualidade em cada transição.

                    STORY DEVELOPMENT CYCLE

  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
  │  FASE 1     │    │  FASE 2     │    │  FASE 3     │    │  FASE 4     │
  │  CREATE     │───►│  VALIDATE   │───►│  IMPLEMENT  │───►│  QA GATE    │
  │  @vibe-pm   │    │  @vibe-qa   │    │  @vibe-dev  │    │  @vibe-qa   │
  └─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
  /vibe-story         score ≥ 7            código             PASS/FAIL
  user story         GO / NO-GO         implementado       story = Done
  draft status       ready status       task = done

Comandos: /vibe-story-cycle ou passo a passo com /vibe-pm → /vibe-story → /vibe-dev → /vibe-qa-loop

2. QA Loop — Para issues de qualidade

Ciclo iterativo review → fix → re-review. Máximo 5 iterações.

                    QA LOOP

  ┌─────────┐     ┌─────────────┐     ┌──────────────────┐
  │ REVIEW  │────►│  VERDICT    │────►│  APPROVE         │ → Done ✅
  │ @vibe-qa│     │             │     └──────────────────┘
  └─────────┘     │  approve?  ─┘───► .vibetachyon/gates/
                  │  reject?   ─────► @vibe-dev fixes
                  │  block?    ─────► Escalação imediata
                  └─────────────┘

  Após 5 rejeições → max_iterations_reached → escalação

Comando: /vibe-qa-loop

3. Spec Pipeline — Para features complexas

Transforma requisito informal em spec executável. Número de fases varia com complexidade.

                    SPEC PIPELINE

  gather ──► assess ──► [research] ──► write ──► critique ──► [plan]

  Score ≤ 8  → SIMPLE:   gather + write + critique (3 fases)
  Score 9-15 → STANDARD: todas as 6 fases
  Score ≥ 16 → COMPLEX:  6 fases + ciclo de revisão

  COMPLEXITY SCORE (1-5 por dimensão):
  ┌────────────────┬────────────────────────────────────────────────┐
  │ Scope          │ Quantos arquivos são afetados?                 │
  │ Integration    │ Precisa de APIs externas?                      │
  │ Infrastructure │ Mudanças de schema ou env vars?                │
  │ Knowledge      │ Familiaridade do time com a área?              │
  │ Risk           │ Quão crítico é para o produto?                 │
  └────────────────┴────────────────────────────────────────────────┘

  Vereditos do critique:
  ≥ 4.0 avg → APPROVED
  3.0-3.9   → NEEDS_REVISION
  < 3.0     → BLOCKED → escalate

Comando: /vibe-spec

4. Brownfield Discovery — Para codebases legadas

10 fases de assessment técnico para entender e documentar uma codebase existente.

                    BROWNFIELD DISCOVERY

  Fase 1: Architecture   → system-architecture.md   (@arch)
  Fase 2: Schema         → SCHEMA.md + DB-AUDIT.md   (@data)
  Fase 3: Frontend       → frontend-spec.md          (@ux)
  Fase 4: Debt Draft     → technical-debt-DRAFT.md   (@arch)
  Fase 5: DB Review      → db-specialist-review.md   (@data)
  Fase 6: UX Review      → ux-specialist-review.md   (@ux)
  Fase 7: QA Gate        → qa-review.md              (@qa)
         ↓ APPROVED / NEEDS WORK
  Fase 8: Final          → technical-debt-assessment.md
  Fase 9: Executive      → TECHNICAL-DEBT-REPORT.md
  Fase 10: Epic Planning → stories para top debt items

Comando: /vibe-discover

Sistema de Missões

Missões são o mecanismo de rastreamento de objetivos do VibeTachyon. Cada missão tem tasks, artifacts e um debrief ao final.

                    LIFECYCLE DE UMA MISSÃO

  draft ──► active ──► [blocked?] ──► completed

  .vibetachyon/missions/mission_abc123.json
  {
    "title": "Implementar checkout",
    "goal": "Usuário consegue pagar com cartão",
    "status": "active",
    "tasks": ["task_x1", "task_x2"],
    "artifacts": [],
    "blockers": []
  }

Comandos: /vibe-mission-start, /vibe-mission

Sistema de Memória

A memória é o que torna o VibeTachyon mais inteligente com o tempo. Cada projeto acumula 4 tipos de conhecimento:

.vibetachyon/memory/
  decisions.json    ← "Escolhemos Zustand porque Redux era overkill para esse caso"
  patterns.json     ← "Sempre usar Server Components para data fetching no Next.js"
  gotchas.json      ← "next/image exige domínio configurado em next.config.js"
  preferences.json  ← "Preferimos Tailwind a CSS modules nesse projeto"

Essas memórias são carregadas automaticamente pelo agente no contexto de cada sessão — o agente nunca repete os mesmos erros.

Comando: /vibe-memory

Sistema de ADR (Architecture Decision Records)

.vibetachyon/decisions/
  ADR-X1Y2Z3.md        ← decisão completa em formato ADR
  ADR-X1Y2Z3.json      ← dados estruturados para busca
  INDEX.md             ← índice de todas as decisões

Exemplo:
# ADR-A1B2C3: Usar Zustand para gerenciamento de estado

Date: 2025-03-15 | Type: library
Context: Redux estava adicionando boilerplate sem benefício claro
Decision: Usar Zustand como state manager global
Reason: API simples, TypeScript-first, sem providers
Alternatives: Redux Toolkit, Jotai, React Context
Consequences: Bundle menor; sem DevTools avançado como Redux

Comandos: /vibe-adr [decisão] · vibe_decision_log · vibe_decision_search

Sistema de Métricas

Rastreie a performance do seu processo de desenvolvimento ao longo do tempo:

.vibetachyon/metrics/
  2025-03-15.jsonl   ← entradas do dia (formato JSONL)
  2025-03-16.jsonl

Métricas comuns:
  story-cycle-time   → minutos do início ao Done
  build-duration     → segundos de build
  test-coverage      → percentual de cobertura
  bug-density        → bugs encontrados por feature
  qa-iterations      → rodadas do QA loop antes do approve
  deploy-time        → minutos do commit ao deploy

O dashboard (/vibe-metrics) mostra avg/min/max por métrica nos últimos 7 dias (ou o período que você configurar).

Comandos: /vibe-metrics · vibe_metrics_track · vibe_metrics_show

Backlog de Features

O backlog do VibeTachyon é um gerenciador leve de prioridades persistido em .vibetachyon/backlog/backlog.json:

.vibetachyon/backlog/
  backlog.json   ← lista completa de itens

Exemplo de item:
  [BL-A1B2] Implementar dark mode toggle    (🔴 critical)
  [BL-C3D4] Adicionar testes de integração  (🟠 high)
  [BL-E5F6] Refatorar AuthProvider          (🟡 medium)
  [BL-G7H8] Atualizar README                (🟢 low)

Itens são automaticamente ordenados por prioridade: critical → high → medium → low.

Comando: /vibe-backlog [list|add|done]

Seleção Inteligente de Workflow

Não sabe qual workflow usar? O VibeTachyon decide por você:

Situação	Workflow Recomendado
`new-feature`	Story Development Cycle
`bug-fix`	Rapid Fix Cycle
`qa-issues`	QA Loop
`new-project`	Project Bootstrap
`legacy-codebase`	Brownfield Discovery
`release`	Release Workflow
`research`	Spec Pipeline

Comando: /vibe-workflow [sua situação]

Mapa Mental Completo

                        VIBETACHYON OS
                              │
         ┌────────────────────┼────────────────────┐
         │                    │                    │
    PERSONAS              WORKFLOWS            RUNTIME
    (8 total)             (4 + smart)         (.vibetachyon/)
         │                    │                    │
   @dev @qa           SDC (features)          missions/
   @arch @pm          QA Loop (quality)       tasks/
   @data @ux          Spec Pipeline           stories/
   @devops @anal      Brownfield              memory/
         │                    │               debriefs/
    SQUADS                 TOOLS              gates/
    (5 configs)          (40+ MCP)            releases/
         │                    │               specs/
   fullstack            search/design         brownfield/
   qa-focused           security/speed        decisions/ ← ADR
   minimal/design       missions/memory       metrics/   ← KPIs
   release              adr/audit/commit      backlog/   ← features
                        metrics/backlog

Ver todos os comandos

Referência completa dos 28 slash commands e 40+ skills.

Quickstart

Instale o VibeTachyon no seu agente agora.

VibeTachyon Workflows

As 8 Personas

Os 5 Squads

Os 4 Workflows Principais

1. Story Development Cycle (SDC) — Para features novas

2. QA Loop — Para issues de qualidade

3. Spec Pipeline — Para features complexas

4. Brownfield Discovery — Para codebases legadas

Sistema de Missões

Sistema de Memória

Sistema de ADR (Architecture Decision Records)

Sistema de Métricas

Backlog de Features

Seleção Inteligente de Workflow

Mapa Mental Completo

Ver todos os comandos

Quickstart

On this page

VibeTachyon Workflows

As 8 Personas

Os 5 Squads

Os 4 Workflows Principais

1. Story Development Cycle (SDC) — Para features novas

2. QA Loop — Para issues de qualidade

3. Spec Pipeline — Para features complexas

4. Brownfield Discovery — Para codebases legadas

Sistema de Missões

Sistema de Memória

Sistema de ADR (Architecture Decision Records)

Sistema de Métricas

Backlog de Features

Seleção Inteligente de Workflow

Mapa Mental Completo

Ver todos os comandos

Quickstart

On this page

VibeTachyon Workflows

@vibe-dev — Especialista em Implementação

@vibe-qa — Especialista em Qualidade

@vibe-architect — Autoridade de Design de Sistema

@vibe-pm — Orquestração de Produto

Ver todos os comandos

Quickstart

On this page

VibeTachyon Workflows

@vibe-dev — Especialista em Implementação

@vibe-qa — Especialista em Qualidade

@vibe-architect — Autoridade de Design de Sistema

@vibe-pm — Orquestração de Produto

Ver todos os comandos

Quickstart

On this page