claude/lib/project-archetypes/dotfiles-meta.md

name	category	public	database	hosting_hints	audit_stack	plugins
dotfiles-meta	meta	false	none	git-repo-personal github	analyze code-clean cso doc	context7 ui-ux-pro-max gstack no no 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/