Freelance Manager
Aide à la décision pour freelance micro-entrepreneur (BNC libéral, SSI).
Principe : les scripts calculent, Claude juge. Ne jamais refaire à la main
un calcul que fm.py sait faire — lancer le script et interpréter sa sortie.
Architecture
scripts/fm.py — CLI unique, stdlib Python uniquement.references/strategies.md — à lire UNIQUEMENT quand la question porte sur
trouver des missions, choisir une plateforme, prospecter, ou diversifier
ses revenus. Toujours lancer fm.py status ET lire le profil utilisateur
avant de conseiller : la bonne stratégie dépend du runway et du profil.- Données dans
~/.freelance-manager/ (config.json, profil.md,
missions.json, treso.json, temps.json). Créées par fm.py init. Toute
l'information personnelle vit dans ce dossier, jamais dans la skill.
templates/config.json — taux 2026 par défaut, objectifs à personnaliser.templates/profil.md — trame du profil utilisateur (stack, localisation,
réseau, plateformes actives, marque contenu éventuelle).
Premier lancement
python3 scripts/fm.py init
Puis demander à l'utilisateur, sans jamais inventer ces valeurs :
- ses chiffres pour
config.json (TJM cible et plancher, charges perso
mensuelles, CA annuel cible) ;
- son solde de trésorerie actuel (
fm.py treso set --montant N) ;
- de quoi remplir
~/.freelance-manager/profil.md à partir de
templates/profil.md (stack, localisation, réseau direct, plateformes
actives, marque contenu éventuelle).
Si profil.md manque au moment d'une question stratégie, le créer à ce
moment-là en posant les questions.
Cas d'usage → commande
| Situation |
Commande |
| "On me propose une mission à X €/j pendant Y jours, je prends ?" |
fm.py mission eval --tjm X --jours Y [--delai-paiement N] |
| Mission acceptée |
fm.py mission add --tjm X --jours Y --nom "..." |
| Paiement reçu |
fm.py ca add --montant N --nom "..." |
| Dépense pro |
fm.py depense add --montant N --label "..." |
| "Combien je peux me verser ce mois-ci ?" |
fm.py retrait |
| "Où j'en suis ?" / état général |
fm.py status |
| Fin de journée / logging du temps |
fm.py temps log --cat dev --heures N |
| "Je passe trop de temps sur quoi ?" |
fm.py temps report --semaines 4 |
| Point hebdo du lundi |
fm.py hebdo |
Catégories de temps : dev, contenu, prospection, admin, veille. (Si
l'utilisateur n'a pas d'activité contenu, la catégorie reste simplement
inutilisée.)
Rôle de Claude après le script
- mission eval : le script donne un score et une recommandation
mécanique. Claude ajoute le contexte que le script ignore : pipeline
actuel, intérêt stratégique (techno, référence client, compatibilité avec
les projets annexes déclarés au profil — contenu, produits, side
projects), charge mentale, risque client. Si le score mécanique et le
contexte divergent, le dire explicitement.
- retrait : ne jamais recommander un retrait supérieur au chiffre du
script. En dessous, oui, si un événement à venir le justifie.
- hebdo : lire la sortie complète, en tirer 3 priorités max pour la
semaine, formulées en une phrase chacune. Pas de paraphrase de tous les
chiffres — l'utilisateur les a sous les yeux.
- temps report : les écarts > 15 pts sont flaggés ⚠ par le script.
Commenter uniquement les écarts flaggés.
Règles
- Réponses courtes. La sortie du script fait foi, Claude n'ajoute que le
jugement.
- Les taux (cotisations 25,6 %, CFP 0,2 %, VL 2,2 %, seuils TVA
37 500/41 250 €, plafond 83 600 €) vivent dans config.json — vérifiés
juillet 2026. En janvier, proposer une vérification sur urssaf.fr avant
toute autre chose.
- Le profil (
profil.md) est une donnée utilisateur au même titre que
config.json : ne jamais y présupposer une stack, une région, un réseau ou
une audience.
- Le calcul de retrait est prudentiel (provisions URSSAF + impôt + buffer).
Ce n'est pas un conseil fiscal ni financier : pour les cas limites
(dépassement de seuils, option versement libératoire, sortie du régime
micro), recommander de vérifier auprès de l'URSSAF ou d'un
expert-comptable.
- Ne jamais stocker de données bancaires (IBAN, identifiants) dans les
fichiers de données.
1---2name: freelance-manager3description: Gestionnaire de décisions freelance pour micro-entrepreneur BNC (dev). Calcule via scripts Python (zéro jeton de calcul) la rentabilité d'une mission (TJM, net après cotisations 25,6 % + CFP), la trésorerie, le retrait mensuel safe, la distance aux seuils TVA (37 500 €) et plafond micro (83 600 €), et la répartition du temps (dev/contenu/prospection). Inclut aussi une référence stratégie (plateformes, canaux de prospection, modèles de revenus). Utiliser cette skill dès que l'utilisateur parle d'accepter ou refuser une mission, d'un TJM, d'une proposition client, de combien se payer ce mois-ci, de trésorerie, de cotisations URSSAF, de seuil TVA, de son point hebdo freelance, de comment répartir son temps, de où et comment trouver des missions, de quelles plateformes freelance utiliser, ou de comment gagner de l'argent en tant que dev indépendant — même sans mentionner explicitement "freelance manager".4---56# Freelance Manager78Aide à la décision pour freelance micro-entrepreneur (BNC libéral, SSI).9Principe : **les scripts calculent, Claude juge**. Ne jamais refaire à la main10un calcul que `fm.py` sait faire — lancer le script et interpréter sa sortie.1112## Architecture1314- `scripts/fm.py` — CLI unique, stdlib Python uniquement.15- `references/strategies.md` — à lire UNIQUEMENT quand la question porte sur16 trouver des missions, choisir une plateforme, prospecter, ou diversifier17 ses revenus. Toujours lancer `fm.py status` ET lire le profil utilisateur18 avant de conseiller : la bonne stratégie dépend du runway et du profil.19- Données dans `~/.freelance-manager/` (config.json, profil.md,20 missions.json, treso.json, temps.json). Créées par `fm.py init`. Toute21 l'information personnelle vit dans ce dossier, jamais dans la skill.22- `templates/config.json` — taux 2026 par défaut, objectifs à personnaliser.23- `templates/profil.md` — trame du profil utilisateur (stack, localisation,24 réseau, plateformes actives, marque contenu éventuelle).2526## Premier lancement2728```bash29python3 scripts/fm.py init30```3132Puis demander à l'utilisateur, sans jamais inventer ces valeurs :33341. ses chiffres pour `config.json` (TJM cible et plancher, charges perso35 mensuelles, CA annuel cible) ;362. son solde de trésorerie actuel (`fm.py treso set --montant N`) ;373. de quoi remplir `~/.freelance-manager/profil.md` à partir de38 `templates/profil.md` (stack, localisation, réseau direct, plateformes39 actives, marque contenu éventuelle).4041Si `profil.md` manque au moment d'une question stratégie, le créer à ce42moment-là en posant les questions.4344## Cas d'usage → commande4546| Situation | Commande |47|---|---|48| "On me propose une mission à X €/j pendant Y jours, je prends ?" | `fm.py mission eval --tjm X --jours Y [--delai-paiement N]` |49| Mission acceptée | `fm.py mission add --tjm X --jours Y --nom "..."` |50| Paiement reçu | `fm.py ca add --montant N --nom "..."` |51| Dépense pro | `fm.py depense add --montant N --label "..."` |52| "Combien je peux me verser ce mois-ci ?" | `fm.py retrait` |53| "Où j'en suis ?" / état général | `fm.py status` |54| Fin de journée / logging du temps | `fm.py temps log --cat dev --heures N` |55| "Je passe trop de temps sur quoi ?" | `fm.py temps report --semaines 4` |56| Point hebdo du lundi | `fm.py hebdo` |5758Catégories de temps : dev, contenu, prospection, admin, veille. (Si59l'utilisateur n'a pas d'activité contenu, la catégorie reste simplement60inutilisée.)6162## Rôle de Claude après le script63641. **mission eval** : le script donne un score et une recommandation65 mécanique. Claude ajoute le contexte que le script ignore : pipeline66 actuel, intérêt stratégique (techno, référence client, compatibilité avec67 les projets annexes déclarés au profil — contenu, produits, side68 projects), charge mentale, risque client. Si le score mécanique et le69 contexte divergent, le dire explicitement.702. **retrait** : ne jamais recommander un retrait supérieur au chiffre du71 script. En dessous, oui, si un événement à venir le justifie.723. **hebdo** : lire la sortie complète, en tirer 3 priorités max pour la73 semaine, formulées en une phrase chacune. Pas de paraphrase de tous les74 chiffres — l'utilisateur les a sous les yeux.754. **temps report** : les écarts > 15 pts sont flaggés ⚠ par le script.76 Commenter uniquement les écarts flaggés.7778## Règles7980- Réponses courtes. La sortie du script fait foi, Claude n'ajoute que le81 jugement.82- Les taux (cotisations 25,6 %, CFP 0,2 %, VL 2,2 %, seuils TVA83 37 500/41 250 €, plafond 83 600 €) vivent dans config.json — vérifiés84 juillet 2026. En janvier, proposer une vérification sur urssaf.fr avant85 toute autre chose.86- Le profil (`profil.md`) est une donnée utilisateur au même titre que87 config.json : ne jamais y présupposer une stack, une région, un réseau ou88 une audience.89- Le calcul de retrait est prudentiel (provisions URSSAF + impôt + buffer).90 Ce n'est pas un conseil fiscal ni financier : pour les cas limites91 (dépassement de seuils, option versement libératoire, sortie du régime92 micro), recommander de vérifier auprès de l'URSSAF ou d'un93 expert-comptable.94- Ne jamais stocker de données bancaires (IBAN, identifiants) dans les95 fichiers de données.
deuwi