@neuravim/aiden 0.12.0

package/README.fr.md

@@ -0,0 +1,204 @@
+# AIDEN — AI-Driven Engineering
+
+[![npm version](https://img.shields.io/npm/v/@neuravim/aiden)](https://www.npmjs.com/package/@neuravim/aiden)
+[![npm downloads](https://img.shields.io/npm/dm/@neuravim/aiden)](https://www.npmjs.com/package/@neuravim/aiden)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue)](https://github.com/neuravim/aiden/blob/master/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://github.com/neuravim/aiden)
+[![Tests](https://img.shields.io/badge/tests-444%20passing-brightgreen)](https://github.com/neuravim/aiden)
+
+🇬🇧 [English](README.md) | 🇫🇷 [Français](#)
+
+**AIDEN orchestre des agents IA spécialisés pour transformer une demande en code livré, testé et tracé.** Vous décrivez ce que vous voulez, AIDEN répartit le travail entre 6 agents (Analyst, Planner, Dev, QA, DocOps) et livre du code avec traçabilité complète des décisions IA.
+
+Conçu pour les équipes de développement en entreprise : multi-provider agnostique (Claude Code, Gemini, Copilot, OpenCode, API custom), skills et règles injectables, filtrage sécurité, capitalisation des retex, conformité intégrée, feature-first pour le brownfield.
+
+---
+
+## Démarrage rapide (5 minutes)
+
+### Prérequis
+
+- **Node.js 20+** et **bun** (ou npm/yarn)
+- Au moins un provider IA installé : [Claude Code](https://claude.ai/code), [Gemini CLI](https://cloud.google.com/gemini) ou [GitHub Copilot CLI](https://docs.github.com/copilot)
+
+### 1. Installer
+
+```bash
+$ bun add -g @neuravim/aiden
+$ aiden --version    # 0.10.0
+```
+
+### 2. Initialiser dans votre projet
+
+```bash
+$ cd mon-projet
+$ aiden init
+```
+
+AIDEN scanne le projet et détecte automatiquement la stack technique, l'architecture, le CI/CD et le gestionnaire de paquets. Tout est stocké dans `.aiden/` (à commiter avec votre code).
+
+### 3. Premier workflow (flash = bug fix / petite feature)
+
+```bash
+$ aiden flash "Ajouter un endpoint GET /health retournant {status: ok}"
+```
+
+Le mode flash est direct : le Dev implémente, écrit les tests, trace la décision. Pas de cérémonie.
+
+### 4. Workflow complet (standard = feature avec analyse + review)
+
+```bash
+$ aiden standard "Ajouter une API REST de gestion des utilisateurs avec pagination"
+```
+
+Le mode standard enchaîne 4 phases automatiques :
+
+| Phase | Agent | Ce qu'il fait |
+|-------|-------|---------------|
+| Découverte | Analyst | Scanne le code, estime la complexité, identifie les risques |
+| Planification | Planner | Crée une spec + stories avec critères d'acceptation |
+| Implémentation | Dev | Implémente chaque story avec tests |
+| Validation | QA | Review le code vs les critères, boucle avec le Dev si échec |
+
+Artefacts générés dans `.aiden/features/<slug>/` : brief.md, spec.md, stories/, review.md, change-summary.md.
+
+### 5. Vérifier
+
+```bash
+$ aiden status                        # Voir toutes les features
+$ aiden metrics                       # Tokens, coûts, durées
+$ cat .aiden/memory/decisions.jsonl   # Historique des décisions IA
+```
+
+---
+
+## 3 modes adaptatifs
+
+| Mode | Usage | Agents | Temps estimé |
+|------|-------|--------|--------------|
+| `aiden flash` | Bug fix, hotfix, petite feature | Lead + Dev | < 30 min |
+| `aiden standard` | Feature moyenne, nouvelle API | + Analyst, Planner, QA | 2h - 1 jour |
+| `aiden enterprise` | Projet critique, conformité requise | + DocOps + approbation humaine | 1 jour+ |
+
+AIDEN détecte automatiquement le mode optimal. Vous pouvez changer de mode en cours de route sans perdre le travail déjà fait :
+
+```bash
+$ aiden switch export-csv standard    # passer de flash à standard mid-feature
+```
+
+---
+
+## Multi-provider intelligent
+
+Chaque agent reçoit le provider optimal pour sa tâche :
+
+| Tâche | Provider par défaut | Raison |
+|-------|---------------------|--------|
+| Analyse & Review | Claude Code | Meilleur raisonnement |
+| Génération code | Gemini | Multi-fichier performant |
+| Quick fix | Copilot | Rapidité + coût fixe |
+
+4 stratégies de routage : `fixed`, `prefer`, `auto`, `cost-optimized`. Fallback automatique si un provider est indisponible.
+
+---
+
+## Pour les équipes
+
+### Règles d'entreprise
+
+Définissez vos standards dans `.aiden/rules/` (coding standards, sécurité, architecture). Ils sont automatiquement injectés dans les prompts de chaque agent.
+
+```bash
+$ aiden rules add security-policy.md
+```
+
+### Skills (extensibilité)
+
+Les skills sont des packages déclaratifs (YAML + Markdown) qui regroupent instructions, règles et hooks injectables. Déposez un dossier dans `.aiden/skills/` et AIDEN le découvre automatiquement.
+
+```bash
+$ aiden skills init mon-skill          # Créer un skill
+$ aiden skills list                    # Lister les skills
+$ aiden skills enable/disable <name>   # Activer/désactiver
+```
+
+3 templates inclus : `code-review-strict`, `compliance-rgpd`, `jira-sync`.
+
+### Configuration multi-niveaux
+
+5 niveaux de configuration qui se surchargent :
+
+```
+Défauts AIDEN → Config globale (~/.aiden/) → Config projet (.aiden/) → Config feature → Flags CLI
+```
+
+### Conformité et audit
+
+- **decisions.jsonl** : chaque décision IA est tracée (qui, quoi, pourquoi, combien de tokens)
+- **metrics.jsonl** : coût par agent, par provider, par feature
+- **Approbation humaine** en mode enterprise entre chaque phase
+- **DocOps** génère changelog, documentation, runbooks
+
+---
+
+## Commandes
+
+```
+aiden init                          # Initialiser AIDEN dans le projet
+aiden flash "description"           # Mode rapide (Dev direct)
+aiden standard "description"        # Mode standard (Analyst → Planner → Dev → QA)
+aiden enterprise "description"      # Mode enterprise (+ DocOps + approbation)
+aiden status [feature]              # État des features en cours
+aiden resume <feature>              # Reprendre une feature bloquée
+aiden abort <feature>               # Abandonner une feature
+aiden switch <feature> <mode>       # Changer de mode mid-feature
+aiden agent <nom> "prompt"          # Invoquer un agent directement
+aiden provider status|switch|cost   # Gérer les providers IA
+aiden metrics [--export csv]        # Métriques d'utilisation et coûts
+aiden config show|set               # Configuration
+aiden rules add|list|remove         # Règles d'entreprise
+aiden skills list|init|add|remove   # Skills d'extensibilité
+aiden retex add|list|search|remove  # Retours d'expérience
+aiden template customize|list       # Templates d'artefacts
+```
+
+## Mode Claude Code (slash commands)
+
+AIDEN fonctionne aussi directement dans Claude Code sans installer le CLI :
+
+```
+/aiden-init        /aiden-flash       /aiden-standard    /aiden-enterprise
+/aiden-status      /aiden-resume      /aiden-agent       /aiden-rules
+```
+
+Les deux modes (CLI et slash) écrivent dans les mêmes fichiers `.aiden/`.
+
+---
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](docs-site/src/app/getting-started/installation) | Prérequis, installation, configuration provider |
+| [Quickstart](docs-site/src/app/getting-started/quickstart) | Scénario complet de zéro en 5 minutes |
+| [Première feature](docs-site/src/app/getting-started/first-feature) | Workflow standard détaillé phase par phase |
+| [Guide de déploiement](docs/DEPLOIEMENT.md) | Déployer AIDEN dans une organisation |
+| [Modes](docs-site/src/app/guides/modes) | Flash, standard, enterprise : quand utiliser quoi |
+| [Providers](docs-site/src/app/guides/providers) | Claude Code, Gemini, OpenCode, Copilot, API custom |
+| [Règles et templates](docs-site/src/app/guides/rules-and-templates) | Standards d'entreprise |
+| [Skills](docs-site/src/app/guides/skills) | Extensibilité enterprise |
+| [Brownfield](docs-site/src/app/cookbook/brownfield) | Ajouter AIDEN à un projet existant |
+| [Équipe](docs-site/src/app/cookbook/team) | Workflow Git, onboarding, conventions |
+| [CI/CD](docs-site/src/app/cookbook/ci-cd) | Intégration dans les pipelines |
+
+## Tests
+
+```bash
+$ bun test            # 444 tests unitaires
+$ bun run typecheck   # Vérification TypeScript strict
+$ bun run lint        # ESLint
+```
+
+## Licence
+
+AGPL-3.0 — Voir [LICENSE](LICENSE) pour les détails.

package/README.md

@@ -0,0 +1,208 @@
+# AIDEN — AI-Driven Engineering
+
+[![npm version](https://img.shields.io/npm/v/@neuravim/aiden)](https://www.npmjs.com/package/@neuravim/aiden)
+[![npm downloads](https://img.shields.io/npm/dm/@neuravim/aiden)](https://www.npmjs.com/package/@neuravim/aiden)
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue)](https://github.com/neuravim/aiden/blob/master/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://github.com/neuravim/aiden)
+[![Tests](https://img.shields.io/badge/tests-444%20passing-brightgreen)](https://github.com/neuravim/aiden)
+
+🇬🇧 [English](#) | 🇫🇷 [Français](README.fr.md)
+
+**AIDEN orchestrates specialized AI agents to turn a request into delivered, tested, and traced code.** You describe what you want, AIDEN distributes the work across 6 agents (Analyst, Planner, Dev, QA, DocOps) and delivers code with full traceability of AI decisions.
+
+Built for enterprise development teams: provider-agnostic (Claude Code, Gemini, Copilot, OpenCode, custom API), injectable skills and rules, security filtering, lessons learned (retex), built-in compliance, feature-first for brownfield projects.
+
+---
+
+## Quickstart (5 minutes)
+
+### Prerequisites
+
+- **Node.js 20+** and **bun** (or npm/yarn)
+- At least one AI provider installed: [Claude Code](https://claude.ai/code), [Gemini CLI](https://cloud.google.com/gemini) or [GitHub Copilot CLI](https://docs.github.com/copilot)
+
+### 1. Install
+
+```bash
+$ bun add -g @neuravim/aiden
+$ aiden --version    # 0.10.0
+```
+
+### 2. Initialize in your project
+
+```bash
+$ cd my-project
+$ aiden init
+```
+
+AIDEN scans the project and automatically detects the tech stack, architecture, CI/CD and package manager. Everything is stored in `.aiden/` (commit it with your code).
+
+### 3. First workflow (flash = bug fix / small feature)
+
+```bash
+$ aiden flash "Add a GET /health endpoint returning {status: ok}"
+```
+
+Flash mode is direct: Dev implements, writes tests, traces the decision. No ceremony.
+
+### 4. Full workflow (standard = feature with analysis + review)
+
+```bash
+$ aiden standard "Add a user management REST API with pagination"
+```
+
+Standard mode chains 4 automatic phases:
+
+| Phase | Agent | What it does |
+|-------|-------|-------------|
+| Discovery | Analyst | Scans code, estimates complexity, identifies risks |
+| Planning | Planner | Creates a spec + stories with acceptance criteria |
+| Implementation | Dev | Implements each story with tests |
+| Validation | QA | Reviews code vs criteria, loops with Dev on failure |
+
+Artifacts generated in `.aiden/features/<slug>/`: brief.md, spec.md, stories/, review.md, change-summary.md.
+
+### 5. Verify
+
+```bash
+$ aiden status                        # View all features
+$ aiden metrics                       # Tokens, costs, durations
+$ cat .aiden/memory/decisions.jsonl   # AI decision history
+```
+
+---
+
+## 3 adaptive modes
+
+| Mode | Usage | Agents | Estimated time |
+|------|-------|--------|---------------|
+| `aiden flash` | Bug fix, hotfix, small feature | Lead + Dev | < 30 min |
+| `aiden standard` | Medium feature, new API | + Analyst, Planner, QA | 2h - 1 day |
+| `aiden enterprise` | Critical project, compliance required | + DocOps + human approval | 1 day+ |
+
+AIDEN automatically detects the optimal mode. You can switch modes mid-workflow without losing work:
+
+```bash
+$ aiden switch export-csv standard    # switch from flash to standard mid-feature
+```
+
+---
+
+## Intelligent multi-provider
+
+Each agent receives the optimal provider for its task:
+
+| Task | Default provider | Reason |
+|------|-----------------|--------|
+| Analysis & Review | Claude Code | Best reasoning |
+| Code generation | Gemini | Performant multi-file |
+| Quick fix | Copilot | Speed + fixed cost |
+
+4 routing strategies: `fixed`, `prefer`, `auto`, `cost-optimized`. Automatic fallback if a provider is unavailable.
+
+---
+
+## For teams
+
+### Enterprise rules
+
+Define your standards in `.aiden/rules/` (coding standards, security, architecture). They are automatically injected into every agent's prompts.
+
+```bash
+$ aiden rules add security-policy.md
+```
+
+### Skills (extensibility)
+
+Skills are declarative packages (YAML + Markdown) that bundle instructions, rules and hooks. Drop a folder in `.aiden/skills/` and AIDEN discovers it automatically.
+
+```bash
+$ aiden skills init my-skill           # Create a skill
+$ aiden skills list                    # List skills
+$ aiden skills enable/disable <name>   # Enable/disable
+```
+
+3 built-in templates: `code-review-strict`, `compliance-rgpd`, `jira-sync`.
+
+### Multi-level configuration
+
+5 configuration levels that cascade:
+
+```
+AIDEN defaults → Global config (~/.aiden/) → Project config (.aiden/) → Feature config → CLI flags
+```
+
+Global config is installed once per workstation and applies to all projects.
+
+### Compliance and audit
+
+- **decisions.jsonl**: every AI decision is traced (who, what, why, token count)
+- **metrics.jsonl**: cost per agent, per provider, per feature
+- **Human approval** in enterprise mode between each phase
+- **DocOps** generates changelog, documentation, runbooks
+
+---
+
+## Commands
+
+```
+aiden init                          # Initialize AIDEN in the project
+aiden flash "description"           # Fast mode (direct Dev)
+aiden standard "description"        # Standard mode (Analyst → Planner → Dev → QA)
+aiden enterprise "description"      # Enterprise mode (+ DocOps + approval)
+aiden status [feature]              # Feature status
+aiden resume <feature>              # Resume a blocked feature
+aiden abort <feature>               # Abort a feature
+aiden switch <feature> <mode>       # Switch mode mid-feature
+aiden agent <name> "prompt"         # Invoke an agent directly
+aiden provider status|switch|cost   # Manage AI providers
+aiden metrics [--export csv]        # Usage metrics and costs
+aiden config show|set               # Configuration
+aiden rules add|list|remove         # Enterprise rules
+aiden skills list|init|add|remove   # Extensibility skills
+aiden retex add|list|search|remove  # Lessons learned
+aiden template customize|list       # Artifact templates
+```
+
+## Claude Code mode (slash commands)
+
+AIDEN also works directly inside Claude Code without installing the CLI:
+
+```
+/aiden-init        /aiden-flash       /aiden-standard    /aiden-enterprise
+/aiden-status      /aiden-resume      /aiden-agent       /aiden-rules
+```
+
+Both modes (CLI and slash) write to the same `.aiden/` files.
+
+---
+
+## Documentation
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](docs-site/src/app/getting-started/installation) | Prerequisites, installation, provider setup |
+| [Quickstart](docs-site/src/app/getting-started/quickstart) | Complete scenario from zero in 5 minutes |
+| [First feature](docs-site/src/app/getting-started/first-feature) | Detailed standard workflow phase by phase |
+| [Deployment guide](docs/DEPLOIEMENT.md) | Deploy AIDEN in an organization (pilot, rollout, governance) |
+| [Modes](docs-site/src/app/guides/modes) | Flash, standard, enterprise: when to use what |
+| [Rules & templates](docs-site/src/app/guides/rules-and-templates) | Configure enterprise standards |
+| [Skills](docs-site/src/app/guides/skills) | Enterprise extensibility: instruction packages, rules and hooks |
+| [Brownfield](docs-site/src/app/cookbook/brownfield) | Add AIDEN to an existing project |
+| [Team usage](docs-site/src/app/cookbook/team) | Git workflow, onboarding, conventions |
+| [CI/CD](docs-site/src/app/cookbook/ci-cd) | Pipeline integration |
+
+> **Note**: The documentation site is written in French (project language for docs). The code, CLI, and this README are in English.
+
+## Tests
+
+```bash
+$ bun test            # 444 unit tests
+$ bun run typecheck   # TypeScript strict check
+$ bun run lint        # ESLint
+```
+
+## License
+
+AGPL-3.0 — See [LICENSE](LICENSE) for details.
+