Projetos

Cada sessão de um agente de IA começa do zero, a menos que alguém se lembre do contexto. Os projetos são esse alguém. Eles contêm sua stack, seus repositórios, seus documentos e suas decisões para que os agentes não comecem cada sessão perguntando "qual framework usamos?". Sem projetos, você repete o mesmo contexto várias vezes. Com projetos, os agentes começam com tudo o que precisam.

Um projeto é o contêiner principal no Almirant. Ele agrupa boards, work items, sprints, documentos, repositórios e configurações em uma mesma entidade. Todo o trabalho da sua equipe é organizado dentro de um projeto.

Criar um projeto

O Almirant inclui um assistente guiado para criar projetos. Acesse-o pelo menu lateral ou pela rota /projects/new.

Etapas do assistente

1. Nome e descrição -- Defina um nome único e uma descrição opcional para o projeto.
2. Aparência visual -- Escolha uma cor e um ícone representativos para identificar rapidamente o projeto na navegação.
3. Stack tecnológica -- Informe as tecnologias do projeto (linguagens, frameworks, bancos de dados). Essas informações são usadas pela IA para contextualizar as tarefas.
4. URLs de ambiente -- Registre as URLs de produção e staging para ter acesso rápido e para que a IA possa referenciá-las.
5. Organização e cliente -- Associe o projeto a uma organização e, opcionalmente, a um cliente.
6. Confirmação -- Revise os dados e crie o projeto.

Campos de configuração

Campo	Descrição	Obrigatório
name	Nome do projeto	Sim
description	Descrição geral do projeto	Não
color	Cor para identificação visual na barra lateral	Não
icon	Ícone representativo do projeto	Não
techStack	Array de tecnologias usadas (e.g., ['Next.js', 'PostgreSQL'])	Não
productionUrl	URL do ambiente de produção	Não
stagingUrl	URL do ambiente de staging	Não
client	Nome do cliente associado	Não
organizationId	Organização proprietária do projeto	Sim

Painel do projeto

Ao acessar um projeto (/projects/[id]), é exibido um painel com:

• Resumo dos work items -- Contadores por tipo e estado atual.
• Boards ativos -- Lista de boards do projeto com acesso direto.
• Sprint ativo -- Informações sobre o sprint em andamento, se houver.
• Repositórios -- Repositórios do GitHub conectados ao projeto.
• Atividade recente -- Histórico de alterações e eventos do projeto.

Links de documentação

Cada projeto pode ter links para documentação externa. Os links de documentação permitem associar URLs relevantes (Confluence, Notion, Google Docs, wikis internas) ao projeto para que tanto a equipe quanto a IA tenham acesso rápido ao contexto.

Para adicionar um link de documentação:

1. Acesse o projeto.
2. Vá até a seção Links de documentação.
3. Informe a URL e um título descritivo.
4. Salve o link.

Notas do projeto

Os projetos incluem um sistema de notas para registrar decisões, contexto técnico ou qualquer informação relevante que não se encaixe em um work item. As notas ficam associadas ao projeto e são visíveis para toda a equipe.

Repositórios

Conecte repositórios do GitHub ao projeto para que a IA possa referenciar código, criar pull requests e vincular commits a work items. Consulte a seção de integrações para mais detalhes sobre a configuração do GitHub.

Capturas de tela do projeto

Você pode anexar capturas de tela ao projeto para documentar visualmente o estado atual da aplicação, mockups ou qualquer referência gráfica.

Transferir um projeto

Um projeto pode ser transferido entre organizações. A transferência é atômica e inclui:

• O projeto com todas as suas configurações.
• Todos os work items associados, incluindo ideias e milestones.
• Os boards e o remapeamento de colunas.

Para transferir um projeto:

1. Acesse as configurações do projeto.
2. Selecione Transferir projeto.
3. Escolha a organização de destino.
4. Confirme a transferência.

aviso

A transferência move o projeto completo. Certifique-se de que a organização de destino tenha as permissões e a configuração adequadas antes de continuar.

Excluir um projeto

A exclusão de um projeto é permanente e remove todos os dados associados (boards, work items, sprints, documentos, notas, repositórios). Essa ação não pode ser desfeita.

1. Acesse as configurações do projeto.
2. Selecione Excluir projeto.
3. Confirme digitando o nome do projeto.

perigo

Excluir um projeto apaga todos os boards, work items, sprints e dados associados de forma irreversível.

Para desenvolvedores

Para desenvolvedores

Rotas da aplicação

Rota	Descrição
/projects	Lista de todos os projetos
/projects/new	Assistente de criação de projeto
/projects/[id]	Painel do projeto

Ferramentas MCP

As seguintes tools estão disponíveis via MCP para gerenciar projetos programaticamente:

Tool	Descrição	Parâmetros principais
list_projects	Lista todos os projetos da organização	organizationId (opcional se houver projectId na sessão)
create_project	Cria um novo projeto	name, description, techStack, productionUrl, stagingUrl
update_project	Atualiza campos de um projeto existente	projectId, campos a atualizar
get_project	Obtém os detalhes completos de um projeto	projectId
get_project_roadmap	Obtém o roadmap do projeto com epics e features	projectId

Exemplo: criar um projeto via MCP

Tool: create_project
Parametros:
  name: "Mi Aplicacion Web"
  description: "Plataforma SaaS para gestion de inventario"
  techStack: ["Next.js", "PostgreSQL", "Tailwind CSS"]
  productionUrl: "https://app.ejemplo.com"
  stagingUrl: "https://staging.ejemplo.com"

Exemplo: consultar o roadmap

Tool: get_project_roadmap
Parametros:
  projectId: "uuid-del-proyecto"

Retorna a estrutura hierárquica do projeto com epics, features e seu progresso atual.