@inprogress/ai-core 1.0.0

package/.agent_env/skills/advanced-skill-creator/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: advanced-skill-creator
+description: Cree ou met a jour une skill avancee avec des declencheurs clairs, une procedure et des fichiers de support.
+---
+
+# advanced-skill-creator
+
+## Objectif
+Transformer une idee brute (ou des notes) en Skill prete pour la production avec :
+- Des declencheurs clairs ("Utiliser cette skill quand...")
+- Des etapes de procedure explicites
+- Un contrat d'entree/sortie
+- Des fichiers de support optionnels mais structures : rules.md, examples.md, checklist.md, templates/*
+- Un minimum d'ambiguite et des conventions coherentes
+
+## Quand utiliser
+Utiliser cette skill quand :
+- Vous voulez creer un nouveau dossier de skill
+- Vous voulez faire evoluer une skill existante
+- Vous voulez des skills coherentes et partageables en equipe
+
+## Entrees (a demander ou deduire)
+L'utilisateur devrait fournir (si absent, deduire des valeurs raisonnables et expliciter les hypotheses) :
+- Nom de la skill (kebab-case) et description en une ligne
+- Perimetre : problemes couverts / non couverts
+- Taches ou scenarios typiques (2 a 5)
+- Contexte technique cible (langage/framework/outils) si pertinent
+- Attentes de sortie (ce que "termine" signifie)
+- Contraintes ou politiques fortes (securite, style, conventions du repo)
+
+## Sorties (obligatoires)
+Toujours produire :
+1) Plan de dossier : `.agent_env/skills/<skill-name>/...`
+2) `SKILL.md`
+3) `checklist.md`
+
+Produire en option (si utile ou demande) :
+- `rules.md` (contraintes fortes)
+- `examples.md` (exemples guides)
+- `templates/*.md` (artefacts copier/coller pour la procedure)
+
+## Procedure (a suivre strictement)
+1) **Normaliser le nom de la skill**
+   - Verifier le kebab-case
+   - Proposer une description concise
+
+2) **Definir le perimetre**
+   - Puces dans le perimetre / hors perimetre
+   - Identifier 2 a 5 scenarios centraux
+
+3) **Ecrire les declencheurs**
+   - Liste "Utiliser cette skill quand..."
+   - Liste "Ne PAS utiliser cette skill quand..."
+
+4) **Definir le contrat d'entree/sortie**
+   - Entrees (obligatoires vs optionnelles)
+   - Sorties (artefacts explicites + formats)
+   - Niveau de qualite / definition de termine
+
+5) **Concevoir la procedure avancee**
+   - 6 a 10 etapes max
+   - Inclure des points de decision et le comportement "si info manquante"
+   - Referencer explicitement `rules.md`, `templates/*` et `checklist.md` quand pertinent
+
+6) **Creer les fichiers de support**
+   - `rules.md` : uniquement invariants et non-negociables
+   - `examples.md` : 2 a 6 exemples courts max (bons modeles)
+   - `templates/*` : seulement si cela reduit l'effort repetitif
+
+7) **Finaliser avec la checklist**
+   - Doit etre actionnable
+   - Doit inclure la validation (tests/lint, etc. si pertinent)
+
+8) **Format de sortie**
+   - Fournir le contenu final de chaque fichier dans des blocs de code separes.
+   - Ne pas ajouter de narration inutile ; rester directement implementable.
+
+## Conventions a suivre
+- Garder `SKILL.md` leger : orchestration + contrats + procedure.
+- Mettre les regles detaillees dans `rules.md`, pas dans `SKILL.md`.
+- Utiliser des chemins relatifs au dossier de la skill pour les references de fichiers.
+- Preferer un langage deterministe : DOIT / DEVRAIT / PEUT.
+- Eviter les exemples enormes ; rester court et a fort signal.
+
+## Si des informations manquent
+- Faire des hypotheses raisonnables.
+- Lister clairement les hypotheses en haut du `SKILL.md` genere, sous une section "Hypotheses".
+- Ajouter une courte section "Questions a confirmer plus tard" (max 5 questions), tout en livrant la skill.

package/.agent_env/skills/advanced-skill-creator/checklist.md

@@ -0,0 +1,26 @@
+# advanced-skill-creator - Liste de controle (avant livraison)
+
+## Structure de la skill
+- [ ] Le nom du dossier est en kebab-case et correspond au nom de la skill dans SKILL.md
+- [ ] SKILL.md existe et joue le role d'orchestrateur (pas un depot de details)
+- [ ] checklist.md existe et est actionnable
+
+## Exigences niveau 2
+- [ ] Les declencheurs "Quand utiliser" sont explicites (>= 3 puces)
+- [ ] Les declencheurs "Ne PAS utiliser" sont explicites (>= 2 puces)
+- [ ] Le perimetre inclut ce qui est dans le perimetre et hors perimetre
+- [ ] Les entrees sont separees en obligatoires vs optionnelles
+- [ ] Les sorties sont des artefacts explicites avec leurs formats
+- [ ] La procedure contient 6 a 10 etapes et inclut des points de decision
+- [ ] La procedure reference explicitement les fichiers de support (rules/templates/checklist)
+
+## Fichiers de support (si presents)
+- [ ] rules.md ne contient que des invariants et des exigences non negociables
+- [ ] examples.md contient 2 a 6 exemples concis (pas de longs blocs verbeux)
+- [ ] Les templates sont nommes par objectif et faciles a copier/coller
+
+## Qualite
+- [ ] Aucune regle contradictoire entre SKILL.md et rules.md
+- [ ] Aucune hypothese specifique au repo sans mention explicite des hypotheses
+- [ ] Definition de termine claire
+

package/.agent_env/skills/advanced-skill-creator/rules.md

@@ -0,0 +1,12 @@
+# advanced-skill-creator - Regles (contraintes fortes)
+
+- DOIT generer des skills partageables entre depots (destinees a etre committees).
+- DOIT utiliser le kebab-case pour les noms de dossiers de skills.
+- DOIT inclure : declencheurs, perimetre, contrat I/O, procedure et references checklist.
+- DOIT garder `SKILL.md` centre sur l'orchestration ; les details lourds vont dans les fichiers de support.
+- DOIT eviter les allers-retours longs : produire une v1 exploitable meme avec des infos partielles.
+- NE DOIT PAS inventer des commandes specifiques au repo ; si necessaire, indiquer de suivre AGENTS.md.
+- DEVRAIT creer des templates seulement quand ils reduisent le travail repetitif (eviter le spam de templates).
+- DEVRAIT inclure une section "Ne PAS utiliser cette skill quand" pour eviter les mauvais usages.
+- DEVRAIT inclure "Cas limites / modes d'echec" quand le domaine est risque ou ambigu.
+

package/.agent_env/skills/advanced-skill-creator/templates/SKILL.template.md

@@ -0,0 +1,59 @@
+# <skill-name>
+
+## Description
+<description en une ligne>
+
+## Hypotheses (si necessaire)
+- <hypothese 1>
+- <hypothese 2>
+
+## Quand utiliser
+Utiliser cette skill quand :
+- ...
+- ...
+- ...
+
+Ne PAS utiliser cette skill quand :
+- ...
+- ...
+
+## Perimetre
+Dans le perimetre :
+- ...
+- ...
+
+Hors perimetre :
+- ...
+- ...
+
+## Entrees
+Obligatoires :
+- ...
+
+Optionnelles :
+- ...
+
+## Sorties
+Vous DEVEZ produire :
+- <artefact 1> (format : ...)
+- <artefact 2> (format : ...)
+
+Vous POUVEZ aussi produire :
+- ...
+
+## Procedure
+Suivre strictement ces etapes :
+1) ...
+2) ...
+3) Si <condition>, alors ...
+4) Charger `rules.md` et appliquer les contraintes.
+5) Utiliser les templates de `templates/` si vous produisez des artefacts.
+6) Avant finalisation, executer `checklist.md`.
+
+## Cas limites / modes d'echec
+- ...
+- ...
+
+## Questions a confirmer plus tard (max 5)
+- ...
+

package/.agent_env/skills/advanced-skill-creator/templates/checklist.template.md

@@ -0,0 +1,11 @@
+# <skill-name> - Liste de controle
+
+## Avant livraison
+- [ ] ...
+- [ ] ...
+- [ ] ...
+
+## Validation (si code)
+- [ ] Les tests passent (suivre AGENTS.md)
+- [ ] Le lint/format passe (suivre AGENTS.md)
+- [ ] Pas de changement cassant sans note explicite

package/.agent_env/skills/advanced-skill-creator/templates/examples.template.md

@@ -0,0 +1,21 @@
+# <skill-name> - Exemples
+
+## Exemple 1 (bon)
+Entree :
+- ...
+
+Sortie :
+- ...
+
+Notes :
+- ...
+
+## Exemple 2 (bon)
+Entree :
+- ...
+
+Sortie :
+- ...
+
+Notes :
+- ...

package/.agent_env/skills/advanced-skill-creator/templates/rules.template.md

@@ -0,0 +1,6 @@
+# <skill-name> - Regles (contraintes fortes)
+
+- DOIT ...
+- DOIT ...
+- DEVRAIT ...
+- NE DOIT PAS ...

package/.agent_env/skills/advanced-skill-creator/templates/templates.README.md

@@ -0,0 +1,10 @@
+# Utilisation des templates
+
+Creer des templates uniquement quand :
+- La skill produit regulierement la meme structure d'artefact, OU
+- Une structure copier/coller reduit les erreurs et fait gagner du temps.
+
+Nommage :
+- Utiliser le kebab-case et nommer selon l'objectif : `endpoint-rest.md`, `test-plan.md`, `story.md`.
+
+Garder les templates courts et centres sur la tache.

package/.agent_env/skills/i18next-translation/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: i18next-translation
+description: Maintient et fait evoluer les traductions i18next dans des projets React/JavaScript/TypeScript.
+---
+
+# i18next-translation
+
+## Hypotheses
+- Langue source par defaut : `en`.
+- Les langues cibles sont deduites des ressources i18next existantes si non precisees.
+- Le perimetre doit rester minimal et limite aux fichiers necessaires.
+- L'architecture i18next existante (namespaces vs monolithique) doit etre preservee.
+
+## Utiliser cette skill quand
+- Vous ajoutez des cles i18next (`add_keys`) dans une feature React/JS/TS.
+- Vous migrez des textes UI en dur vers i18next (`migrate_hardcoded`).
+- Vous refactorez des namespaces/slices i18next (`refactor_namespaces`).
+- Vous auditez la parite multi-langues et la securite des interpolations (`audit_only`).
+
+## Ne PAS utiliser cette skill quand
+- La demande concerne seulement la traduction linguistique sans modification technique du code/ressources.
+- Le projet n'utilise pas i18next.
+- Une migration d'architecture globale est demandee sans validation explicite.
+
+## Perimetre
+Dans le perimetre :
+- Detection de la structure i18next du projet.
+- Ajout/reorganisation de cles avec nommage semantique stable.
+- Migration de textes en dur vers `t(...)` ou `Trans`.
+- Verification de la parite structurelle entre langues et des placeholders.
+
+Hors perimetre :
+- Refonte complete de l'architecture i18n sans demande explicite.
+- Suppression de cles existantes sans confirmation explicite.
+- Validation linguistique humaine finale (qualite stylistique des traductions).
+
+## Entrees
+Obligatoires :
+- Type de tache : `add_keys` | `migrate_hardcoded` | `refactor_namespaces` | `audit_only`.
+- Perimetre (fichiers/dossiers) ou autorisation de deduction automatique minimale.
+
+Optionnelles :
+- Langue source (par defaut `en`).
+- Langues cibles.
+- Contraintes de modification des traductions existantes.
+- Conventions projet (camelCase/snake_case, pluralisation, namespaces partages).
+
+## Sorties
+- Modifications des fichiers i18n et du code d'usage dans le perimetre.
+- Rapport final avec :
+  1. structure detectee,
+  2. strategie namespace,
+  3. cles ajoutees/modifiees,
+  4. mapping `ancien -> nouveau` (si migration),
+  5. fichiers modifies,
+  6. statut de validation (`ok` / `a_verifier`) et risques restants.
+
+Definition de termine :
+- Les memes chemins de cles existent dans toutes les langues cibles.
+- Les placeholders/tokens sont preserves.
+- Pas de nouveau `import { t } from "i18next"` dans les composants React.
+- Pas de suppression de cles sans validation explicite.
+- Checklist `checklist.md` completee.
+
+## Procedure
+1. Clarifier ou deduire les entrees minimales (type de tache, source/targets, perimetre, contraintes).
+2. Detecter la structure i18next existante (namespaces par langue, fichier monolithique, objet JS/TS).
+3. Identifier la strategie de reutilisation (namespace et cles existantes) avant toute creation.
+4. Planifier les changements avec mapping explicite (notamment `texte_en_dur -> cle`) si applicable.
+5. Modifier les ressources en langue source, puis reproduire les memes chemins dans toutes les langues cibles.
+6. Mettre a jour les points d'appel (`useTranslation`, `t`, `Trans`) sans changer l'architecture globale.
+7. Appliquer les invariants de `rules.md` et verifier les points de `checklist.md`.
+8. Produire le rapport final au format defini dans la section Sorties.
+
+## Fichiers de support
+- Regles non negociables : `rules.md`
+- Validation operationnelle : `checklist.md`
+
+## Questions a confirmer plus tard
+- Quelles langues cibles doivent etre strictement maintenues a parite ?
+- La modification de traductions existantes est-elle autorisee ?
+- Quelle convention de nommage est obligatoire (camelCase/snake_case) ?
+- Y a-t-il des scripts/tests i18n internes a lancer systematiquement ?
+- Le perimetre doit-il inclure seulement l'interface React ou aussi le rendu cote serveur ?
+
+
+

package/.agent_env/skills/i18next-translation/checklist.md

@@ -0,0 +1,38 @@
+# Liste de controle i18next-translation
+
+## Cadrage
+- [ ] Type de tache confirme (`add_keys`, `migrate_hardcoded`, `refactor_namespaces`, `audit_only`).
+- [ ] Perimetre des fichiers/dossiers confirme ou deduit de facon minimale.
+- [ ] Langue source confirmee ou deduite (`en` par defaut).
+- [ ] Langues cibles confirmees ou deduites.
+- [ ] Contraintes de modification des traductions existantes clarifiees.
+
+## Detection de structure
+- [ ] Structure i18next identifiee (namespaces par langue, monolithique, objet JS/TS).
+- [ ] Namespaces et cles existantes candidates a la reutilisation inventoriees.
+- [ ] Aucun changement d'architecture globale non demande.
+
+## Execution
+- [ ] Mapping explicite `ancien -> nouveau` prepare pour migration de textes en dur.
+- [ ] Nouvelles cles ajoutees d'abord en langue source.
+- [ ] Memes chemins de cles reproduits dans toutes les langues cibles.
+- [ ] Points d'appel migres vers `t(...)` / `Trans` selon le contexte.
+- [ ] Aucun nouveau `import { t } from "i18next"` dans des composants React.
+
+## Validation
+- [ ] Parite structurelle des chemins de cles validee entre langues.
+- [ ] Placeholders/interpolations preserves sans alteration.
+- [ ] Tokens markup preserves (si `Trans` utilise).
+- [ ] Aucune suppression de cle sans validation explicite.
+- [ ] Aucun texte UI en dur residuel dans le perimetre (si migration).
+- [ ] Tests/lint i18n du projet executes si disponibles, sinon marque `a_verifier`.
+
+## Rapport final
+- [ ] Structure detectee reportee.
+- [ ] Strategie namespace (reutilises/crees) reportee.
+- [ ] Cles ajoutees/modifiees listees.
+- [ ] Mapping `ancien -> nouveau` fourni (si migration).
+- [ ] Fichiers modifies listes.
+- [ ] Resultats de validation (`ok` / `a_verifier`) et risques restants inclus.
+
+

package/.agent_env/skills/i18next-translation/rules.md

@@ -0,0 +1,12 @@
+# Regles non negociables
+
+- Dans les composants React, preferer `useTranslation()`.
+- Ne pas introduire `import { t } from "i18next"` dans des composants React.
+- Hors composant, preferer passer `t` en parametre ou utiliser l'instance i18n du projet.
+- Toute cle ajoutee doit exister dans toutes les langues cibles avec le meme chemin.
+- Ne pas supprimer de cles existantes sans confirmation explicite.
+- Preserver exactement les placeholders/interpolations (`{{name}}`, `{{count}}`, etc.).
+- Preserver les tokens markup (`<bold>...</bold>`, etc.) utilises avec `Trans`.
+- Ne pas introduire de namespaces/cles fourre-tout: `misc`, `temp`, `other`, `data`, `label_1`.
+- Ne pas changer l'architecture i18next globale sans demande explicite.
+- Garder la convention de nommage des cles deja adoptee par le projet (camelCase ou snake_case).

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@inprogress/ai-core",
+  "version": "1.0.0",
+  "private": false,
+  "description": "Provides core functionalities for Iprogress Agency agents based on AGENT_ENV environment variable.",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "postinstall.js",
+    ".agent_env"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,29 @@
+const fs = require("fs");
+const path = require("path");
+
+const agentEnv = process.env.AGENT_ENV;
+if (!agentEnv) {
+  console.error("[agent-env-installer] AGENT_ENV is not defined.");
+  process.exit(1);
+}
+
+const targetRepo = process.env.INIT_CWD || process.cwd();
+const sourceDir = path.join(__dirname, ".agent_env");
+const targetDir = path.join(targetRepo, `.${agentEnv}`);
+const gitignorePath = path.join(targetRepo, ".gitignore");
+
+fs.rmSync(targetDir, { recursive: true, force: true });
+fs.cpSync(sourceDir, targetDir, { recursive: true });
+
+const entry = `.${agentEnv}`;
+const currentGitignore = fs.existsSync(gitignorePath)
+  ? fs.readFileSync(gitignorePath, "utf8")
+  : "";
+
+const lines = currentGitignore.split(/\r?\n/).filter(Boolean);
+if (!lines.includes(entry)) {
+  const nextContent = currentGitignore.endsWith("\n") || currentGitignore.length === 0
+    ? `${currentGitignore}${entry}\n`
+    : `${currentGitignore}\n${entry}\n`;
+  fs.writeFileSync(gitignorePath, nextContent, "utf8");
+}