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".4metadata:5 source: https://skillmd.com/skills/deuwi/freelance-manager6---78# Freelance Manager910Aide à la décision pour freelance micro-entrepreneur (BNC libéral, SSI).11Principe : **les scripts calculent, Claude juge**. Ne jamais refaire à la main12un calcul que `fm.py` sait faire — lancer le script et interpréter sa sortie.1314## Architecture1516- `scripts/fm.py` — CLI unique, stdlib Python uniquement.17- `references/strategies.md` — à lire UNIQUEMENT quand la question porte sur18 trouver des missions, choisir une plateforme, prospecter, ou diversifier19 ses revenus. Toujours lancer `fm.py status` ET lire le profil utilisateur20 avant de conseiller : la bonne stratégie dépend du runway et du profil.21- Données dans `~/.freelance-manager/` (config.json, profil.md,22 missions.json, treso.json, temps.json). Créées par `fm.py init`. Toute23 l'information personnelle vit dans ce dossier, jamais dans la skill.24- `templates/config.json` — taux 2026 par défaut, objectifs à personnaliser.25- `templates/profil.md` — trame du profil utilisateur (stack, localisation,26 réseau, plateformes actives, marque contenu éventuelle).2728## Premier lancement2930```bash31python3 scripts/fm.py init32```3334Puis demander à l'utilisateur, sans jamais inventer ces valeurs :35361. ses chiffres pour `config.json` (TJM cible et plancher, charges perso37 mensuelles, CA annuel cible) ;382. son solde de trésorerie actuel (`fm.py treso set --montant N`) ;393. de quoi remplir `~/.freelance-manager/profil.md` à partir de40 `templates/profil.md` (stack, localisation, réseau direct, plateformes41 actives, marque contenu éventuelle).4243Si `profil.md` manque au moment d'une question stratégie, le créer à ce44moment-là en posant les questions.4546## Cas d'usage → commande4748| Situation | Commande |49|---|---|50| "On me propose une mission à X €/j pendant Y jours, je prends ?" | `fm.py mission eval --tjm X --jours Y [--delai-paiement N]` |51| Mission acceptée | `fm.py mission add --tjm X --jours Y --nom "..."` |52| Paiement reçu | `fm.py ca add --montant N --nom "..."` |53| Dépense pro | `fm.py depense add --montant N --label "..."` |54| "Combien je peux me verser ce mois-ci ?" | `fm.py retrait` |55| "Où j'en suis ?" / état général | `fm.py status` |56| Fin de journée / logging du temps | `fm.py temps log --cat dev --heures N` |57| "Je passe trop de temps sur quoi ?" | `fm.py temps report --semaines 4` |58| Point hebdo du lundi | `fm.py hebdo` |5960Catégories de temps : dev, contenu, prospection, admin, veille. (Si61l'utilisateur n'a pas d'activité contenu, la catégorie reste simplement62inutilisée.)6364## Rôle de Claude après le script65661. **mission eval** : le script donne un score et une recommandation67 mécanique. Claude ajoute le contexte que le script ignore : pipeline68 actuel, intérêt stratégique (techno, référence client, compatibilité avec69 les projets annexes déclarés au profil — contenu, produits, side70 projects), charge mentale, risque client. Si le score mécanique et le71 contexte divergent, le dire explicitement.722. **retrait** : ne jamais recommander un retrait supérieur au chiffre du73 script. En dessous, oui, si un événement à venir le justifie.743. **hebdo** : lire la sortie complète, en tirer 3 priorités max pour la75 semaine, formulées en une phrase chacune. Pas de paraphrase de tous les76 chiffres — l'utilisateur les a sous les yeux.774. **temps report** : les écarts > 15 pts sont flaggés ⚠ par le script.78 Commenter uniquement les écarts flaggés.7980## Règles8182- Réponses courtes. La sortie du script fait foi, Claude n'ajoute que le83 jugement.84- Les taux (cotisations 25,6 %, CFP 0,2 %, VL 2,2 %, seuils TVA85 37 500/41 250 €, plafond 83 600 €) vivent dans config.json — vérifiés86 juillet 2026. En janvier, proposer une vérification sur urssaf.fr avant87 toute autre chose.88- Le profil (`profil.md`) est une donnée utilisateur au même titre que89 config.json : ne jamais y présupposer une stack, une région, un réseau ou90 une audience.91- Le calcul de retrait est prudentiel (provisions URSSAF + impôt + buffer).92 Ce n'est pas un conseil fiscal ni financier : pour les cas limites93 (dépassement de seuils, option versement libératoire, sortie du régime94 micro), recommander de vérifier auprès de l'URSSAF ou d'un95 expert-comptable.96- Ne jamais stocker de données bancaires (IBAN, identifiants) dans les97 fichiers de données.