Seu primeiro projeto
Um projeto no Almirant é o contêiner principal de todo o seu trabalho. Dentro de um projeto, você encontrará boards, work items, documentos, sprints e a configuração das integrações.
O que é um projeto
Pense em um projeto como o espaço dedicado a um produto, serviço ou iniciativa específica. Cada projeto tem:
- Boards -- Quadros Kanban para visualizar o fluxo de trabalho
- Work Items -- Tarefas organizadas hierarquicamente (Epic > Feature > Story > Task)
- Sprints -- Iterações com datas e objetivos
- Documentos -- Notas e links relevantes do projeto
- Configurações -- Tech stack, repositórios e URLs associadas
Criar um projeto
1. Acesse a lista de projetos
No dashboard, clique em Projetos no menu lateral ou no botão Novo projeto.
2. Preencha as informações básicas
No formulário de criação, informe:
| Campo | Descrição | Exemplo |
|---|---|---|
| Nome | Nome identificador do projeto | "App Mobile v2" |
| Descrição | Breve descrição do objetivo do projeto | "Redesign completo do app mobile com React Native" |
| Cor | Cor para identificar visualmente o projeto | Azul, verde, vermelho etc. |
3. Confirme a criação
Clique em Criar projeto. Você será redirecionado para a tela do projeto recém-criado.
Configurar o projeto
Depois de criado, é recomendável completar a configuração do projeto. Isso é especialmente útil se você for conectar a IA via MCP, pois o contexto do projeto ajuda a IA a entender melhor sua stack e o codebase.
Informações do projeto
Acesse as configurações do projeto pelo ícone de ajustes ou pela seção Settings dentro do projeto. Nela, você pode definir:
| Campo | Para que serve | Exemplo |
|---|---|---|
| Tech Stack | Tecnologias usadas pelo projeto | "Next.js, TypeScript, PostgreSQL" |
| URLs | Links relevantes (produção, staging, docs) | "https://app.minhaempresa.com" |
| Repositórios | Repositórios de código associados | Conexão direta com GitHub |
Você pode conectar repositórios do GitHub diretamente ao seu projeto. Isso permite que a IA acesse o contexto do código e crie pull requests automaticamente. Consulte a seção de integrações com GitHub para mais detalhes.
Tela do projeto
Depois de criar e configurar seu projeto, a tela principal mostra:
- Resumo -- Visão geral do estado do projeto
- Boards -- Lista de quadros associados
- Work Items -- Todas as tarefas do projeto com filtros
- Sprints -- Planejamento por iterações
- Documentos -- Notas e recursos do projeto
Cada projeto tem um prefixo único (por exemplo, APP, WEB) usado para gerar os identificadores dos work items (como APP-T-1, APP-S-5). Esse prefixo é atribuído automaticamente, mas você pode personalizá-lo.
Próximos passos
Com seu projeto criado, o próximo passo é criar um board para organizar visualmente seu trabalho.
Próximo passo: Seu primeiro board e work items -- Crie um quadro Kanban e adicione suas primeiras tarefas.