feat(archetypes): add project archetype library + detection algorithm

Introduce ~/.claude/lib/project-archetypes/ with 25 archetype files (web, mobile, APIs, CMS, infra, firmware, etc.) and the detection algorithm in lib/archetype-detector.md. Consumed by /onboard STEP 1 to drive archetype-specific audit stacks and plugin recommendations. Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-21 22:37:07 +02:00
parent 72920e032e
commit 3c8b2a8f68
26 changed files with 3080 additions and 0 deletions
@@ -0,0 +1,115 @@
+---
+name: dotfiles-meta
+category: meta
+public: false
+database: none
+hosting_hints:
+  - git-repo-personal
+  - github
+audit_stack:
+  - analyze
+  - code-clean
+  - cso
+  - doc
+plugins:
+  context7: no
+  ui-ux-pro-max: no
+  gstack: no
+---
+
+# Dotfiles / Meta-tooling / Config framework
+
+Repo qui ne produit pas d'application mais du **configuration / scripts / conventions** — dotfiles personnels, framework de config partagée, collection de scripts de provisionning, hooks, templates.
+
+Exemple : un repo `claude-config` avec scripts shell + settings JSON + templates + agents, sans langage applicatif compilé.
+
+## Detection signals
+
+### Strong signals (×3)
+- FILE: `install.sh` OR `install-*.sh`
+- FILE: `Makefile` AVEC STRING "install:" OR "link:" OR "setup:"
+- DIR: `hooks/` (PAS git/.git/hooks — hooks custom projet)
+- DIR: `templates/` AVEC contenu de config (non-code applicatif)
+- FILE: `settings.json` à la racine (hors dossier d'app type .vscode/)
+- STRING_IN_FILE: `README.md` contient "dotfiles" OR "config framework" OR "provisioning"
+
+### Medium signals (×2)
+- EXT: 5+ fichiers .sh
+- EXT: 10+ fichiers .md
+- FILE: `link.sh` OR `symlink.sh` OR `bootstrap.sh`
+- DIR: `agents/` OR `skills/` OR `scripts/` (sans code applicatif associé)
+- FILE: `plugins.lock.json` OR `plugins.json`
+
+### Weak signals (×1)
+- FILE: `CHANGELOG.md` de releases de config (pas d'app)
+- FILE: `.gitmodules` (sub-projects config)
+- FILE: `doctor.sh` OR `health.sh`
+- DIR: `lib/` contenant surtout du .sh ou .md (pas du code applicatif)
+
+### Counter-signals (exclusion — si matché, rejette)
+- FILE: `package.json` AVEC DEPS applicatives (react/next/express/etc.)
+- FILE: `pyproject.toml` AVEC `[project.scripts]` OR deps applicatives
+- FILE: `Cargo.toml` AVEC `[[bin]]`
+- FILE: `index.html` au root → web project
+- FILE: `wp-config.php` → WordPress
+
+## Implications
+- **Distribution** : git clone personnel / GitHub public / fork
+- **Base de données** : aucune
+- **SEO/GEO** : N/A
+- **Surface sécurité** : MOYENNE — scripts exécutés sur machine utilisateur, risque élevé si compromis (exécution arbitraire en shell)
+- **UI/UX** : N/A
+
+## Typical pain points
+- Scripts shell sans `set -euo pipefail` → échecs silencieux
+- Pas de `shellcheck` en CI
+- Symlinks / installation non idempotents (re-run casse l'état)
+- Pas de test / dry-run mode
+- Pas de détection OS (cmd Linux-only qui casse sur macOS, ou inverse)
+- Secrets en dur dans templates (API keys, tokens)
+- `curl | sh` dans README (risque MITM, pas de checksum)
+- Versioning flou (pas de CHANGELOG cohérent)
+- Breaking changes non signalés aux utilisateurs
+- Dépendances externes non vérifiées (brew/apt/npm auto-install sans consentement)
+- Uninstall / rollback absent
+- Documentation incomplète (comment étendre, comment contribuer)
+- Pas de `LICENSE`
+
+## Interview questions (adaptive)
+En plus du set minimum business :
+- Audience : personnel (dotfiles privés) / équipe / public open source ?
+- OS cibles : Linux / macOS / WSL / Windows natif / tous ?
+- Shell cible : bash / zsh / fish / multi ?
+- Idempotence : les scripts peuvent-ils être re-exécutés sans casser ? (oui / non / à vérifier)
+- Mode dry-run / preview disponible ? (oui / non / souhaité)
+- Tests automatiques : shellcheck / bats / aucun ?
+- Distribution : git clone manuel / installer en un liner / brew tap / autre ?
+- Dépendances externes auto-installées ? (brew/apt/npm/pip) — avec consentement utilisateur ?
+- Uninstall prévu ? (oui / non)
+- Versioning : semver / dates / aucun ?
+- `CHANGELOG.md` maintenu ? (oui / non)
+- Hébergement : GitHub public / privé / GitLab / autre ?
+
+## Plugin recommendations
+- **context7** : OFF — pas de fast-libs
+- **ui-ux-pro-max** : OFF
+- **gstack** : OFF
+
+## Example project layout
+```
+install.sh
+link.sh
+doctor.sh
+Makefile
+CLAUDE.md          (si le repo lui-même est un contexte Claude)
+README.md
+CHANGELOG.md
+settings.json      (config globale outil)
+plugins.lock.json  (lockfile d'extensions)
+agents/            (agents custom)
+skills/            (skills custom)
+hooks/             (hooks projet, pas git)
+templates/         (templates config fournis)
+lib/               (helpers shell)
+tasks/
+```