good-enough/core-docs/good-enough-4u0-design-doct...

49 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Good Enough 4u0 — Design Doctrine
**File:** `good-enough-4u0-design-doctrine.md`
## 1) The Three Guarantees
- **Never discontinued:** Anyone can make more at any time.
- **Support never expires:** The maker/owner is the maintainer; fixes and improvements are local.
- **Price is always right:** No royalties, lock-ins, or recurring licenses.
## 2) COTS Anchor Requirement
- Every design must include **at least one Anchor COTS** part predicted to remain plentiful (PVC/EMT conduit, mosquito screen, hardware cloth, zip ties, pallet straps, etc.).
- Prefer **globally ubiquitous** sizes/grades with multiple suppliers and easy substitutes.
- Document a **substitution map** (acceptable alternates) to keep builds resilient.
## 3) Ship-Light Pattern
- Ship only **custom parts** (printed, routed, machined).
- **Source Local** all Anchor COTS and fasteners.
- Include a simple **cut list** and **tool floor** (basic tools only).
- Fasteners: stick to **common standards** (M-series or Imperial basics).
- Flat-pack if possible for minimal shipping volume.
## 4) Deliberate Imperfection, Declared
- Each design must state its **explicit defect(s)** (material downgrade, manual actuation, loose tolerance, etc.).
- Define a clear **intended use envelope** (“good enough for X; not for Y”).
- Favor **soft, visible failure** over catastrophic failure.
## 5) Good-Enough Quality Gate
- **Function:** Demonstrates the intended task under normal use.
- **Safety:** No hidden hazards; failure modes are non-injurious.
- **Replicability:** Another member can rebuild it from the doc alone.
- **Transparency:** Limits and defects are front-and-center, not footnotes.
- **No flawless builds.** If its perfect, it doesnt belong here.
## 6) Scope & Exclusions
- Out of scope: **life-critical, medical, structural, high-voltage/power**, or any regulated product.
- Focus: **everyday utility**, not certification-bound applications.
## 7) Documentation Minimums
- **Bill of Materials:** split into *Ship* vs *Source Local*.
- **Anchor COTS rationale:** why its abundant; acceptable substitutes.
- **Build steps:** short, photo-friendly, tool-minimal.
- **Limitations:** where it fails; environments to avoid.
- **License:** commons/public domain.
## 8) Credibility Safeguards
- **Proof of Use:** show it working in a real context.
- **Peer sanity check:** at least one other member confirms “good enough, not dangerous.”
- **Version tag:** small, frequent iterations beat polish.