0. Structure du document (les trois couches de cette COMPÉTENCE)
- Corps du domaine (§1 ~ §N) : protocole de cette COMPÉTENCE.
L'utilisation de vocabulaire verrouillé (0 occurrence) est vérifiée automatiquement par
verify-policy --check body-neutrality. - Corps méthodologique — neutre par domaine : zone délimitée par
<!-- BEGIN: cycle3-body-neutral -->~<!-- END: cycle3-body-neutral -->dans le Cycle 3. - Annexe d'exemples par domaine (§A) : cas par domaine MCU/MPU/WPF.
Générée automatiquement par
scripts/gen-locked-vocab.mjsà partir de la SoT (policies/locked-vocab.json).
Ne modifiez pas l'annexe directement — régénérez-la avec node scripts/gen-locked-vocab.mjs.
Compétence Débutant (Starter)
Actions
| Action | Description | Exemple |
|---|---|---|
init | Initialisation du projet (fonctionnalité /init-starter) | /starter init mon-portfolio |
guide | Afficher le guide de développement | /starter guide |
help | Aide pour débutants | /starter help |
init (Initialisation du projet)
- Créer la structure de répertoires du projet (HTML/CSS/JS ou Next.js)
- Générer le fichier package.json (lorsque Next.js est sélectionné)
- Créer CLAUDE.md (Niveau : Starter spécifié)
- Créer la structure du dossier docs/ (pour les documents PDCA)
- Initialiser .rkit/state/memory.json
guide (Guide de développement)
- Analyser l'état actuel du projet
- Suggérer les prochaines étapes adaptées au niveau Starter
- Guide Pipeline axé sur les phases 1 à 3
help (Aide pour débutants)
- Expliquer les concepts de base de HTML/CSS/JS
- Répondre aux questions fréquentes
- Fournir des exemples de code
Public cible
- Personnes apprenant la programmation pour la première fois
- Personnes souhaitant créer un site web simple
- Personnes ayant besoin d'un site portfolio
Pile technique
Option A : HTML/CSS/JS pur (pour les vrais débutants)
HTML5 → Structure de la page web
CSS3 → Mise en forme
JavaScript → Fonctionnalités dynamiques (optionnel)
Option B : Next.js (avec framework)
Next.js 14+ → Framework basé sur React
Tailwind CSS → CSS utilitaire
TypeScript → Sécurité des types (optionnel)
Guide des niveaux de langage (v1.3.0)
Recommandé : uniquement les langages de niveau 1 (Python, TypeScript, JavaScript)
Le niveau Starter se concentre sur le développement natif IA avec un support maximal des outils d'IA.
| Niveau | Autorisé | Raison |
|---|---|---|
| Niveau 1 | ✅ Oui | Support IA complet, optimisé Vibe Coding |
| Niveau 2 | ⚠️ Limité | Envisagez plutôt le niveau Dynamic |
| Niveau 3-4 | ❌ Non | Passez au niveau Dynamic/Enterprise |
Structure du projet
Option A : HTML/CSS/JS
project/
├── index.html # Page principale
├── about.html # Page À propos
├── css/
│ └── style.css # Styles
├── js/
│ └── main.js # JavaScript
├── images/ # Fichiers images
├── docs/ # Documents PDCA
│ ├── 01-plan/
│ └── 02-design/
└── README.md
Option B : Next.js
project/
├── src/
│ ├── app/
│ │ ├── layout.tsx # Mise en page commune
│ │ ├── page.tsx # Page principale
│ │ └── about/
│ │ └── page.tsx # Page À propos
│ └── components/ # Composants réutilisables
├── public/ # Fichiers statiques
├── docs/ # Documents PDCA
├── package.json
├── tailwind.config.js
└── README.md
Explications des concepts fondamentaux
HTML (Structure de la page web)
<!-- Structure de base -->
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<title>Mon Site Web</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>En-tête</header>
<main>Contenu principal</main>
<footer>Pied de page</footer>
</body>
</html>
CSS (Mise en forme des pages web)
/* Styles de base */
body {
font-family: 'Inter', sans-serif;
margin: 0;
padding: 0;
}
/* Centrage */
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* Responsive (support mobile) */
@media (max-width: 768px) {
.container {
padding: 10px;
}
}
Next.js App Router (Création de pages)
// app/page.tsx - Page principale
export default function Home() {
return (
<main className="container mx-auto p-4">
<h1 className="text-3xl font-bold">
Bienvenue !
</h1>
</main>
);
}
// app/about/page.tsx - Page À propos
// URL : /about
export default function About() {
return (
<div className="container mx-auto p-4">
<h1>À propos</h1>
<p>Je suis ...</p>
</div>
);
}
Tailwind CSS (Mise en forme rapide)
// Classes fréquemment utilisées
<div className="
container // Centrage
mx-auto // Marges gauche/droite automatiques
p-4 // Padding 16px
text-center // Texte centré
text-xl // Texte grand
font-bold // Texte en gras
bg-blue-500 // Fond bleu
text-white // Texte blanc
rounded-lg // Coins arrondis
hover:bg-blue-600 // Changement de couleur au survol
">
Méthodes de déploiement
GitHub Pages (Gratuit)
1. Créer un dépôt GitHub
2. Pousser le code
3. Paramètres → Pages → Source : branche main
4. Accès à https://username.github.io/nom-du-depot
Vercel (Recommandé pour Next.js)
1. S'inscrire sur vercel.com (intégration GitHub)
2. "New Project" → Sélectionner le dépôt
3. Cliquer sur "Deploy"
4. URL générée automatiquement
Limitations
❌ Connexion/Inscription (nécessite un serveur)
❌ Stockage de données (nécessite une base de données)
❌ Pages d'administration (nécessite un backend)
❌ Fonctionnalités de paiement (nécessite un backend)
Quand passer au niveau supérieur
Passez au niveau Dynamic si vous avez besoin :
→ "J'ai besoin d'une fonctionnalité de connexion"
→ "Je veux stocker des données"
→ "J'ai besoin d'une page d'administration"
→ "Je veux que les utilisateurs communiquent entre eux"
Fonctionnalités rkit pour le niveau Starter (v1.5.1)
Style de sortie : rkit-learning (Recommandé)
Pour une meilleure expérience d'apprentissage, activez le style de sortie d'apprentissage :
/output-style rkit-learning
Celui-ci fournit :
- Points d'apprentissage après chaque tâche expliquant ce que vous avez fait et pourquoi
- Marqueurs TODO(apprenant) encourageant la pratique active
- Explications de concepts adaptées au niveau débutant
Mémoire d'agent (Auto-active)
Les agents rkit mémorisent automatiquement votre progression d'apprentissage entre les sessions.
Aucune configuration nécessaire — votre agent starter-guide utilise la mémoire de portée user,
donc le contexte d'apprentissage persiste même entre différents projets.
Équipes d'agents
Les équipes d'agents ne sont pas disponibles pour les projets de niveau Starter. Lorsque vous passez au niveau Dynamic, vous débloquez le mode PDCA parallèle avec 2 coéquipiers.
Erreurs courantes
| Erreur | Solution |
|---|---|
| L'image ne s'affiche pas | Vérifiez le chemin (./images/photo.jpg) |
| Le CSS ne s'applique pas | Vérifiez le chemin de la balise link |
| La navigation entre pages ne fonctionne pas | Vérifiez le chemin href (./about.html) |
| Cassé sur mobile | Vérifiez la balise <meta name="viewport"> |