Files
andon/CONTEXT.md
Julien Calixte a304973af6 init
2026-05-27 21:54:20 +02:00

3.0 KiB

Andon — Weak Point Visualisation

A digital twin of the company's physical Lean/TPS project board. Team members raise problems about the board itself as they use it; the system aggregates those reports to reveal which parts of the board are weakest, so the board product can be radically improved as it rolls out company-wide (Dantotsu).

Language

Board: The standardised physical project board being deployed across the company; the product under test. Rendered in the app as ASCII art. Avoid: panel, wall

Block: One of the four named quadrants of the Board: Value for Customer, Right First Time & Just in Time, Tech-Enabled Network of Teams, Building a Learning Organisation.

Section: A single sheet within a Block (e.g. Macroplan, Feature Kanban, Problem Solving), sized A2/A3/A4. The unit a team member clicks and the unit weak-point analysis aggregates over. Avoid: sheet, paper, tile, zone

Defect: A single reported problem about one Section of the Board — one team, one moment, one verbatim. The unit a team member files. Avoid: issue, problem, bug, ticket

Weak Point: A Section that accumulates Defects. Not filed by anyone; revealed by analysis (the dashboard's descending-order ranking). "Weak point" names the problem area, not a single report.

Andon: The act/signal of a team member raising a Defect by clicking a Section. Also the name of the reporting app.

Verbatim: The reporter's own words describing a Defect, shown in the dashboard modal. Avoid: description, comment, note

Project: The client engagement a reporting team member belongs to (an app built for a client, for an amount, a duration, a scope). Selected when filing a Defect; remembered for future selection.

Reporter: The @theodo.com team member who filed a Defect, identified via SSO and shown on the dashboard. Attribution is transparent (not blameless) by design.

Relationships

  • The Board has exactly four Blocks
  • A Block contains one or more Sections
  • A team member pulls the Andon on a Section to file a Defect
  • A Defect belongs to exactly one Section and one Project, and carries one Verbatim
  • A Section that accumulates Defects is a Weak Point

Example dialogue

Owner: "Macroplan has 14 Defects across 6 Projects — that Section is a Weak Point." Dev: "So a team member pulled the Andon on the Macroplan Section 14 times; each is one Defect with its own Verbatim?" Owner: "Right. The dashboard ranks Sections by Defect count descending — that ranking is the weak-point analysis."

Flagged ambiguities

  • "problem / issue / defect / weak point" were used interchangeably in the brief — resolved: a single report is a Defect; a Section accumulating defects is a Weak Point; "issue"/"problem" are avoided aliases.
  • A report is about the Board artifact, not about the reporter's own project work — resolved during design.