mh-cto-sdlc-tech-retro

Evaluate architectural decisions against production outcomes to update ADRs and catalog technical debt.

2|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Imad-Oute/MicroHard --skill mh-cto-sdlc-tech-retro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mh-cto-sdlc-tech-retro
Source: https://github.com/Imad-Oute/MicroHard/tree/main/src/departments/cto/sdlc/phase-8-validation/mh-cto-sdlc-tech-retro
Command: npx skills add https://github.com/Imad-Oute/MicroHard --skill mh-cto-sdlc-tech-retro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps in evaluating architectural decisions against production reality, updating Architecture Decision Records (ADRs), and cataloging technical debt.

Core Features & Use Cases

  • Technical Retrospective: Compares architectural decisions against production outcomes.
  • ADRs Update: Updates ADRs based on production evidence.
  • Technical Debt Management: Catalogs and prioritizes technical debt.
  • Use Case: After a product launch, use this Skill to review architectural decisions and identify areas of technical debt.

Quick Start

Trigger the Technical Retrospective by saying, "tech retro".

Frequently Asked Questions about mh-cto-sdlc-tech-retro

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

FAQPage Schema
How do I evaluate architectural decisions against production outcomes?

Evaluating architectural decisions against production outcomes requires comparing initial Architecture Decision Records (ADRs) against actual production logs and system observability data to identify divergences between design assumptions and live system behavior.

What is a technical retrospective for managing technical debt post-production?

A technical retrospective for managing technical debt is a post-production review process that catalogs and prioritizes accumulated technical debt by analyzing ADRs and production evidence. It focuses on architectural quality assessment and debt reduction after a product launch.

How do I update Architecture Decision Records based on production evidence?

To update Architecture Decision Records (ADRs) based on production evidence, you analyze production logs and system observability data to validate or correct past architectural choices. This ensures ADRs reflect the actual operational reality of the system.

When do I need to catalog technical debt after a product launch?

You need to catalog technical debt after a product launch when you want to assess architectural quality and prioritize debt reduction. This post-production analysis reviews architectural decisions against production reality to update records and manage accumulated debt.

Do I need system observability data to perform a technical retro?

Yes, system observability data is required to perform a technical retro. The analysis specifically depends on observability data and production logs to evaluate architectural decisions against actual production outcomes and update ADRs effectively.

What's the best way to prioritize technical debt identified during an architecture review?

The best way to prioritize technical debt identified during an architecture review is to evaluate it against production outcomes using a technical retrospective. This approach uses production evidence and ADR analysis to focus on architectural quality and targeted debt reduction.