Projets
Chaque session d'un agent IA repart de zéro, à moins que quelqu'un se souvienne du contexte. Les projets jouent ce rôle. Ils regroupent votre stack, vos dépôts, vos documents et vos décisions afin que les agents ne commencent pas chaque session par demander « quel framework utilisons-nous ? ». Sans projets, vous répétez le même contexte encore et encore. Avec les projets, les agents disposent dès le départ de tout ce dont ils ont besoin.
Un projet est le conteneur principal dans Almirant. Il regroupe des boards, des work items, des sprints, des documents, des dépôts et de la configuration sous une même entité. Tout le travail de votre équipe s'organise dans un projet.
Créer un projet
Almirant comprend un assistant guidé pour créer des projets. Accédez-y depuis le menu latéral ou à l'adresse /projects/new.
Étapes de l'assistant
- Nom et description -- Définissez un nom unique et une description facultative du projet.
- Apparence -- Choisissez une couleur et une icône représentatives pour identifier rapidement le projet dans la navigation.
- Stack technologique -- Indiquez les technologies du projet (langages, frameworks, bases de données). L'IA utilise ces informations pour contextualiser les tâches.
- URL d'environnement -- Enregistrez les URL de production et de staging pour y accéder rapidement et permettre à l'IA de les référencer.
- Organisation et client -- Associez le projet à une organisation et, facultativement, à un client.
- Confirmation -- Vérifiez les informations et créez le projet.
Champs de configuration
| Champ | Description | Obligatoire |
|---|---|---|
name | Nom du projet | Oui |
description | Description générale du projet | Non |
color | Couleur d'identification visuelle dans la barre latérale | Non |
icon | Icône représentative du projet | Non |
techStack | Tableau des technologies utilisées (e.g., ['Next.js', 'PostgreSQL']) | Non |
productionUrl | URL de l'environnement de production | Non |
stagingUrl | URL de l'environnement de staging | Non |
client | Nom du client associé | Non |
organizationId | Organisation propriétaire du projet | Oui |
Tableau de bord du projet
Lors de l'accès à un projet (/projects/[id]), un tableau de bord affiche :
- Résumé des work items -- Compteurs par type et état actuel.
- Boards actifs -- Liste des boards du projet avec accès direct.
- Sprint actif -- Informations sur le sprint en cours, s'il existe.
- Dépôts -- Dépôts GitHub connectés au projet.
- Activité récente -- Historique des modifications et événements du projet.
Liens de documentation
Chaque projet peut contenir des liens vers de la documentation externe. Les liens de documentation permettent d'associer au projet des URL pertinentes (Confluence, Notion, Google Docs, wikis internes) afin que l'équipe comme l'IA accèdent rapidement au contexte.
Pour ajouter un lien de documentation :
- Accédez au projet.
- Ouvrez la section Doc Links.
- Saisissez l'URL et un titre descriptif.
- Enregistrez le lien.
Notes du projet
Les projets incluent un système de notes pour consigner des décisions, du contexte technique ou toute information pertinente qui ne trouve pas sa place dans un work item. Les notes sont associées au projet et visibles par toute l'équipe.
Dépôts
Connectez des dépôts GitHub au projet afin que l'IA puisse référencer le code, créer des pull requests et lier des commits aux work items. Consultez la section intégrations pour plus de détails sur la configuration de GitHub.
Captures d'écran du projet
Vous pouvez joindre des captures d'écran au projet pour documenter visuellement l'état actuel de l'application, des maquettes ou toute référence graphique.
Transférer un projet
Un projet peut être transféré entre organisations. Le transfert est atomique et comprend :
- Le projet avec toute sa configuration.
- Tous les work items associés, y compris les idées et les milestones.
- Les boards et le remappage des colonnes.
Pour transférer un projet :
- Accédez à la configuration du projet.
- Sélectionnez Transfer Project.
- Choisissez l'organisation de destination.
- Confirmez le transfert.
Le transfert déplace le projet complet. Assurez-vous que l'organisation de destination dispose des autorisations et de la configuration appropriées avant de continuer.
Supprimer un projet
La suppression d'un projet est définitive et supprime toutes les données associées (boards, work items, sprints, documents, notes, dépôts). Cette action est irréversible.
- Accédez à la configuration du projet.
- Sélectionnez Delete Project.
- Confirmez en saisissant le nom du projet.
Supprimer un projet efface tous les boards, work items, sprints et données associées de façon irréversible.
Pour les développeurs
Routes de l'application
| Route | Description |
|---|---|
/projects | Liste de tous les projets |
/projects/new | Assistant de création de projet |
/projects/[id] | Tableau de bord du projet |
Outils MCP
Les tools suivants sont disponibles via MCP pour gérer les projets par programmation :
| Tool | Description | Paramètres principaux |
|---|---|---|
list_projects | Liste tous les projets de l'organisation | organizationId (facultatif si la session contient un projectId) |
create_project | Crée un nouveau projet | name, description, techStack, productionUrl, stagingUrl |
update_project | Met à jour les champs d'un projet existant | projectId, champs à mettre à jour |
get_project | Obtient les détails complets d'un projet | projectId |
get_project_roadmap | Obtient la roadmap du projet avec ses epics et features | projectId |
Exemple : créer un projet via MCP
Tool: create_project
Paramètres :
name: "Mon application web"
description: "Plateforme SaaS de gestion des stocks"
techStack: ["Next.js", "PostgreSQL", "Tailwind CSS"]
productionUrl: "https://app.exemple.com"
stagingUrl: "https://staging.exemple.com"
Exemple : consulter la roadmap
Tool: get_project_roadmap
Paramètres :
projectId: "uuid-del-proyecto"
Renvoie la structure hiérarchique du projet avec les epics, les features et leur progression actuelle.