Published · npm latest
Improvement compass.
Minor over 4.3.0. Named architecture residual—SoC, DIP, domain, and more—projected from sensors you already have. Not a score. Gate unchanged. No required config migration.
Upgrade
Get 4.4.0
Prefer project-local npx arkgate upgrade over a global
binary. Doctor prints the improvement compass (not a score). Full
JSON: npx arkgate-check --doctor --json.
What changed
In plain English.
Improvement compass
Doctor and HTML name residual with closed
lenses (separation of concerns, coupling, DIP,
domain alignment, …). Always notAScore. Never flips
the gate.
Honest out-of-scope
Scalability, full resilience, and app-security tooling stay out-of-scope. Missing APM or SAST does not invent residual.
Type-only is placement debt
Denied import type edges map to
modularity residual—not “runtime coupling.”
Value edges still block merge.
Skills that coach residual
Same 13 skill names, deeper path for vibe-coder and full-AI workflows: compass preflight, anti false-done, one pilot at a time.
Green edges ≠ finished design
Enforce · design-weak stays honest. Empty plan A is not “architecture done.” Compass names what still needs shape work.
Product docs, not ticket soup
Public docs explain commands and behavior—not internal roadmap codes. Maintainer archaeology stays in the library repo.
Honesty notes
What did not change
- Write gate and CI fail-closed semantics for value layer edges
- Binary gate—no numeric architecture score, no LLM pass/fail
- No new skill names; no new ArkRules sensors
-
Soft hosts (Cursor / Codex / OpenCode) stay advisory at local write;
required CI
--strict-mergeis still the hard merge boundary - Plan B reshape remains judgment—never mechanical-safe by default
Residual lenses never change valid, strict-merge, or
goal.met. Compass is coaching over existing evidence—not
a second product analyzer.
Maintainer source: docs/releases/4.4.0.md ↗ · GitHub tag ↗