0. Estructura del documento (las tres capas de esta HABILIDAD)
- Cuerpo del dominio (§1 ~ §N): Protocolo de esta HABILIDAD.
El uso de vocabulario bloqueado (0 casos) se verifica automáticamente con
verify-policy --check body-neutrality. - Cuerpo metodológico — neutro respecto al dominio: Área delimitada por los marcadores
<!-- BEGIN: cycle3-body-neutral -->~<!-- END: cycle3-body-neutral -->en el Ciclo 3. - Apéndice de ejemplos del dominio (§A): Casos específicos para los dominios MCU/MPU/WPF.
El archivo SoT (
policies/locked-vocab.json) lo genera automáticamentescripts/gen-locked-vocab.mjs.
No edite el apéndice directamente — regenérelo con node scripts/gen-locked-vocab.mjs.
Habilidad para principiantes (Starter)
Acciones
| Acción | Descripción | Ejemplo |
|---|---|---|
init | Inicialización del proyecto (función /init-starter) | /starter init my-portfolio |
guide | Muestra la guía de desarrollo | /starter guide |
help | Ayuda para principiantes | /starter help |
init (Inicialización del proyecto)
- Crear la estructura de directorios del proyecto (HTML/CSS/JS o Next.js)
- Generar package.json (cuando se selecciona Next.js)
- Crear CLAUDE.md (nivel Starter especificado)
- Crear la estructura de carpetas docs/ (para documentos PDCA)
- Inicializar .rkit/state/memory.json
guide (Guía de desarrollo)
- Analizar el estado actual del proyecto
- Sugerir los siguientes pasos apropiados para el nivel Starter
- Guía de Pipeline centrada en las fases 1-3
help (Ayuda para principiantes)
- Explicar conceptos básicos de HTML/CSS/JS
- Responder preguntas frecuentes
- Proporcionar código de ejemplo
Público objetivo
- Personas que aprenden programación por primera vez
- Personas que quieren crear un sitio web simple
- Personas que necesitan un sitio de portafolio
Stack técnico
Opción A: HTML/CSS/JS puro (para principiantes absolutos)
HTML5 → Estructura de la página web
CSS3 → Estilos
JavaScript → Funcionalidades dinámicas (opcional)
Opción B: Next.js (usando framework)
Next.js 14+ → Framework basado en React
Tailwind CSS → CSS de utilidad
TypeScript → Seguridad de tipos (opcional)
Guía de niveles de lenguaje (v1.3.0)
Recomendado: Solo lenguajes del Nivel 1 (Python, TypeScript, JavaScript)
El nivel Starter se centra en el desarrollo nativo de IA con el máximo soporte de herramientas de IA.
| Nivel | Permitido | Razón |
|---|---|---|
| Nivel 1 | ✅ Sí | Soporte completo de IA, optimizado para Vibe Coding |
| Nivel 2 | ⚠️ Limitado | Considere mejor el nivel Dynamic |
| Nivel 3-4 | ❌ No | Actualice a Dynamic/Enterprise |
Estructura del proyecto
Opción A: HTML/CSS/JS
proyecto/
├── index.html # Página principal
├── about.html # Página "Acerca de"
├── css/
│ └── style.css # Estilos
├── js/
│ └── main.js # JavaScript
├── images/ # Archivos de imagen
├── docs/ # Documentos PDCA
│ ├── 01-plan/
│ └── 02-design/
└── README.md
Opción B: Next.js
proyecto/
├── src/
│ ├── app/
│ │ ├── layout.tsx # Diseño común
│ │ ├── page.tsx # Página principal
│ │ └── about/
│ │ └── page.tsx # Página "Acerca de"
│ └── components/ # Componentes reutilizables
├── public/ # Archivos estáticos
├── docs/ # Documentos PDCA
├── package.json
├── tailwind.config.js
└── README.md
Explicaciones de conceptos básicos
HTML (estructura de la página web)
<!-- Estructura básica -->
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="UTF-8">
<title>Mi sitio web</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>Encabezado</header>
<main>Contenido principal</main>
<footer>Pie de página</footer>
</body>
</html>
CSS (estilo de las páginas web)
/* Estilos básicos */
body {
font-family: 'Inter', sans-serif;
margin: 0;
padding: 0;
}
/* Alineación centrada */
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* Adaptable (soporte móvil) */
@media (max-width: 768px) {
.container {
padding: 10px;
}
}
Next.js App Router (creación de páginas)
// app/page.tsx - Página principal
export default function Home() {
return (
<main className="container mx-auto p-4">
<h1 className="text-3xl font-bold">
¡Bienvenido!
</h1>
</main>
);
}
// app/about/page.tsx - Página "Acerca de"
// URL: /about
export default function About() {
return (
<div className="container mx-auto p-4">
<h1>Acerca de</h1>
<p>Soy ...</p>
</div>
);
}
Tailwind CSS (estilizado rápido)
// Clases de uso frecuente
<div className="
container // Alineación centrada
mx-auto // Margen izquierdo/derecho automático
p-4 // Relleno de 16px
text-center // Texto centrado
text-xl // Texto grande
font-bold // Texto en negrita
bg-blue-500 // Fondo azul
text-white // Texto blanco
rounded-lg // Esquinas redondeadas
hover:bg-blue-600 // Cambio de color al pasar el ratón
">
Métodos de despliegue
GitHub Pages (gratuito)
1. Crear un repositorio en GitHub
2. Subir el código
3. Ajustes → Pages → Origen: rama main
4. Acceder en https://username.github.io/nombre-repositorio
Vercel (recomendado para Next.js)
1. Registrarse en vercel.com (integración con GitHub)
2. "New Project" → Seleccionar repositorio
3. Hacer clic en "Deploy"
4. La URL se genera automáticamente
Limitaciones
❌ Inicio de sesión/registro (requiere servidor)
❌ Almacenamiento de datos (requiere base de datos)
❌ Páginas de administración (requiere backend)
❌ Funciones de pago (requiere backend)
Cuándo actualizar
Pase al nivel Dynamic si necesita:
→ "Necesito funcionalidad de inicio de sesión"
→ "Quiero almacenar datos"
→ "Necesito una página de administración"
→ "Quiero que los usuarios se comuniquen entre sí"
Funciones de rkit para el nivel Starter (v1.5.1)
Estilo de salida: rkit-learning (recomendado)
Para la mejor experiencia de aprendizaje, active el estilo de salida de aprendizaje:
/output-style rkit-learning
Esto proporciona:
- Puntos de aprendizaje después de cada tarea, explicando lo que hizo y por qué
- Marcadores TODO(learner) que fomentan la práctica práctica
- Explicaciones de conceptos adaptadas a la dificultad de principiantes
Memoria del agente (activada automáticamente)
Los agentes de rkit recuerdan automáticamente su progreso de aprendizaje entre sesiones.
No necesita configuración — su agente starter-guide usa memoria de ámbito user,
por lo que el contexto de aprendizaje persiste incluso entre diferentes proyectos.
Equipos de agentes
Los equipos de agentes no están disponibles para proyectos de nivel Starter. Cuando actualice al nivel Dynamic, desbloqueará el modo PDCA paralelo con 2 compañeros de equipo.
Errores comunes
| Error | Solución |
|---|---|
| La imagen no se muestra | Verifique la ruta (./images/photo.jpg) |
| El CSS no se aplica | Verifique la ruta de la etiqueta link |
| La navegación entre páginas no funciona | Verifique la ruta href (./about.html) |
| Se ve mal en móvil | Verifique la etiqueta <meta name="viewport"> |