skilly. Buy ad slot
All skills
Documentation / AGENT SKILL

docs

deMGoncalves/oh-my-claude
0 installs 2 GitHub stars
0

Synchronizes arc42, C4, ADR, and BDD documentation with implemented code.
Sincroniza docs/ (arc42, c4, adr, bdd) com código implementado. Funciona sem Spec Flow — útil para código legado e Quick fixes acumulados.

BEFORE YOU INSTALL

Understand the trade-offs.

SECURITY REVIEW

Not yet assessed

Review the original instructions and requested permissions before installing.

No security review is available for this catalog entry yet.

SKILL QUALITY

Not yet assessed

How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.

No quality assessment is available for this catalog entry yet.

The full skill.

Original instructions from the publisher’s SKILL.md

## Propósito

Executa Fase 4 (Sync de Docs) independentemente, sem necessidade de fluxo completo.
Útil para código legado, Quick fixes acumulados ou após Task completo.

## Instruções

1. **Determinar escopo**:
   - Se argumento fornecido → usar aquele caminho (ex: `src/user_auth/`)
   - Se não → usar arquivos alterados recentemente:
   ```bash
   git diff --name-only HEAD~1 2>/dev/null | head -20
   ```

2. **Ler código alvo** em `src/` para entender implementação atual

3. **Ler documentação existente** em `docs/`:
   - `docs/arc42/` — arquitetura atualmente documentada
   - `docs/c4/` — diagramas de contexto, container, componente
   - `docs/adr/` — decisões arquiteturais anteriores
   - `docs/bdd/` — features Gherkin existentes

4. **Comparar código vs docs** e identificar lacunas:
   - Novos contextos ou containers não documentados
   - Comportamentos sem feature Gherkin
   - Decisões técnicas sem ADR registrado

5. **Atualizar** o que for necessário:
   - `docs/arc42/` — blocos de construção, visões de runtime, conceitos
   - `docs/c4/` — diagramas afetados
   - `docs/bdd/` — features Gherkin se comportamento mudou
   - `docs/adr/ADR-NNN.md` — criar se houver decisão arquitetural relevante

6. **Exibir resumo**:
   ```
   ✅ Docs sincronizados:
   - arc42/05_building_block_view.md — descrição
   - adr/ADR-019.md — decisão documentada
   ```