documentation-context

Generates learning-focused documentation in Brazilian Portuguese from git changes and planning files.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mateusfavaro/documentation-context --skill documentation-context
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-context
Source: https://github.com/mateusfavaro/documentation-context/tree/main
Command: npx skills add https://github.com/mateusfavaro/documentation-context --skill documentation-context

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Perde-se o contexto de uma task quando não há documentação: o commit mostra o “o que mudou”, mas raramente explica o “por que” e como as partes se conectam depois de meses.

Core Features & Use Cases

  • Documentação fiel ao que foi implementado: consolida código alterado e arquivos de planejamento para explicar comportamento real, sem inventar melhorias.
  • Roteiro adaptativo em 4 fases: faz Discover, Analyze, Structure e Write, ajustando a profundidade conforme a complexidade.
  • Suporte a tarefas multi-fase: lê todos os planning files relacionados e reconstrói a linha do tempo completa.
  • Saída estruturada para revisão futura: cria uma pasta com slug em pt-BR kebab-case e um README.md em português do Brasil.

Use quando você terminou uma feature, refatoração ou bugfix e quer transformar o trabalho já entregue em material de estudo e referência.

Quick Start

Dê ao AI o comando documentar task e informe qual tarefa você quer documentar, se há arquivos de planejamento relacionados e qual é o escopo, além de indicar o diretório onde a documentação deve ser criada.

Frequently Asked Questions about documentation-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate documentation from git diff and planning files?

You generate documentation by feeding git changes and planning files into a Discover, Analyze, Structure, and Write workflow, which outputs a didactic pt-BR README.md reconstructing the implementation context.

Why does a git commit fail to explain the reasoning behind code changes?

A git commit shows what changed but rarely explains the why, because reconstructing the reasoning requires combining the diff with related planning files to explain how the parts connect months later.

What is the best way to document multi-phase refactoring tasks after completion?

The best way to document multi-phase tasks is reading all related planning files to reconstruct the complete timeline, applying an adaptive 4-phase workflow to output a faithful pt-BR documentation folder.

Can I document bugfixes and config changes without inventing improvements?

You can document bugfixes and config changes without inventing improvements because the Skill applies a fidelity rule to consolidate actual git changes and planning files, ensuring the documentation explains real behavior.

Does documentation generation work with Brazilian Portuguese outputs?

Documentation generation works with Brazilian Portuguese outputs by applying pt-BR didactic rules, creating a folder with a kebab-case slug and a README.md written in Portuguese.

When should I not use automated documentation generation from codebase context?

You should not use automated documentation generation from codebase context when there is no evidence of the reasoning in the git changes or planning files, as the Skill avoids inventing improvements and requires evidenced context.