## Installation de SmartStack CLI SmartStack CLI Installation

Suivez cette checklist interactive pour installer SmartStack CLI et configurer votre environnement de developpement. Votre progression est automatiquement sauvegardee.

Follow this interactive checklist to install SmartStack CLI and configure your development environment. Your progress is automatically saved.

Progression Progress 0/7

### Configuration Configuration

Selectionnez votre environnement pour afficher les commandes adaptees :

Select your environment to display adapted commands:

Systeme d'exploitation Operating System
Plateforme Git Git Platform

### Checklist d'installation Installation Checklist

- 1
  Installer Node.js Install Node.js

  Telechargez et installez Node.js (version 18 ou superieure recommandee).

  Download and install Node.js (version 18 or higher recommended).

      node --version  # Verifier l'installation

  https://nodejs.org/

- 2
  Configurer Git Configure Git

  Configurez Git avec SSH pour GitHub. Ajoutez votre cle SSH dans les parametres GitHub.

  Configure Git with SSH for GitHub. Add your SSH key in GitHub settings.

      # Generer une cle SSH (PowerShell)
      ssh-keygen -t ed25519 -C "your_email@example.com"

      # Demarrer le service SSH Agent
      Get-Service ssh-agent | Set-Service -StartupType Automatic
      Start-Service ssh-agent
      ssh-add $env:USERPROFILE\.ssh\id_ed25519

      # Afficher la cle publique a copier
      Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub

      # Generer une cle SSH
      ssh-keygen -t ed25519 -C "your_email@example.com"

      # Ajouter au Keychain
      ssh-add --apple-use-keychain ~/.ssh/id_ed25519

      # Afficher la cle publique a copier
      cat ~/.ssh/id_ed25519.pub | pbcopy  # Copie directement

      # Generer une cle SSH
      ssh-keygen -t ed25519 -C "your_email@example.com"

      # Demarrer l'agent SSH
      eval "$(ssh-agent -s)"
      ssh-add ~/.ssh/id_ed25519

      # Afficher la cle publique a copier
      cat ~/.ssh/id_ed25519.pub

  Ajoutez votre cle SSH ici : https://github.com/settings/keys

  Add your SSH key here: https://github.com/settings/keys

  Configurez Git avec HTTPS et Git Credential Manager pour Azure DevOps.

  Configure Git with HTTPS and Git Credential Manager for Azure DevOps.

      # Git Credential Manager est inclus avec Git for Windows
      # Verifiez qu'il est configure :
      git config --global credential.helper manager

  Git Credential Manager est installe automatiquement avec Git for Windows.

  Git Credential Manager is installed automatically with Git for Windows.

      # Installer Git Credential Manager via Homebrew
      brew install --cask git-credential-manager

      # Configurer le credential helper
      git config --global credential.helper manager

      # Installer Git Credential Manager
      # Telechargez le .deb depuis: https://github.com/git-ecosystem/git-credential-manager/releases
      sudo dpkg -i gcm-linux_amd64.deb

      # Configurer le credential helper
      git config --global credential.helper manager

  Git Credential Manager gerera automatiquement l'authentification via le navigateur lors du clone avec `/gitflow:10-start`.

  Git Credential Manager will automatically handle authentication via browser when cloning with `/gitflow:10-start`.

- 3
  Installer Claude Code CLI Install Claude Code CLI

  Installez Claude Code CLI globalement avec npm.

  Install Claude Code CLI globally with npm.

      npm install -g @anthropic-ai/claude-code

- 4
  Installer SmartStack CLI Install SmartStack CLI

  Installez SmartStack CLI globalement avec npm.

  Install SmartStack CLI globally with npm.

      npm install -g @atlashub/smartstack-cli

  Verifiez l'installation :

  Verify installation:

      smartstack --version

- 5
  Installer SmartStack MCP Server Install SmartStack MCP Server

  Installez le serveur MCP SmartStack pour la validation des conventions et le scaffolding.

  Install the SmartStack MCP server for conventions validation and scaffolding.

      # Etape 1: Installer le package globalement
      npm install -g @atlashub/smartstack-mcp

      # Etape 2: Enregistrer le serveur MCP dans Claude
      claude mcp add smartstack -- npx @atlashub/smartstack-mcp

