CtrlK
BlogDocsLog inGet started
Tessl Logo

repair-alignment

Fix curriculum alignment gaps and orphaned destrezas found by coverage verification to achieve 100% MinEduc standard coverage. Trigger on: reparar alineacion, fix coverage, destrezas huerfanas, llenar gaps, orphaned destrezas, curriculum gaps.

SKILL.md
Quality
Evals
Security

repair-alignment

An orphaned destreza is a broken promise to the student. Every curricular standard must trace to content -- 100% coverage is the only acceptable target.

Purpose

Remediate curriculum alignment gaps identified by verify-coverage. Insert, modify, or restructure content so that every MinEduc destreza maps to at least one activity with explicit traceability. Eliminate orphaned destrezas and redundant mappings. Achieve and verify 100% curricular coverage.

Procedure

  1. Load coverage report: Read the coverage verification report from project/reports/. Extract the list of orphaned destrezas (covered by zero activities) and under-mapped destrezas (covered but below threshold).
  2. Load Matriz A&S: Read the Alcance y Secuencia matrix to understand intended destreza-to-unit mapping.
  3. Classify gaps: For each orphaned destreza, determine if the fix requires:
    • (a) Content insertion: New activity or section in an existing unit.
    • (b) Mapping correction: Activity exists but traceability tag is missing.
    • (c) Unit restructure: Destreza belongs in a different unit per the matrix.
  4. Generate content: For type (a) gaps, draft activities that develop the destreza. Follow Sinapsis structure (Experiencia > Conceptualizacion > Reflexion > Aplicacion). Include traceability tag [REF: DZ-<asig>-<ano>-<id>].
  5. Fix mappings: For type (b) gaps, insert the correct [REF: ...] tag in the existing activity.
  6. Restructure: For type (c) gaps, move or duplicate content to the correct unit per the matrix.
  7. Consistency check: Verify inserted content is consistent with surrounding content in tone, complexity, and style.
  8. Re-verify coverage: Run coverage verification logic on the modified content. Confirm 0 orphaned destrezas remain.
  9. Produce repair log: Document every change with destreza code, repair type, and location.

Inputs

InputSourceRequired
Coverage verification reportproject/reports/coverage-*.mdYes
Matriz de Alcance y Secuenciaproject/matrix/Yes
Unit editorial filesproject/units/Yes
MinEduc destreza catalogreferences/ or project/curriculo/Yes

Outputs

OutputFormatDestination
Updated unit file(s)MDproject/units/ (in-place)
Alignment repair logMD tablestdout
Updated coverage statusMD summarystdout

Acceptance Criteria

  • Zero orphaned destrezas after repair.
  • Every inserted activity includes a [REF: DZ-...] traceability tag.
  • Inserted content follows Sinapsis 4-phase structure.
  • No existing content is deleted (only augmented or re-tagged).
  • Repair log documents every change with destreza code and repair type.
  • Re-verification confirms 100% coverage.

Output Format

## Alignment Repair Log

| Destreza | Repair Type | Unit | Action Taken |
|----------|-------------|------|--------------|
| DZ-MAT-5-14 | Content insertion | U3 | Added activity 3.4: "Fracciones en la vida diaria" |
| DZ-LENG-5-08 | Mapping correction | U2 | Added [REF: DZ-LENG-5-08] to existing activity 2.2 |
| DZ-CCNN-5-22 | Unit restructure | U4->U5 | Moved section 4.6 to U5 per matrix alignment |

### Coverage Status
- Before: 47/52 destrezas covered (90.4%)
- After: 52/52 destrezas covered (100%)
- Orphaned: 0

Error Handling

ErrorResponse
Coverage report not foundHalt. Suggest running verify-coverage first.
Destreza code not in catalogWarn. Tag [SUPUESTO] on generated content. Flag for curricular-analyst review.
Matrix and report contradictUse matrix as source of truth. Log discrepancy.
Unit file is read-only or lockedHalt for that unit. Proceed with others. Report blocked units.

Anti-Patterns

  • Phantom coverage: Adding a traceability tag without actual content that develops the destreza. Tags must map to real activities.
  • Content duplication: Copying an activity verbatim into a second unit. Adapt to the new unit context.
  • Orphan whack-a-mole: Fixing one gap while breaking another mapping. Always re-verify after changes.
  • Ignoring the matrix: Inserting content based on intuition rather than the Alcance y Secuencia matrix.
  • Style mismatch: Inserting content that does not match the tone and complexity of the surrounding unit.

References

  • references/alignment-repair-patterns.md -- Orphan remediation strategies, insertion techniques
  • references/taxonomy-mapping.md -- Bloom/Marzano levels for activity generation
  • references/priming-rag/rag-curriculum-coverage.md -- Curricular coverage RAG primer
Repository
JaviMontano/mao-scriba
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.