| name | exponencial-content-authoring |
| description | Use when adding, removing, restructuring, or revising curriculum content, theory lessons, exercises, or answer keys in Exponencial. Prefer Markdown and declarative content sources; avoid touching React components unless the renderer contract truly needs to change. |
Exponencial Content Authoring
Leia nesta ordem:
AGENTS.mddocs/architecture.mddocs/content-authoring.mddocs/estrutura/00_README.md se a tarefa envolver cobertura curricular ou scaffold
Regra principal
O site deve ser tratado como renderer. Se a mudança puder ser resolvida na fonte de conteúdo, não mexa na UI.
Onde editar
- tópico:
src/content/**/_topic.md
- lição teórica:
src/content/**/*.md
- exercícios e gabaritos:
src/content/**/*.questions.md
- scaffold curricular:
scripts/curriculum-seed.mjs
- taxonomia canônica:
docs/estrutura/*
- parser de questões:
scripts/question-utils.mjs
Se a questão precisar de resolução passo a passo:
- use
### Solução
- prefira o schema estruturado em JSON dentro do Markdown
- use tipos como
markdown, equation, scratchpad e algorithm
Nunca faça
- não edite
src/generated/content-manifest.ts
- não edite
src/generated/lesson-content-index.ts nem src/generated/question-index.ts
- não espalhe texto curricular em TSX
- não dependa de PDF no runtime
Fluxo
- Identifique se a mudança é teoria, scaffold ou exercício.
- Edite a fonte mínima possível.
- Se a grade base mudou, rode
npm run content:scaffold.
- Gere/valide o manifesto com
npm run content:generate.
- Rode
npm run lint.
- Rode
npm run build.
Observação importante
O projeto já usa um pipeline declarativo para currículo, teoria, exercícios e gabaritos.
A taxonomia canônica existe para que o app já nasça com cobertura ampla, mesmo quando parte das lições ainda estiver em outline. Ao preencher conteúdo, prefira editar os Markdown scaffoldados em vez de criar estruturas paralelas.
Se a solicitação for editorial, siga o modelo atual do repositório e altere conteúdo antes de pensar em UI.
