Communitygithub.com

solitasroh/rkit

Habilidade de desenvolvimento web estático para iniciantes e não desenvolvedores. Cobre HTML/CSS/JavaScript e conceitos básicos do Next.js App Router.

O que é rkit?

O rkit é uma habilidade especializada para agentes de IA (como Claude Code, Cursor, Codex) projetada para orientar iniciantes e não desenvolvedores na criação de sites estáticos simples. Ela oferece três ações principais: `init` (inicialização do projeto com estrutura de pastas e arquivos), `guide` (exibição de um guia de desenvolvimento adequado ao nível iniciante) e `help` (explicação de conceitos básicos de HTML/CSS/JS). A habilidade suporta duas opções de stack tecnológica: HTML/CSS/JS puro (para iniciantes completos) ou Next.js com Tailwind CSS (para quem deseja usar um framework). Entre suas funcionalidades estão a geração automática de arquivos de projeto, documentação PDCA, e um sistema de memória do agente que persiste o progresso de aprendizado entre sessões. O rkit é acionado por palavras-chave como 'site estático', 'portfólio', 'landing page', 'iniciante', 'primeiro site' e não deve ser usado para aplicações fullstack que exijam backend, autenticação ou banco de dados. Inclui também modos de saída como `rkit-learning`, que fornece pontos de aprendizado e marcadores TODO(learner) para incentivar a prática.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/solitasroh/rkit/tree/HEAD/skills/starter

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

0. Estrutura do Documento (As Três Camadas desta HABILIDADE)

  1. 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).
  2. Corpo Metodológico — Neutro ao Domínio: Área delimitada pelos marcadores <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> no Ciclo 3.
  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.mjs a 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çãoDescriçãoExemplo
initInicialização do projeto (funcionalidade /init-starter)/starter init my-portfolio
guideExibe o guia de desenvolvimento/starter guide
helpAjuda para iniciantes/starter help

init (Inicialização do Projeto)

  1. Criar a estrutura de diretórios do projeto (HTML/CSS/JS ou Next.js)
  2. Gerar package.json (quando Next.js for selecionado)
  3. Criar CLAUDE.md (Nível: Starter especificado)
  4. Criar a estrutura da pasta docs/ (para documentos PDCA)
  5. 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ívelPermitidoMotivo
Nível 1✅ SimSuporte completo de IA, otimizado para Vibe Coding
Nível 2⚠️ LimitadoConsidere usar o nível Dynamic
Nível 3-4❌ NãoAtualize 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

ErroSolução
Imagem não apareceVerifique o caminho (./images/photo.jpg)
CSS não é aplicadoVerifique o caminho da tag link
Navegação entre páginas não funcionaVerifique o caminho href (./about.html)
Quebra em dispositivos móveisVerifique a tag <meta name="viewport">

Habilidades Relacionadas