hansei SKILL.md skillA

hansei from kuya-egg/monozukuri is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kuya-egg/monozukuri/hansei@git:20260909.6197cfc

Pins git:20260909.6197cfc in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kuya-egg/monozukuri
Path
hansei/SKILL.md
Versions recorded
1
Latest version
git:20260909.6197cfc, committed Sep 9, 2026
Size
3,176 bytes
Repository stars
16
License
MIT

Reflect on failures, incidents, reviews, and completed software work to turn evidence into durable tests, guardrails, documentation, and process improvements.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Hansei

Hansei is disciplined reflection. In software, examine what happened, why it
happened, and how the system allowed it so the lesson becomes a durable
improvement. This is a Japanese-inspired engineering metaphor, practiced
without blame or ritual for its own sake.

## Use this skill when

- an incident, outage, regression, or escaped defect occurred;
- a review found a recurring quality problem;
- a release or project completed and important lessons should be preserved;
- a workaround has become normal behavior; or
- the team wants to improve its engineering system rather than only patch code.

## Outcome

Produce a concise reflection with:

- the observed impact and timeline;
- contributing technical, process, and communication conditions;
- what made detection, diagnosis, or recovery easier or harder;
- what worked and should be preserved;
- actionable improvements with owners or clear scope; and
- a follow-up test, guardrail, document, signal, or process change.

## Workflow

### 1. Establish the facts

Use logs, traces, tests, diffs, deployments, timelines, and direct reports.
Separate what is known from what is inferred. Do not begin with blame or a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kuya-egg/monozukuri/hansei@sha256:70ff273126c4eb2b

The line at the top of this page pins the label git:20260909.6197cfc, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3kqjuwatnyga5e6d.svg)](https://markdownregistry.com/a/art_3kqjuwatnyga5e6d)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 9, 2026.

versioncommittedcommitsizeaudit
git:20260909.6197cfc latest2026-09-09 6197cfc 3,176 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3176 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kuya-egg/monozukuri · 16 stars · license MIT · pushed 2026-09-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3kqjuwatnyga5e6d
GET https://markdownregistry.com/api/v1/resolve?ref=kuya-egg/monozukuri/hansei
GET https://markdownregistry.com/api/v1/blob/70ff273126c4eb2bfab6db7735e447c6bf51d679f4dfc5274f821879260a0e1e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kuya-egg/monozukuri

andon SKILL.md skill
kuya-egg/monozukuri · andon/SKILL.md · Make software health, failure, degradation, and recovery visible through useful observability and diagnostics. Use when…
git:20260909.6197cfc · audit A · 16 stars
genchi-genbutsu SKILL.md skill
kuya-egg/monozukuri · genchi-genbutsu/SKILL.md · Inspect the real repository, environment, dependencies, and runtime evidence before designing or changing software. Use…
git:20260909.6197cfc · audit A · 16 stars
jidoka SKILL.md skill
kuya-egg/monozukuri · jidoka/SKILL.md · Debug software by making failures visible, reproducing them, finding contributing causes, and adding durable regression…
git:20260909.6197cfc · audit A · 16 stars
kaizen SKILL.md skill
kuya-egg/monozukuri · kaizen/SKILL.md · Improve software continuously through small, safe, behavior-preserving changes that reduce maintenance cost. Use for…
git:20260909.6197cfc · audit A · 16 stars
kanso SKILL.md skill
kuya-egg/monozukuri · kanso/SKILL.md · Choose simple, maintainable software designs by removing speculative complexity, comparing alternatives, and making…
git:20260909.6197cfc · audit A · 16 stars
kata SKILL.md skill
kuya-egg/monozukuri · kata/SKILL.md · Implement software through small, repeatable, integrated vertical slices with clear exit criteria and honest…
git:20260928.56a849e · audit A · 16 stars
kodawari SKILL.md skill
kuya-egg/monozukuri · kodawari/SKILL.md · Review software with careful attention to correctness, maintainability, security, operations, and meaningful detail…
git:20260909.6197cfc · audit A · 16 stars
monozukuri-blueprint SKILL.md skill
kuya-egg/monozukuri · monozukuri-blueprint/SKILL.md · Author a greenfield build blueprint in four gated stages — business logic, tech stack, logic-to-stack mapping, and a…
git:20260928.fe2f1d7 · audit A · 16 stars
monozukuri-core SKILL.md skill
kuya-egg/monozukuri · monozukuri-core/SKILL.md · The one Monozukuri command: routes the task, runs the greenfield blueprint when needed, drives the focused skills…
git:20260928.fe2f1d7 · audit A · 16 stars
monozukuri-router SKILL.md skill
kuya-egg/monozukuri · monozukuri-router/SKILL.md · Step 0 of consequential software work under Monozukuri, run by monozukuri-core. Classify the task, assess its risk…
git:20260928.fe2f1d7 · audit A · 16 stars
nemawashi SKILL.md skill
kuya-egg/monozukuri · nemawashi/SKILL.md · Clarify software goals, constraints, stakeholders, and risks before consequential design or implementation work. Use…
git:20260909.6197cfc · audit A · 16 stars
poka-yoke SKILL.md skill
kuya-egg/monozukuri · poka-yoke/SKILL.md · Prevent software mistakes through strong boundaries, safe defaults, meaningful tests, and mechanically enforced…
git:20260909.6197cfc · audit A · 16 stars

Every file in kuya-egg/monozukuri

Browse by kind, by grade A, or by owner.