Introduction
Effortless est une application de bureau qui conduit un projet logiciel de l'idée à la livraison, en suivant le pipe OPALE. Ce guide décrit l'édition standard, écran par écran. Les mêmes opérations sont accessibles aux agents IA : l'application est la vue humaine de ce que les agents font aussi.
Le modèle mental
Workspace. Un workspace est un projet Effortless : un dossier qui contient .effortless/ (les données, en JSON) et blueprints/ (les mêmes informations, rendues en Markdown). Vous ouvrez un workspace par onglet.
Projet → Épic → Story → Tâche. Le travail se découpe en quatre niveaux. Un épic regroupe des stories, une story regroupe des tâches. Un seul épic et une seule story sont actifs à la fois : c'est là que se concentre le travail.
Les phases OPALE. Une story traverse cinq phases :
- O : analyse (Observer) ;
- P : cadrage (Positionner) ;
- A : spécifications (Articuler) ;
- L : plan (Lancer) ;
- E : exécution.
Une story de nature fix saute le cadrage et démarre directement en exécution. Pour passer à la phase suivante, les documents requis de la phase courante doivent exister.
Les évolutions. Le registre des évolutions est la mémoire du produit : anomalies, fonctionnalités, améliorations, découvertes, tests. Chacune a un identifiant (par exemple 26ANO335), une criticité de 1 à 3 et un état. Des évolutions peuvent être regroupées en lot, puis graduées en épic.
Décisions et questions. Les décisions (DEC-xx) et les questions ouvertes sont consignées au niveau de la story ou de l'épic.
Humains et agents. Un agent IA se connecte au même moteur par un serveur MCP, avec des verbes comme effortless_status ou effortless_story_start. Ce que fait l'agent apparaît dans l'application, et inversement.
La configuration recommandée
Gardez l'application ouverte, et travaillez avec un agent en ligne de commande — Claude Code, Codex ou Antigravity — lancé depuis la racine du projet (le dossier qui contient effortless.json). Le terminal intégré de VS Code, ouvert sur le dossier du projet, convient aussi. Voir Travailler au mieux.
Comment le guide est organisé
Pour commencer :
- Premier lancement : l'écran de démarrage et l'assistant qui crée votre profil.
- Choisir son organisation : le mode de travail et l'organisation du code (modules, dépôts externes, sources partagées), à décider avant de démarrer.
- Ouvrir un workspace : le sélecteur, point d'entrée.
- Assistant de création et Reprendre un projet existant : les deux parcours guidés pour démarrer un projet.
- Fenêtre, barres et systray : les onglets, le thème, la barre latérale, les raccourcis, et ce qui se passe quand vous fermez la fenêtre.
Puis les écrans d'un workspace, dans l'ordre de la barre latérale :
- Pilotage : Tableau de bord.
- Backlog & travail : Backlog et Tâches.
- Cadrage & connaissance : Connaissance.
- Qualité & versioning : Dérive, Git, Livraison et Modules.
- En bas de la barre latérale : Réglages du projet et Aide.
- Profil et préférences : les réglages de l'application, indépendants du projet.
Chaque page décrit ce que l'écran montre, puis ce que vous pouvez y faire. Quand un verbe MCP correspond, une section « Avec un agent IA » le nomme.