Improve existing editorial unit by incorporating review feedback while preserving curriculum traceability and pedagogical structure. Trigger on: mejorar unidad, incorporar feedback, evolucionar contenido, revisar unidad, enhance unit. Categorizes feedback, applies corrections in priority order, tracks every change, and re-validates against acceptance criteria. Prevents traceability loss during revision cycles. Essential for iterative editorial quality improvement.
Evolution without traceability is mutation. Every improvement must preserve the curriculum thread that connects content to learning outcomes.
Incorporate review feedback into an existing editorial unit while preserving all DZ-ref traceability, pedagogical structure, and style compliance. This skill exists because the editorial pipeline is iterative — units pass through multiple review cycles (pedagogical, style, consistency, comprehensibility), and each cycle produces feedback that must be incorporated without breaking the structural integrity established in prior passes. Uncontrolled revision is the leading cause of traceability loss and regression defects.
| Input | Source | Required | Description |
|---|---|---|---|
| Editorial unit | project/units/ | Yes | Current version of the unit to evolve |
| Review feedback | Review skill outputs | Yes | One or more review reports with findings |
| Matriz A&S | project/matriz-as/ | No | For re-validating destreza coverage after changes |
| Manual de Voz | references/voice-manual-rules.md | No | For re-validating style after changes |
| Output | Format | Description |
|---|---|---|
| Evolved unit | Markdown | Updated unit with all feedback incorporated |
| Change log | Markdown table | Every modification with feedback traceability |
| Conflict resolution log | Markdown list | Conflicting feedback items and resolution rationale |
| Validation summary | Checklist | Post-evolution verification results |
## Evolution Report — [Unit Name] v[N] -> v[N+1]
**Feedback Sources**: [list review types incorporated]
**Changes Applied**: [X] total | [C] CRITICAL | [W] WARNING | [I] INFO
**DZ-Ref Integrity**: [PRESERVED / BROKEN — detail]
### Change Log
| # | Location | Category | Change Description | Feedback Source | Evidence |
|---|----------|----------|--------------------|----------------|----------|
| 1 | U1-B2-Act3 | PEDAGOGICAL | Replaced "Lista" verb with "Argumenta" to match Evaluar level | review-pedagogical #2 | [PEDAGOGIA] |
| 2 | U1-B1-P2 | STYLE | Changed "Debes" to "Te invitamos a" per VOZ-04 | review-style #1 | [METODOLOGIA] |
| 3 | U1-B3-Act1 | CONTENT | Added DUA adaptation: audio description alternative | review-pedagogical #5 | [PEDAGOGIA] |
### Conflict Resolutions
- **Conflict**: review-style recommended simplifying Act 2.3 vocabulary; review-pedagogical required maintaining "hipotesis" as target taxonomy term.
**Resolution**: Retained "hipotesis" with added inline definition. Pedagogical alignment takes precedence over vocabulary simplification. [PEDAGOGIA]
### Post-Evolution Validation
- [x] DZ-ref tags: All [N] tags verified present and unmodified
- [x] Taxonomy alignment: Modified activities re-checked — no regressions
- [x] Style compliance: Corrections verified against Manual de Voz
- [ ] Comprehensibility: Re-validation recommended (new content added)
### Deferred Items
| # | Feedback Item | Reason for Deferral |
|---|---------------|-------------------|
| 1 | "Add interactive digital resource" | Requires digital-resource-creator; out of scope for unit evolution |
ERROR: Cannot evolve unit without review feedback. Run a review skill first.ERROR: Unit [name] not found at expected path.references/content-evolution-patterns.md — Feedback incorporation workflow, change tracking format, preservation verification checklist.