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/

dotfiles-meta.md 4.1 KB History Raw