0. Dokumentenstruktur (Die drei Schichten dieser FÄHIGKEIT)
- Domänentext (§1 bis §N): Das Protokoll dieser FÄHIGKEIT.
Die Verwendung von 0 gesperrten Vokabeln wird automatisch mit
verify-policy --check body-neutralityüberprüft. - Methodik-Text — domänenneutral: In Cycle 3 der Bereich, der von den Markierungen
<!-- BEGIN: cycle3-body-neutral -->~<!-- END: cycle3-body-neutral -->umschlossen wird. - Domänenbeispiel-Anhang (§A): Beispiele für die MCU/MPU/WPF-Domänen.
Wird automatisch von
scripts/gen-locked-vocab.mjsaus der SoT (policies/locked-vocab.json) generiert.
Bearbeiten Sie den Anhang nicht direkt — er wird mit node scripts/gen-locked-vocab.mjs neu generiert.
Fähigkeit für Anfänger (Starter)
Aktionen
| Aktion | Beschreibung | Beispiel |
|---|---|---|
init | Projektinitialisierung (/init-starter-Funktion) | /starter init my-portfolio |
guide | Entwicklungsleitfaden anzeigen | /starter guide |
help | Hilfe für Anfänger | /starter help |
init (Projektinitialisierung)
- Projektverzeichnisstruktur erstellen (HTML/CSS/JS oder Next.js)
package.jsongenerieren (bei Auswahl von Next.js)CLAUDE.mderstellen (Level: Starter angegeben)docs/-Ordnerstruktur erstellen (für PDCA-Dokumente).rkit/state/memory.jsoninitialisieren
guide (Entwicklungsleitfaden)
- Aktuellen Projektstatus analysieren
- Nächste Schritte vorschlagen, die dem Starter-Level entsprechen
- Pipeline-Leitfaden mit Fokus auf Phase 1–3
help (Hilfe für Anfänger)
- Grundlegende Konzepte von HTML/CSS/JS erklären
- Häufig gestellte Fragen beantworten
- Beispielcode bereitstellen
Zielgruppe
- Personen, die zum ersten Mal programmieren lernen
- Personen, die eine einfache Website erstellen möchten
- Personen, die eine Portfolio-Seite benötigen
Tech-Stack
Option A: Reines HTML/CSS/JS (Für absolute Anfänger)
HTML5 → Webseitenstruktur
CSS3 → Gestaltung
JavaScript → Dynamische Funktionen (optional)
Option B: Next.js (Mit Framework)
Next.js 14+ → React-basiertes Framework
Tailwind CSS → CSS-Dienstprogramme
TypeScript → Typsicherheit (optional)
Sprach-Tier-Anleitung (v1.3.0)
Empfohlen: Nur Tier-1-Sprachen (Python, TypeScript, JavaScript)
Starter-Level konzentriert sich auf KI-native Entwicklung mit maximaler KI-Tool-Unterstützung.
| Tier | Erlaubt | Grund |
|---|---|---|
| Tier 1 | ✅ Ja | Volle KI-Unterstützung, Vibe Coding optimiert |
| Tier 2 | ⚠️ Eingeschränkt | Erwägen Sie stattdessen das Dynamic-Level |
| Tier 3-4 | ❌ Nein | Upgrade auf Dynamic/Enterprise |
Projektstruktur
Option A: HTML/CSS/JS
project/
├── index.html # Hauptseite
├── about.html # Über-Seite
├── css/
│ └── style.css # Styles
├── js/
│ └── main.js # JavaScript
├── images/ # Bilddateien
├── docs/ # PDCA-Dokumente
│ ├── 01-plan/
│ └── 02-design/
└── README.md
Option B: Next.js
project/
├── src/
│ ├── app/
│ │ ├── layout.tsx # Gemeinsames Layout
│ │ ├── page.tsx # Hauptseite
│ │ └── about/
│ │ └── page.tsx # Über-Seite
│ └── components/ # Mehrfach verwendbare Komponenten
├── public/ # Statische Dateien
├── docs/ # PDCA-Dokumente
├── package.json
├── tailwind.config.js
└── README.md
Erklärungen zu Kernkonzepten
HTML (Webseitenstruktur)
<!-- Grundstruktur -->
<!DOCTYPE html>
<html lang="de">
<head>
<meta charset="UTF-8">
<title>Meine Website</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>Kopfzeile</header>
<main>Hauptinhalt</main>
<footer>Fußzeile</footer>
</body>
</html>
CSS (Webseiten gestalten)
/* Grundlegende Styles */
body {
font-family: 'Inter', sans-serif;
margin: 0;
padding: 0;
}
/* Zentrierte Ausrichtung */
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* Responsiv (mobile Unterstützung) */
@media (max-width: 768px) {
.container {
padding: 10px;
}
}
Next.js App Router (Seiten erstellen)
// app/page.tsx - Hauptseite
export default function Home() {
return (
<main className="container mx-auto p-4">
<h1 className="text-3xl font-bold">
Willkommen!
</h1>
</main>
);
}
// app/about/page.tsx - Über-Seite
// URL: /about
export default function About() {
return (
<div className="container mx-auto p-4">
<h1>Über mich</h1>
<p>Ich bin ...</p>
</div>
);
}
Tailwind CSS (Schnelle Gestaltung)
// Häufig verwendete Klassen
<div className="
container // Zentrierte Ausrichtung
mx-auto // Automatischer linker/rechter Rand
p-4 // Padding 16px
text-center // Text zentrieren
text-xl // Großer Text
font-bold // Fetter Text
bg-blue-500 // Blauer Hintergrund
text-white // Weißer Text
rounded-lg // Abgerundete Ecken
hover:bg-blue-600 // Farbwechsel beim Überfahren
">
Bereitstellungsmethoden
GitHub Pages (Kostenlos)
1. GitHub-Repository erstellen
2. Code pushen
3. Einstellungen → Pages → Quelle: main-Branch
4. Zugriff unter https://benutzername.github.io/repo-name
Vercel (Empfohlen für Next.js)
1. Bei vercel.com anmelden (GitHub-Integration)
2. "New Project" → Repository auswählen
3. Auf "Deploy" klicken
4. URL wird automatisch generiert
Einschränkungen
❌ Anmeldung/Registrierung (erfordert Server)
❌ Datenspeicherung (erfordert Datenbank)
❌ Admin-Seiten (erfordert Backend)
❌ Zahlungsfunktionen (erfordert Backend)
Wann ein Upgrade sinnvoll ist
Wechseln Sie zum Dynamic-Level, wenn Sie Folgendes benötigen:
→ „Ich brauche eine Anmeldefunktion“
→ „Ich möchte Daten speichern“
→ „Ich brauche eine Admin-Seite“
→ „Ich möchte, dass Benutzer miteinander kommunizieren“
rkit-Funktionen für Starter-Level (v1.5.1)
Ausgabestil: rkit-learning (Empfohlen)
Für das beste Lernerlebnis aktivieren Sie den Lernausgabestil:
/output-style rkit-learning
Dies bietet:
- Lernpunkte nach jeder Aufgabe, die erklären, was Sie getan haben und warum
- TODO(learner)-Markierungen, die zur praktischen Übung anregen
- Konzepterklärungen, die für das Anfängerniveau angepasst sind
Agent Memory (Automatisch aktiv)
rkit-Agenten merken sich Ihren Lernfortschritt über verschiedene Sitzungen hinweg.
Keine Einrichtung erforderlich — Ihr starter-guide-Agent verwendet den user-Speicherbereich,
sodass der Lernkontext auch über verschiedene Projekte hinweg erhalten bleibt.
Agent Teams
Agent Teams sind für Projekte auf Starter-Level nicht verfügbar. Wenn Sie zum Dynamic-Level upgraden, erhalten Sie den parallelen PDCA-Modus mit 2 Teammitgliedern.
Häufige Fehler
| Fehler | Lösung |
|---|---|
| Bild wird nicht angezeigt | Pfad überprüfen (./images/foto.jpg) |
| CSS wird nicht angewendet | Link-Tag-Pfad überprüfen |
| Seitennavigation funktioniert nicht | href-Pfad überprüfen (./about.html) |
| Probleme auf mobilen Geräten | <meta name="viewport">-Tag überprüfen |