0. Estrutura do Documento (As Três Camadas desta HABILIDADE)
- Corpo do Domínio (§1 ~ §N): O protocolo desta HABILIDADE.
O uso de vocabulário bloqueado é verificado automaticamente com
verify-policy --check body-neutrality(0 ocorrências). - Corpo Metodológico — Neutro ao Domínio: Área delimitada pelos marcadores
<!-- BEGIN: cycle3-body-neutral -->~<!-- END: cycle3-body-neutral -->no Ciclo 3. - Apêndice de Exemplos por Domínio (§A): Casos específicos dos domínios MCU/MPU/WPF.
Gerado automaticamente por
scripts/gen-locked-vocab.mjsa partir da SoT (policies/locked-vocab.json).
Não edite o apêndice diretamente — recrie-o executando node scripts/gen-locked-vocab.mjs.
Habilidade Iniciante (Starter)
Ações
| Ação | Descrição | Exemplo |
|---|---|---|
init | Inicialização do projeto (funcionalidade /init-starter) | /starter init my-portfolio |
guide | Exibe o guia de desenvolvimento | /starter guide |
help | Ajuda para iniciantes | /starter help |
init (Inicialização do Projeto)
- Criar a estrutura de diretórios do projeto (HTML/CSS/JS ou Next.js)
- Gerar package.json (quando Next.js for selecionado)
- Criar CLAUDE.md (Nível: Starter especificado)
- Criar a estrutura da pasta docs/ (para documentos PDCA)
- Inicializar .rkit/state/memory.json
guide (Guia de Desenvolvimento)
- Analisar o estado atual do projeto
- Sugerir próximos passos adequados ao nível Starter
- Guia do Pipeline focado nas Fases 1 a 3
help (Ajuda para Iniciantes)
- Explicar conceitos básicos de HTML/CSS/JS
- Responder perguntas frequentes
- Fornecer exemplos de código
Público-Alvo
- Pessoas aprendendo programação pela primeira vez
- Pessoas que desejam criar um site simples
- Pessoas que precisam de um site portfólio
Stack Tecnológica
Opção A: HTML/CSS/JS Puro (Para Iniciantes Completos)
HTML5 → Estrutura da página web
CSS3 → Estilização
JavaScript → Funcionalidades dinâmicas (opcional)
Opção B: Next.js (Usando Framework)
Next.js 14+ → Framework baseado em React
Tailwind CSS → CSS utilitário
TypeScript → Segurança de tipos (opcional)
Orientação de Nível de Linguagem (v1.3.0)
Recomendado: Apenas linguagens do Nível 1 (Python, TypeScript, JavaScript)
O nível Starter foca no desenvolvimento nativo de IA com o máximo suporte de ferramentas de IA.
| Nível | Permitido | Motivo |
|---|---|---|
| Nível 1 | ✅ Sim | Suporte completo de IA, otimizado para Vibe Coding |
| Nível 2 | ⚠️ Limitado | Considere usar o nível Dynamic |
| Nível 3-4 | ❌ Não | Atualize para Dynamic/Enterprise |
Estrutura do Projeto
Opção A: HTML/CSS/JS
projeto/
├── index.html # Página principal
├── about.html # Página Sobre
├── css/
│ └── style.css # Estilos
├── js/
│ └── main.js # JavaScript
├── images/ # Arquivos de imagem
├── docs/ # Documentos PDCA
│ ├── 01-plan/
│ └── 02-design/
└── README.md
Opção B: Next.js
projeto/
├── src/
│ ├── app/
│ │ ├── layout.tsx # Layout comum
│ │ ├── page.tsx # Página principal
│ │ └── about/
│ │ └── page.tsx # Página Sobre
│ └── components/ # Componentes reutilizáveis
├── public/ # Arquivos estáticos
├── docs/ # Documentos PDCA
├── package.json
├── tailwind.config.js
└── README.md
Explicações de Conceitos Principais
HTML (Estrutura da Página Web)
<!-- Estrutura básica -->
<!DOCTYPE html>
<html lang="pt">
<head>
<meta charset="UTF-8">
<title>Meu Site</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<header>Cabeçalho</header>
<main>Conteúdo principal</main>
<footer>Rodapé</footer>
</body>
</html>
CSS (Estilização de Páginas Web)
/* Estilos básicos */
body {
font-family: 'Inter', sans-serif;
margin: 0;
padding: 0;
}
/* Alinhamento central */
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
/* Responsivo (suporte a dispositivos móveis) */
@media (max-width: 768px) {
.container {
padding: 10px;
}
}
Next.js App Router (Criando 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">
Bem-vindo!
</h1>
</main>
);
}
// app/about/page.tsx - Página Sobre
// URL: /about
export default function About() {
return (
<div className="container mx-auto p-4">
<h1>Sobre</h1>
<p>Eu sou ...</p>
</div>
);
}
Tailwind CSS (Estilização Rápida)
// Classes frequentemente usadas
<div className="
container // Alinhamento central
mx-auto // Margem automática esquerda/direita
p-4 // Preenchimento 16px
text-center // Texto centralizado
text-xl // Texto grande
font-bold // Texto em negrito
bg-blue-500 // Fundo azul
text-white // Texto branco
rounded-lg // Cantos arredondados
hover:bg-blue-600 // Mudança de cor ao passar o mouse
">
Métodos de Implantação
GitHub Pages (Gratuito)
1. Criar um repositório no GitHub
2. Enviar o código
3. Configurações → Pages → Origem: branch main
4. Acessar em https://seuusuario.github.io/nome-do-repositorio
Vercel (Recomendado para Next.js)
1. Cadastre-se em vercel.com (integração com GitHub)
2. "New Project" → Selecione o repositório
3. Clique em "Deploy"
4. URL gerada automaticamente
Limitações
❌ Login/Registro (requer servidor)
❌ Armazenamento de dados (requer banco de dados)
❌ Páginas administrativas (requer backend)
❌ Funcionalidades de pagamento (requer backend)
Quando Atualizar
Mude para o Nível Dynamic se precisar de:
→ "Preciso de funcionalidade de login"
→ "Quero armazenar dados"
→ "Preciso de uma página administrativa"
→ "Quero que usuários se comuniquem entre si"
Funcionalidades do rkit para o Nível Starter (v1.5.1)
Estilo de Saída: rkit-learning (Recomendado)
Para a melhor experiência de aprendizado, ative o estilo de saída de aprendizado:
/output-style rkit-learning
Isso fornece:
- Pontos de aprendizado após cada tarefa, explicando o que foi feito e por quê
- Marcadores TODO(learner) incentivando a prática hands-on
- Explicações de conceitos ajustadas para a dificuldade de iniciantes
Memória do Agente (Ativa Automaticamente)
Os agentes rkit lembram automaticamente seu progresso de aprendizado entre sessões.
Nenhuma configuração necessária — seu agente starter-guide usa memória de escopo user,
portanto o contexto de aprendizado persiste mesmo entre projetos diferentes.
Equipes de Agentes
Equipes de Agentes não estão disponíveis para projetos no nível Starter. Ao atualizar para o nível Dynamic, você desbloqueia o modo PDCA paralelo com 2 colegas de equipe.
Erros Comuns
| Erro | Solução |
|---|---|
| Imagem não aparece | Verifique o caminho (./images/photo.jpg) |
| CSS não é aplicado | Verifique o caminho da tag link |
| Navegação entre páginas não funciona | Verifique o caminho href (./about.html) |
| Quebra em dispositivos móveis | Verifique a tag <meta name="viewport"> |