---
name: write-a-technical-case-study
category: write
description: Write a technical case study from verified architecture, constraints, decisions, implementation, measurements, failures, outcomes, and lessons. Use when documenting how a system or engineering project actually worked.
---

# write-a-technical-case-study

Explain tradeoffs and evidence rather than presenting inevitable success.

## When to use

- Use for internal learning, customer education, hiring, open source, or public engineering writing.
- Do not disclose secrets, exploit details, private customer data, or proprietary information without approval.

## Procedure

1. Define audience, permission, confidentiality, technical scope, publication goal, and evidence sources.
2. Establish baseline problem, users, constraints, requirements, architecture, and success measures.
3. Reconstruct timeline, alternatives, decision records, implementation, tests, releases, incidents, and revisions.
4. Explain components and data flows with diagrams that match the deployed system.
5. Report measurements with units, periods, environments, sample, comparison, and uncertainty.
6. Include failures, rejected approaches, operational cost, security, accessibility, maintenance, and limitations.
7. Trace claims to code, commits, tests, dashboards, logs, interviews, or documents.
8. Obtain technical, security, privacy, customer, legal, and editorial review as applicable.

## Done

- A technical case study records context, architecture, choices, implementation, evidence, measurements, failures, outcomes, limits, and sources
- Architecture, claim, metric, timeline, confidentiality, security, diagram, link, and specialist-review checks verify publication