Workspaces et dépôts

Dans le tableau de bord, la maison d'une base de code est un projet : en enregistrer un dit à ARDS où vit votre code et en fait le terrain des missions. En coulisses, ARDS garde son propre clone de votre dépôt — la copie de travail sur laquelle les coders écrivent (vous la verrez appelée workspace dans les messages d'état) — et pousse le travail approuvé vers votre vrai dépôt. Vous ne gérez jamais le clone vous-même ; vous gérez des projets.

Il n'y a plus d'assistant de configuration séparé. Enregistrer un projet fait tout le travail : il est cloné, indexé et embarqué automatiquement, et la première mission — comme chaque approbation ensuite — arrive dans la file de décisions.

La page Projets

Projets dans la barre latérale ouvre le registre — la page s'intitule Gestion de projets. Tous les projets liste chaque projet sous forme de carte : son nom (cliquez pour rejoindre la page du projet), un badge d'état, son type, un lien vers son dépôt, et un indicateur d'avancement Aspects issu de l'embarquement.

Pendant le premier clonage, la carte affiche Cloning workspace… ; en cas d'échec, Workspace clone failed. avec une piste sur la cause probable et un bouton Try Again (ces messages s'affichent en anglais dans l'interface) — un token invalide ou un hébergeur injoignable sont les suspects habituels.

Enregistrer un projet

Le formulaire Enregistrer un nouveau projet est sur la même page :

  • Nom du projet — obligatoire.
  • URL du dépôt — là où vit votre code. Le formulaire s'adapte à ce que vous collez :
    • HTTPS — pour un dépôt privé, ajoutez un Personal Access Token. Le formulaire précise (en anglais) la portée requise : « Required scope: read_repository (GitLab) / repo read (GitHub). Stored encrypted; used only to clone into the mirror. » Il propose aussi un lien direct vers la page de création de token de votre hébergeur.
    • SSH — cliquez Generate deploy key ; ARDS génère une paire de clés ed25519 et vous montre la clé publique à coller dans la liste des clés de déploiement de votre hébergeur. Donnez l'accès en écriture : une clé en lecture seule clone très bien, mais bloque plus tard le push vers votre dépôt quand le travail est approuvé.
    • Vide — autorisé. Le formulaire l'explique : « L'URL du dépôt est facultative. Laissez-la vide pour créer un projet greenfield : Genesis héberge le dépôt et crée le dépôt d'origine du client à la livraison. »
  • Description — facultative.
  • Type — Géré, Consulté ou Observé.

Cliquez Enregistrer un projet et regardez la nouvelle carte apparaître dans la liste ; le clonage, l'indexation et l'embarquement s'enchaînent tout seuls à partir de là.

Choisir le projet actif

Le sélecteur de projet vit dans la barre du haut du tableau de bord et affiche Tous les projets par défaut. Choisir un projet cadre ce que vous voyez — conversations, missions et décisions se filtrent sur lui — et des entrées propres au projet (Intelligence, Onboarding) apparaissent pour lui dans la barre latérale.

La page d'un projet

Cliquez sur le nom d'un projet pour ouvrir sa page : la description, son identifiant, la phase en cours, le lien vers le dépôt et la date de création, plus la vision du projet quand elle est renseignée (les libellés de cette page s'affichent en anglais). De là, vous atteignez les vues Intelligence et Onboarding du projet, voyez l'état des branches à travers ses missions, consultez ses canevas de design et configurez les cibles de navigation d'application.

Frontières : ce que les agents peuvent toucher

La page Projets énonce aussi les règles permanentes — Limites constitutionnelles — qui s'appliquent à chaque projet :

  • Frontière (Protégé) — « .git/, branche principale, fichiers *.env » : les agents n'y touchent pas.
  • Nécessite une approbation — « Fusion vers main, suppression de fichiers protégés » : seulement avec votre approbation explicite.
  • Autonome — « Branches de fonctionnalité, fichiers réguliers » : les agents y travaillent librement.

C'est pourquoi le travail quotidien des agents se fait sur des branches, et pourquoi tout ce qui atterrit sur votre branche principale est d'abord passé par une approbation humaine.

Comment les changements approuvés atteignent votre dépôt

Le travail approuvé est poussé vers votre dépôt automatiquement, avec l'identifiant fourni à l'enregistrement — le Personal Access Token en HTTPS, la clé de déploiement en SSH. Il n'y a pas d'étape « publier » séparée ; c'est aussi pourquoi une clé en lecture seule finit par faire mal : le clonage a marché, mais le push d'approbation échoue.

Quand une mission exécute des workflows, le chemin a une couche nommée de plus : chaque run que vous acceptez atterrit comme un changement sur la branche de la mission, et la merge request de la mission est la pile composée de ces changements. Chaque changement peut être annulé individuellement — les changements dépendants suivent en cascade, et vous voyez un aperçu de la cascade avant que quoi que ce soit ne soit défait. Voir la pile de changements.

Canevas de design

Un canevas de design est un ensemble de maquettes visuelles — plusieurs plans disposés sur une même surface — produit pour votre projet par une tâche de design. La page du projet a un panneau Canevas de design qui liste chaque canevas produit, avec son nombre de plans (N plans) ; tant qu'il n'y en a aucun, il dit : « Aucun canevas de design pour l'instant. Lancez une tâche de design pour en créer un. »

design canvases panel

Cliquez sur un canevas pour ouvrir la visionneuse plein écran à /projects/{id}/design/{taskId}/{slug}. Vous pouvez y naviguer et zoomer à travers les plans, exporter ce que vous voyez en PNG ou PDF, et télécharger les sources du canevas en zip (Sources (zip)). La visionneuse est en consultation et export uniquement.

Comment un canevas naît : une tâche de type design le produit. Quand la direction visuelle est vraiment ouverte, le coder esquisse d'abord quelques plans de direction en basse fidélité et vous demande de choisir entre eux — cette question arrive dans la file de décisions. Regardez les directions dans la visionneuse, répondez à la décision, et la tâche continue en développant la direction que vous avez choisie.

Une limite honnête : les canevas sont produits par des tâches, pas retouchés à la main — impossible de les éditer dans le tableau de bord. Si vous voulez qu'un canevas change, dites-le dans la mission ou la tâche qui le possède.