Projekte
Jede Sitzung eines KI-Agenten beginnt bei null, sofern sich niemand an den Kontext erinnert. Projekte übernehmen diese Rolle. Sie enthalten deinen Stack, deine Repositories, deine Dokumente und deine Entscheidungen, damit Agenten nicht jede Sitzung mit der Frage beginnen: "Welches Framework verwenden wir?" Ohne Projekte wiederholst du denselben Kontext immer wieder. Mit Projekten starten Agenten mit allem, was sie brauchen.
Ein Projekt ist der Hauptcontainer in Almirant. Es gruppiert Boards, Work Items, Sprints, Dokumente, Repositories und Konfigurationen unter einer Entität. Die gesamte Arbeit deines Teams wird innerhalb eines Projekts organisiert.
Projekt erstellen
Almirant enthält einen geführten Assistenten zum Erstellen von Projekten. Du erreichst ihn über das Seitenmenü oder unter /projects/new.
Schritte des Assistenten
- Name und Beschreibung -- Lege einen eindeutigen Namen und eine optionale Projektbeschreibung fest.
- Erscheinungsbild -- Wähle eine repräsentative Farbe und ein Symbol, um das Projekt in der Navigation schnell zu erkennen.
- Technologie-Stack -- Gib die Technologien des Projekts an (Sprachen, Frameworks, Datenbanken). Diese Informationen verwendet die KI, um Aufgaben zu kontextualisieren.
- Umgebungs-URLs -- Hinterlege die URLs für Produktion und Staging, damit sie schnell erreichbar sind und die KI darauf verweisen kann.
- Organisation und Kunde -- Ordne das Projekt einer Organisation und optional einem Kunden zu.
- Bestätigung -- Prüfe die Daten und erstelle das Projekt.
Konfigurationsfelder
| Feld | Beschreibung | Erforderlich |
|---|---|---|
name | Name des Projekts | Ja |
description | Allgemeine Projektbeschreibung | Nein |
color | Farbe zur visuellen Identifikation in der Seitenleiste | Nein |
icon | Repräsentatives Symbol des Projekts | Nein |
techStack | Array der verwendeten Technologien (e.g., ["Next.js", "PostgreSQL"]) | Nein |
productionUrl | URL der Produktionsumgebung | Nein |
stagingUrl | URL der Staging-Umgebung | Nein |
client | Name des zugeordneten Kunden | Nein |
organizationId | Organisation, der das Projekt gehört | Ja |
Projekt-Dashboard
Beim Aufrufen eines Projekts (/projects/[id]) wird ein Dashboard angezeigt mit:
- Work-Item-Übersicht -- Zähler nach Typ und aktuellem Status.
- Aktive Boards -- Liste der Boards des Projekts mit direktem Zugriff.
- Aktiver Sprint -- Informationen zum laufenden Sprint, falls vorhanden.
- Repositories -- Mit dem Projekt verbundene GitHub-Repositories.
- Letzte Aktivität -- Verlauf der Änderungen und Ereignisse des Projekts.
Doc Links
Jedes Projekt kann Links zu externer Dokumentation enthalten. Mit Doc Links kannst du relevante URLs (Confluence, Notion, Google Docs, interne Wikis) dem Projekt zuordnen, damit sowohl das Team als auch die KI schnellen Zugriff auf den Kontext haben.
So fügst du einen Doc Link hinzu:
- Öffne das Projekt.
- Gehe zum Abschnitt Doc Links.
- Gib die URL und einen aussagekräftigen Titel ein.
- Speichere den Link.
Projektnotizen
Projekte enthalten ein Notizsystem, um Entscheidungen, technischen Kontext oder andere relevante Informationen festzuhalten, die nicht in ein Work Item passen. Die Notizen bleiben dem Projekt zugeordnet und sind für das gesamte Team sichtbar.
Repositories
Verbinde GitHub-Repositories mit dem Projekt, damit die KI auf Code verweisen, Pull Requests erstellen und Commits mit Work Items verknüpfen kann. Weitere Details zur GitHub-Konfiguration findest du im Abschnitt Integrationen.
Projekt-Screenshots
Du kannst dem Projekt Screenshots anhängen, um den aktuellen Zustand der Anwendung, Mockups oder andere visuelle Referenzen zu dokumentieren.
Projekt übertragen
Ein Projekt kann zwischen Organisationen übertragen werden. Die Übertragung ist atomar und umfasst:
- Das Projekt mit seiner gesamten Konfiguration.
- Alle zugeordneten Work Items (einschließlich Ideen und Milestones).
- Die Boards und die Neuzuordnung der Spalten.
So überträgst du ein Projekt:
- Öffne die Projekteinstellungen.
- Wähle Projekt übertragen.
- Wähle die Zielorganisation.
- Bestätige die Übertragung.
Die Übertragung verschiebt das gesamte Projekt. Stelle vor dem Fortfahren sicher, dass die Zielorganisation über die passenden Berechtigungen und Konfiguration verfügt.
Projekt löschen
Das Löschen eines Projekts ist dauerhaft und entfernt alle zugehörigen Daten (Boards, Work Items, Sprints, Dokumente, Notizen, Repositories). Diese Aktion kann nicht rückgängig gemacht werden.
- Öffne die Projekteinstellungen.
- Wähle Projekt löschen.
- Bestätige durch Eingabe des Projektnamens.
Das Löschen eines Projekts entfernt alle Boards, Work Items, Sprints und zugehörigen Daten unwiderruflich.
Für Entwickler
Anwendungsrouten
| Route | Beschreibung |
|---|---|
/projects | Liste aller Projekte |
/projects/new | Assistent zum Erstellen eines Projekts |
/projects/[id] | Projekt-Dashboard |
MCP-Tools
Die folgenden Tools sind über MCP verfügbar, um Projekte programmatisch zu verwalten:
| Tool | Beschreibung | Wichtigste Parameter |
|---|---|---|
list_projects | Listet alle Projekte der Organisation auf | organizationId (optional, wenn die Sitzung projectId enthält) |
create_project | Erstellt ein neues Projekt | name, description, techStack, productionUrl, stagingUrl |
update_project | Aktualisiert Felder eines bestehenden Projekts | projectId, zu aktualisierende Felder |
get_project | Ruft die vollständigen Details eines Projekts ab | projectId |
get_project_roadmap | Ruft die Roadmap des Projekts mit Epics und Features ab | projectId |
Beispiel: Projekt über MCP erstellen
Tool: create_project
Parameter:
name: "Meine Webanwendung"
description: "SaaS-Plattform für Bestandsverwaltung"
techStack: ["Next.js", "PostgreSQL", "Tailwind CSS"]
productionUrl: "https://app.ejemplo.com"
stagingUrl: "https://staging.ejemplo.com"
Beispiel: Roadmap abfragen
Tool: get_project_roadmap
Parameter:
projectId: "uuid-del-proyecto"
Gibt die hierarchische Struktur des Projekts mit Epics, Features und ihrem aktuellen Fortschritt zurück.