Skip to content

INICIO-RAPIDO.md

Latest commit

 

History

History
268 lines (189 loc) · 6.67 KB

INICIO-RAPIDO.md

File metadata and controls

268 lines (189 loc) · 6.67 KB

Inicio Rapido - Frankflow AI Squad

Manual de campo rapido para comecar a trabalhar com Claude Code + Frankflow.

Primeira Vez Aqui?

Passo 1: Abra o terminal e diga...

Ola! Estou comecando no projeto. Me mostre o status atual.

Claude vai automaticamente:

  • Ler o contexto do projeto (CLAUDE.md)
  • Verificar beads issues
  • Mostrar dashboard com proximos passos
  • Oferecer menu de opcoes

Comandos Essenciais (Copy-Paste)

Ver o que fazer

/project:status          # Dashboard completo do projeto
bd ready                 # Tasks prontas para trabalhar
bd list                  # Todas as issues
bd stats                 # Estatisticas

Comecar uma task

/project:iniciar TASK_ID      # Ex: /project:iniciar todolist-abc123

Claude vai:

  1. Criar branch automaticamente (feature/TASKID-descricao)
  2. Marcar task como "in progress"
  3. Mostrar menu guiado com opcoes de desenvolvimento

Durante o desenvolvimento

/project:testar         # Roda lint + tests + build
/project:status         # Ver progresso atual

Finalizar task

/project:enviar         # Cria PR automaticamente
/project:corrigir       # Se tiver feedback de review

Sistema de Navegacao Guiada

IMPORTANTE: Claude vai SEMPRE mostrar menus com opcoes em cada etapa!

Exemplo:

+---------------------------------------------+
| Proximos Passos                              |
+---------------------------------------------+

+---------------------------------------------+
| 1. RAPIDO: Implementacao Direta              |
|    ~8-10 min                                 |
|    Diga: "implementa direto"                 |
+---------------------------------------------+

+---------------------------------------------+
| 2. GUIADO: Workflow Completo (Recomendado)   |
|    ~12-15 min                                |
|    Diga: "workflow guiado"                   |
+---------------------------------------------+

+---------------------------------------------+
| 3. MANUAL: Voce comanda                      |
|    Voce escolhe cada skill                   |
+---------------------------------------------+

Responda: 1, 2 ou descreva o que quer

Voce NAO precisa saber todos os comandos! Claude vai sugerir o que fazer em cada momento.

3 Niveis de Automacao

Nivel Como funciona Quando usar
Piloto Automatico Claude decide e executa tudo Tasks simples e bem definidas
Guiado (padrao) Menu contextual em cada etapa Maioria das situacoes
Manual Voce chama cada skill Quando quer controle total

Workflows Disponiveis

Voce tem acesso a agentes especializados:

Quando usar Comando/Frase
Planejar feature "me ajuda a planejar isso"
Implementar rapido "implementa direto"
Com qualidade maxima "workflow completo" ou "workflow guiado"
Review de codigo Claude chama automaticamente apos implementar
Criar testes "cria testes para isso"
Debug de erro "me ajuda a debugar"

Exemplos Praticos

Exemplo 1: Comecar nova feature

Voce: /project:status
Claude: [mostra dashboard + tasks disponiveis]

Voce: /project:iniciar todolist-abc123
Claude: [cria branch + mostra menu guiado]

Voce: workflow guiado
Claude: [executa brainstorm -> plan -> work -> review]

Voce: /project:enviar
Claude: [cria PR]

Exemplo 2: Corrigir bug

Voce: Tem um bug no arquivo X, linha Y
Claude: [analisa + mostra menu com opcoes]

Voce: me ajuda a debugar
Claude: [usa debugging-toolkit + sugere fix]

Voce: implementa o fix
Claude: [implementa + auto-review]

Voce: /project:enviar
Claude: [cria PR]

Exemplo 3: Criar um squad para novo dominio

Voce: /squad:create "Meu Squad"
Claude: [wizard de 6 passos: discovery -> roles -> workflows -> tools -> compose -> output]

Voce: /squad:list
Claude: [lista templates e squads gerados]

Precisa de Ajuda?

Durante conversa

"nao entendi, explica melhor"
"quais sao minhas opcoes?"
"me mostra o menu de novo"

Documentacao

  • README.md - Visao geral do projeto
  • CLAUDE.md - Regras e comandos completos
  • .claude/rules/ - Regras especificas (git, PR, commit)
  • .claude/commands/ - Definicoes dos comandos /project:* e /squad:*
  • docs/guides/ - Guias de squads, templates e ferramentas

Comandos uteis

/help                   # Ajuda do Claude Code
bd --help               # Ajuda do beads

Atalhos Rapidos

O que fazer Como fazer
Criar projeto novo /project:greenfield
Organizar projeto existente /project:brownfield
Ver dependencias /project:graph
Priorizar tasks /project:triage
Dashboard completo /project:status
Comecar task /project:iniciar TASK_ID
Criar PR /project:enviar
Criar squad IA /squad:create "Nome"
Listar squads /squad:list

Seu Primeiro Comando

Cole isso no chat:

Ola! Quero comecar a trabalhar no projeto.
Me mostra o status atual e o que posso fazer.

Claude vai:

  1. Ler todo o contexto
  2. Verificar tasks disponiveis
  3. Mostrar dashboard
  4. Oferecer proximos passos com menu guiado

E so comecar a conversar naturalmente!

Troubleshooting

Erro: "no beads database found" ao commitar

Sintoma: Git commit falha pedindo beads database.

Causa: Git hooks do beads tentam rodar, mas projeto nao tem .beads/ inicializado.

Solucao: Os hooks foram atualizados para pular automaticamente se .beads/ nao existir. Se ainda ocorrer:

# Opcao 1: Commit sem hooks (temporario)
git commit --no-verify -m "mensagem"

# Opcao 2: Verificar se hooks estao atualizados
cat .git/hooks/pre-commit | grep "Check if beads is initialized"
# Se nao aparecer a verificacao, os hooks precisam ser atualizados

Nota: No frankflow-ai-squad (template), beads nao e necessario. Projetos criados com /project:greenfield ja terao beads inicializado automaticamente.

docs-mcp-server nao esta rodando

# Verificar status
curl -s http://localhost:6280 | head

# Iniciar manualmente
nohup npx -y @arabold/docs-mcp-server@latest --protocol http --host 127.0.0.1 --port 6280 > /tmp/docs-mcp-server.log 2>&1 &

Mais Recursos

Ultima atualizacao: 2026-02-11 | Versao: 4.1 | Claude Model: Opus 4.6