site-contentlayer-authoring

Este repositório usa contentlayer (via next-contentlayer) para gerar tipos a partir de Markdown em content/.

Objetivo

• •Criar/atualizar conteúdo Markdown sem quebrar o schema do Contentlayer.
• •Manter consistência de frontmatter e URLs computadas.

Quando usar (gatilhos)

• •“Adicione um post no blog”, “crie uma nova página”, “inclua um projeto”.
• •Erros de build do tipo “missing required field” / “Contentlayer build failed”.
• •Ajustes em contentlayer.config.js ou nas pastas content/**.

Exemplos de prompt

• •“Crie um novo post em content/blog com frontmatter correto.”
• •“Estou recebendo erro de frontmatter; encontre o arquivo e corrija.”
• •“Adicione uma experiência e faça aparecer no currículo.”

Inputs (o que pedir ao usuário)

• •Tipo de conteúdo: Post (blog) ou Chapter (capítulos).
• •Path/slug desejado e imagens (se houver).
• •Para mudanças de schema: quais campos novos e se são required.

Princípios e regras

Crítico (não negociar)

• •Respeitar campos required: true definidos em contentlayer.config.js.
• •Não alterar o schema sem ajustar todos os documentos impactados.
• •Manter URLs consistentes com os computedFields (não “inventar” rotas).

Padrões recomendados

• •Preferir datas ISO no frontmatter quando o tipo for date.
• •Manter imagens como paths estáticos (normalmente em public/).

Cheat sheet: frontmatter por tipo

Fonte: contentlayer.config.js.

Post (content/blog/**/*.md)

• •title (string)
• •description (string)
• •date (date)
• •author (string)
• •image (string)

URL computada: /${flattenedPath} (ex.: /blog/meu-post).

Chapter (content/capitulos/**/*.md)

• •title (string)
• •description (string)
• •date (date)
• •sentence (string)
• •order_number (number)
• •sentence_author (string)
• •name (string)
• •status (enum: backlog | progress | review | done)
• •image (string)

Opcionais:

• •parent (string | null; default null)
• •isParent (boolean; default false)

Workflow (faça em ordem)

1. •Identificar tipo e arquivo

• •Confirmar em qual pasta o conteúdo vive.

1. •Criar/editar o Markdown

• •Garantir todos os campos required no frontmatter.
• •Se adicionar imagem, usar path absoluto do site (ex.: /images/...) quando apropriado.

1. •Validar localmente

• •Rodar npm run dev para validação rápida (Contentlayer + Next em watch).
• •Ou rodar npm run build para validação completa.

1. •Ajustar onde o conteúdo aparece (se necessário)

• •Se o conteúdo não renderizar, localizar o contentService/página correspondente e validar filtros (ex.: show, pin).

Saída esperada

• •Patch com o Markdown corrigido/criado e, se necessário, ajustes mínimos no código de listagem.

Checklist

• • Frontmatter completo e tipos corretos.
• • npm run dev sobe sem erro de Contentlayer.
• • npm run build passa.

Limitações e recomendações futuras

• •Este skill não cobre migração para MDX/RSC/App Router; é focado no setup atual.

Consulte também

• •site-nextjs-static-export (skill do repo)
• •level (string)