site-contentlayer-authoring

name	site-contentlayer-authoring
description	Authoring and maintenance workflow for this repo's Contentlayer2 content (content/*). Use when adding/editing Markdown pages, blog posts, projects, experiences, courses, testimonials, or skills; when frontmatter is missing/broken; or when Contentlayer build fails.

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.

2. Criar/editar o Markdown

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

3. Validar localmente

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

4. 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