android-clean-architecture

Vue d’ensemble de la compétence android-clean-architecture

La compétence android-clean-architecture vous aide à structurer des applications Android et Kotlin Multiplatform autour de frontières nettes, plutôt qu’autour d’un code feature bricolé au fil de l’eau. Elle convient surtout aux ingénieurs qui ont besoin d’un point de départ architectural concret pour les modules, les règles de dépendance, les UseCases, les Repositories et la conception de la couche data — pas d’un simple cours théorique généraliste.

À quoi sert cette compétence

Utilisez android-clean-architecture lorsque vous devez décider où placer la logique, comment les modules doivent dépendre les uns des autres, et comment éviter que l’UI, le domain et la data finissent fusionnés dans une seule couche. Elle est particulièrement pertinente si vous standardisez une nouvelle base de code ou si vous refactorez une application en croissance.

À qui profite le plus cette compétence

Cette compétence android-clean-architecture est particulièrement adaptée aux équipes qui développent des applications Android, du code partagé KMP, ou des produits basés sur Compose qui sont déjà devenus trop fortement couplés. Elle est aussi utile si vous hésitez entre des modules par feature, des modules par couche, ou une configuration plus simple en module unique avec des frontières propres.

Principaux éléments différenciants

Contrairement à un prompt d’architecture vague, android-clean-architecture se concentre sur une structure concrète : organisation des modules, dépendances autorisées, emplacement des repositories, et endroit où intégrer Room, SQLDelight, Ktor, Koin ou Hilt. C’est donc une approche plus orientée décision quand vous cherchez à éviter le sur-design ou les fuites accidentelles entre couches.

Comment utiliser la compétence android-clean-architecture

L’installer et l’activer

Passez par le flux d’installation android-clean-architecture dans votre gestionnaire de compétences, puis ouvrez le fichier de la compétence et gardez-le dans le contexte pendant vos travaux de planification ou d’édition d’architecture. Si votre environnement prend en charge le chargement par chemin, pointez vers skills/android-clean-architecture/SKILL.md afin que le modèle puisse appliquer les règles d’architecture pendant la tâche.

Lui confier un travail d’architecture concret

L’usage de android-clean-architecture donne les meilleurs résultats lorsque vous demandez un livrable précis, par exemple un découpage en modules, une cartographie des dépendances ou le placement des couches. Un bon input précise la plateforme, la stack actuelle et l’ensemble des contraintes.

Exemples de formulation :

• « Design an android-clean-architecture module layout for a Compose + Hilt app with offline sync. »
• « Refactor this KMP feature into android-clean-architecture layers using Room on Android and SQLDelight in shared code. »
• « Review these modules and point out dependency rule violations. »

Lire d’abord les bonnes sections

Commencez par SKILL.md, puis concentrez-vous sur les sections qui définissent quand activer la compétence, la structure recommandée et les règles de dépendance. Ce sont elles qui influencent réellement les choix d’implémentation. Si votre dépôt ne contient que ce fichier, considérez ces sections comme la source de vérité et adaptez-les à vos propres noms de packages et à votre configuration de build.

Fournir les entrées qui améliorent la qualité du résultat

Donnez à la compétence un inventaire bref de l’existant : modules, outils de persistance, framework de DI, stack réseau, et précisez si l’application est Android-only ou KMP. Indiquez aussi ce que vous voulez préserver, comme les frontières de features déjà en place ou les API publiques. Plus votre état actuel est décrit précisément, moins le guide android-clean-architecture risque d’inventer des couches inutiles.

FAQ sur la compétence android-clean-architecture

android-clean-architecture est-elle réservée aux nouveaux projets ?

Non. La compétence android-clean-architecture est utile aussi bien pour un projet greenfield que pour du refactoring. Elle est particulièrement efficace lorsque vous devez réintroduire des frontières dans une application existante devenue désordonnée, car elle vous aide à décider quoi déplacer sans tout réécrire d’un coup.

En quoi est-ce différent d’un prompt classique ?

Un prompt classique peut demander une architecture en couches, mais android-clean-architecture vous fournit un cadre ciblé pour les décisions Android et KMP. Vous obtenez donc de meilleures indications sur le sens des dépendances, le nommage des modules, et l’emplacement du code de data source et de repository.

Est-ce adapté aux débutants ?

Oui, à condition d’accepter de travailler à partir d’une cartographie de modules concrète. C’est moins adapté si vous cherchez une explication très générale de la Clean Architecture sans détail d’implémentation. Les débutants en tirent le plus de valeur lorsqu’ils s’en servent pour valider une structure simple et explicite, plutôt qu’une organisation tentaculaire.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas android-clean-architecture si votre application est minuscule, si votre équipe évite délibérément les architectures en couches, ou si vous avez seulement besoin d’implémenter rapidement une feature sans travail de modularisation. Dans ces cas-là, la compétence peut ajouter une structure dont vous n’avez pas besoin.

Comment améliorer la compétence android-clean-architecture

Formulez clairement la décision d’architecture attendue

Le moyen le plus rapide d’améliorer les résultats de android-clean-architecture consiste à demander une seule décision à la fois : frontières de modules, graphe de dépendances, flux de données ou câblage DI. Si vous demandez « best architecture », le résultat sera généralement moins utile qu’une demande du type : « where should caching live in this KMP repository setup? »

Donnez à la compétence vos vraies contraintes

Mentionnez la stack et les limites qui comptent réellement : Android only ou KMP, Compose ou XML, Room ou SQLDelight, Ktor ou Retrofit, Hilt ou Koin, et si une approche offline-first est requise. Ces détails modifient la structure recommandée et évitent qu’un guide android-clean-architecture générique se cale sur le mauvais backend ou le mauvais modèle de stockage.

Surveillez les modes d’échec fréquents

L’erreur la plus courante consiste à laisser chaque feature embarquer sa propre mini-architecture sans règles communes. Une autre est de placer la logique métier dans le code de présentation parce que c’est plus rapide sur le moment. Utilisez la compétence pour vérifier ces frontières tôt dans le processus, puis révisez le résultat à partir de votre véritable arborescence de packages et de vos fichiers de build.

Itérez avec un suivi calé sur votre dépôt

Après la première sortie, demandez un audit des dépendances ou un plan de placement fichier par fichier à partir de votre arborescence actuelle. Par exemple : « Map these existing packages to the android-clean-architecture layout and flag anything that should move to domain or data. » Ce type de suivi transforme la compétence d’un guide de conception en véritable outil de migration.