- 6
  Installer Context7 MCP Server Install Context7 MCP Server

  Installez le serveur MCP Context7 pour acceder a la documentation des bibliotheques.

  Install the Context7 MCP server to access library documentation.

  Cle API Context7 (optionnel - ameliore les performances) Context7 API Key (optional - improves performance)
  Obtenez une cle API sur context7.com Get an API key at context7.com

      # Sans cle API
      claude mcp add context7 -- npx @upstash/context7-mcp

- 7
  Verifier l'installation Verify Installation

  Verifiez que tout est correctement installe.

  Verify that everything is correctly installed.

      # Verifier les versions
      node --version
      claude --version
      smartstack --version

      # Verifier les serveurs MCP
      claude mcp list

  ✅

  Felicitations ! Vous pouvez maintenant :

  Congratulations! You can now:

  - Creer un nouveau projet : `smartstack init MyProject`
  - Create a new project: `smartstack init MyProject`
  - Ou initialiser sur un projet existant : `smartstack init .`
  - Or initialize on an existing project: `smartstack init .`

### Demarrer votre premier projet Start your first project

💡

Felicitations ! L'installation est terminee. Voici comment demarrer votre premier projet SmartStack.

Congratulations! Installation is complete. Here's how to start your first SmartStack project.

#### A Creer le repository Git Create the Git repository

Avant d'initialiser SmartStack, vous devez creer un repository sur votre plateforme Git.

Before initializing SmartStack, you need to create a repository on your Git platform.

1. Allez sur github.com/new
2. Go to github.com/new
3. Nommez votre repository (ex: `MonProjet`)
4. Name your repository (e.g., `MyProject`)
5. Laissez-le vide (pas de README, .gitignore, ou license)
6. Leave it empty (no README, .gitignore, or license)
7. Cliquez sur "Create repository"
8. Click "Create repository"

1. Allez dans votre projet Azure DevOps
2. Go to your Azure DevOps project
3. Repos > "New repository"
4. Repos > "New repository"
5. Nommez votre repository (ex: `MonProjet`)
6. Name your repository (e.g., `MyProject`)
7. Decochez "Add a README"
8. Uncheck "Add a README"
9. Cliquez sur "Create"
10. Click "Create"

Pourquoi un repo vide ? SmartStack va initialiser la structure du projet avec les bons fichiers. Un repo pre-rempli pourrait creer des conflits.

Why an empty repo? SmartStack will initialize the project structure with the correct files. A pre-filled repo could create conflicts.

#### B Initialiser GitFlow Initialize GitFlow

Ouvrez Claude Code dans un dossier vide et lancez l'initialisation GitFlow :

Open Claude Code in an empty folder and launch GitFlow initialization:

    # Dans Claude Code, tapez :
    /gitflow:1-init

L'assistant vous guidera pour :

The assistant will guide you to:

- Cloner votre repository
- Clone your repository
- Configurer les branches (main, develop)
- Configure branches (main, develop)
- Definir les conventions de versioning
- Define versioning conventions

Conseil : Repondez aux questions de l'assistant. Il adaptera la configuration a vos besoins.

Tip: Answer the assistant's questions. It will adapt the configuration to your needs.

#### C Initialiser SmartStack Initialize SmartStack

Une fois GitFlow configure, initialisez la structure du projet SmartStack :

Once GitFlow is configured, initialize the SmartStack project structure:

    # Pour un nouveau projet .NET (cree la structure Clean Architecture)
    smartstack init MonProjet

    # OU pour un projet existant (ajoute seulement les outils SmartStack)
    smartstack init .

Cette commande va :

This command will:

- Creer la structure Clean Architecture (.NET)
- Create the Clean Architecture structure (.NET)
- Installer les skills et agents SmartStack
- Install SmartStack skills and agents
- Configurer les hooks Claude Code
- Configure Claude Code hooks
- Verifier les serveurs MCP
- Verify MCP servers

#### D Commencer a travailler Start working

Votre environnement est pret ! Pour commencer une nouvelle fonctionnalite :

Your environment is ready! To start a new feature:

    # Creer une branche feature
    /gitflow:10-start feature ma-fonctionnalite

    # Commiter vos changements
    /gitflow:3-commit

    # Finaliser la feature
    /gitflow:11-finish

#### Documentation complementaire Additional documentation

🚀 Commande Init Init Command 🔀 Guide GitFlow GitFlow Guide 🗄 Migrations EF Core EF Core Migrations 🎯 Methodologie APEX APEX Methodology