site-contentlayer-authoring

Este repositório usa contentlayer2 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, Page, Project, Experience, Course, Testimonial, Skill.
• •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)
• •category (string)
• •image (string)

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

Page (content/pages/**/*.md)

• •title (string)
• •description (string)
• •image (string)

URL computada: /${flattenedPath sem pages/} (ex.: content/pages/about.md → /about).

Project (content/projects/**/*.md)

• •id (number)
• •title (string)
• •description (string)
• •projectUrl (string)
• •pin (boolean)
• •image (string)

Experience (content/experiences/**/*.md)

• •id (number)
• •title (string)
• •company (string)
• •location (string)
• •period (string)
• •show (boolean)

Course (content/courses/**/*.md)

• •name (string)
• •institution (string)
• •completionDate (date)
• •workload (number)
• •courseLink (string)
• •certificateLink (string)

Computed:

• •url: /${flattenedPath}
• •slug: baseado no path removendo courses/

Testimonial (content/testimonials/**/*.md)

• •name (string)
• •position (string)
• •testimonial (string)
• •image (string)

Skill (content/skills/**/*.md)

• •name (string)
• •level (string)
• •firstContact (number)

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 (Contentlayer2 + 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)

Describe when this skill should be used.

Instructions

1. •First step
2. •Second step
3. •Additional steps as needed