cyc-stack 0.0.0-stage → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/.agents/plugins/marketplace.json +12 -0
  2. package/.claude-plugin/marketplace.json +14 -0
  3. package/.claude-plugin/plugin.json +17 -0
  4. package/.codex-plugin/plugin.json +33 -0
  5. package/.cursor-plugin/marketplace.json +13 -0
  6. package/.cursor-plugin/plugin.json +19 -0
  7. package/INSTALL.md +108 -0
  8. package/LICENSE +21 -0
  9. package/README.md +359 -2
  10. package/bin/cyc.mjs +285 -0
  11. package/catalog/playbooks.json +20 -0
  12. package/docs/README.md +30 -0
  13. package/docs/assets/cyc-method-library.svg +39 -0
  14. package/docs/assets/cyc-overview.svg +44 -0
  15. package/docs/assets/cyc-readme-banner-mobile.svg +31 -0
  16. package/docs/assets/cyc-readme-banner.svg +39 -0
  17. package/docs/assets/cyc-workflow-diagram.svg +415 -0
  18. package/docs/code-quality.md +42 -0
  19. package/docs/context.md +40 -0
  20. package/docs/cyc-method-map.md +58 -0
  21. package/docs/cyc-workflow.md +188 -0
  22. package/docs/engineering/code-standards.md +103 -0
  23. package/docs/engineering/domain-design.md +81 -0
  24. package/docs/engineering/failure-handling.md +99 -0
  25. package/docs/impact-analysis.md +70 -0
  26. package/docs/installation.md +196 -0
  27. package/docs/onboarding-recovery.md +75 -0
  28. package/docs/principles.md +49 -0
  29. package/docs/project-tools.md +108 -0
  30. package/docs/response-standard.md +202 -0
  31. package/docs/runtime.md +247 -0
  32. package/docs/skill-contract.md +70 -0
  33. package/docs/skill-craft.md +23 -0
  34. package/docs/validation.md +39 -0
  35. package/docs/work-assessments.md +102 -0
  36. package/hooks/claude.json +10 -0
  37. package/hooks/codex.json +28 -0
  38. package/hooks/cursor.json +8 -0
  39. package/methods/cyc-build/SKILL.md +65 -0
  40. package/methods/cyc-build/references/file-writes.md +11 -0
  41. package/methods/cyc-challenge/SKILL.md +48 -0
  42. package/methods/cyc-context/SKILL.md +76 -0
  43. package/methods/cyc-context/references/evidence.md +27 -0
  44. package/methods/cyc-context/references/templates.md +54 -0
  45. package/methods/cyc-context/scripts/evidence.mjs +61 -0
  46. package/methods/cyc-correct/SKILL.md +43 -0
  47. package/methods/cyc-deliver/SKILL.md +52 -0
  48. package/methods/cyc-design/SKILL.md +50 -0
  49. package/methods/cyc-design/frontend-design/SKILL.md +43 -0
  50. package/methods/cyc-design/frontend-design/references/color.md +77 -0
  51. package/methods/cyc-design/frontend-design/references/craft-rules.md +61 -0
  52. package/methods/cyc-design/frontend-design/references/decision-sheet.md +110 -0
  53. package/methods/cyc-design/frontend-design/references/experience-review.md +58 -0
  54. package/methods/cyc-design/frontend-design/references/generic-tells.md +76 -0
  55. package/methods/cyc-design/frontend-design/references/layout-archetypes.md +188 -0
  56. package/methods/cyc-design/frontend-design/references/reference-standards.md +38 -0
  57. package/methods/cyc-design/frontend-design/references/typography.md +51 -0
  58. package/methods/cyc-design/frontend-design/references/ux-foundations.md +45 -0
  59. package/methods/cyc-design/frontend-design/references/visual-material.md +42 -0
  60. package/methods/cyc-error-ledger/SKILL.md +53 -0
  61. package/methods/cyc-error-ledger/references/entry-format.md +38 -0
  62. package/methods/cyc-explore/SKILL.md +41 -0
  63. package/methods/cyc-frame/SKILL.md +49 -0
  64. package/methods/cyc-impact/SKILL.md +64 -0
  65. package/methods/cyc-reflect/SKILL.md +48 -0
  66. package/methods/cyc-remember/SKILL.md +53 -0
  67. package/methods/cyc-scout/SKILL.md +67 -0
  68. package/methods/cyc-setup/SKILL.md +60 -0
  69. package/methods/cyc-teach/SKILL.md +40 -0
  70. package/methods/cyc-understand/SKILL.md +40 -0
  71. package/methods/cyc-understand/references/diagnose.md +53 -0
  72. package/methods/cyc-verify/SKILL.md +84 -0
  73. package/methods/cyc-verify/references/recipe.md +53 -0
  74. package/package.json +93 -4
  75. package/plugin.json +40 -0
  76. package/rules/cyc-delivery.mdc +33 -0
  77. package/scripts/baseline-worker.mjs +10 -0
  78. package/scripts/catalog.mjs +29 -0
  79. package/scripts/check-response.mjs +13 -0
  80. package/scripts/claude-project-hook.mjs +12 -0
  81. package/scripts/context-review.mjs +600 -0
  82. package/scripts/host-activation.mjs +66 -0
  83. package/scripts/install.mjs +387 -0
  84. package/scripts/onboarding.mjs +110 -0
  85. package/scripts/packet.mjs +107 -0
  86. package/scripts/project-tools.mjs +196 -0
  87. package/scripts/recovery.mjs +66 -0
  88. package/scripts/response-gate.mjs +105 -0
  89. package/scripts/response-hook.mjs +237 -0
  90. package/scripts/response-mode.mjs +12 -0
  91. package/scripts/run-gate.mjs +264 -0
  92. package/scripts/runtime.mjs +1723 -0
  93. package/scripts/source-hash-worker.mjs +5 -0
  94. package/scripts/source-snapshot.mjs +405 -0
  95. package/scripts/test-output.mjs +258 -0
  96. package/scripts/work-review.mjs +257 -0
  97. package/skills/cyc/SKILL.md +130 -0
  98. package/skills/cyc/references/playbooks/bug-fix.md +13 -0
  99. package/skills/cyc/references/playbooks/evaluate.md +13 -0
  100. package/skills/cyc/references/playbooks/experience.md +7 -0
  101. package/skills/cyc/references/playbooks/explore.md +9 -0
  102. package/skills/cyc/references/playbooks/feature.md +14 -0
  103. package/skills/cyc/references/playbooks/handoff.md +11 -0
  104. package/skills/cyc/references/playbooks/investigation.md +7 -0
  105. package/skills/cyc/references/playbooks/performance.md +7 -0
  106. package/skills/cyc/references/playbooks/plan.md +11 -0
  107. package/skills/cyc/references/playbooks/refactor.md +12 -0
  108. package/skills/cyc/references/playbooks/reflect.md +11 -0
  109. package/skills/cyc/references/playbooks/resume.md +11 -0
  110. package/skills/cyc/references/playbooks/review.md +9 -0
  111. package/skills/cyc/references/playbooks/teach.md +11 -0
  112. package/skills/cyc/references/playbooks/verify.md +7 -0
@@ -0,0 +1,415 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2020 3440" width="2020" height="3440" role="img" aria-labelledby="diagram-title diagram-desc" font-family="Segoe UI, Arial, sans-serif">
2
+ <title id="diagram-title">CYC connected engineering workflow</title>
3
+ <desc id="diagram-desc">Twelve responsibilities inside Scout, Build, Verify and Deliver. Arrows connect the work, developer decisions, knowledge inputs, diagnostic returns, separate ready and blocked outcomes, and independent publication and accepted-learning branches. Complete text explanations accompany the diagram.</desc>
4
+ <defs>
5
+ <marker id="arrow-work" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 Z" fill="#197f70"/></marker>
6
+ <marker id="arrow-recovery" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 Z" fill="#b86b0a"/></marker>
7
+ <marker id="arrow-decision" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 Z" fill="#2b69b0"/></marker>
8
+ <marker id="arrow-knowledge" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 Z" fill="#7044b4"/></marker>
9
+ <marker id="arrow-blocked" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto"><path d="M0,0 L10,5 L0,10 Z" fill="#b72d4f"/></marker>
10
+ </defs>
11
+ <rect x="0" y="0" width="2020" height="3440" rx="0" fill="white" stroke="none" stroke-width="2"/>
12
+ <rect x="450" y="190" width="640" height="910" rx="12" fill="#f7fbfa" stroke="#bfded6" stroke-width="2" stroke-dasharray="8 6"/>
13
+ <text x="468" y="220" font-size="18" fill="#197f70" font-weight="700" text-anchor="start"><tspan x="468" dy="0">SCOUT</tspan></text>
14
+ <text x="1072" y="220" font-size="16" fill="#197f70" font-weight="400" text-anchor="end"><tspan x="1072" dy="0">recorded stage</tspan></text>
15
+ <rect x="450" y="1120" width="640" height="440" rx="12" fill="#f7fbfa" stroke="#bfded6" stroke-width="2" stroke-dasharray="8 6"/>
16
+ <text x="468" y="1150" font-size="18" fill="#197f70" font-weight="700" text-anchor="start"><tspan x="468" dy="0">BUILD</tspan></text>
17
+ <text x="1072" y="1150" font-size="16" fill="#197f70" font-weight="400" text-anchor="end"><tspan x="1072" dy="0">recorded stage</tspan></text>
18
+ <rect x="450" y="1590" width="640" height="520" rx="12" fill="#f7fbfa" stroke="#bfded6" stroke-width="2" stroke-dasharray="8 6"/>
19
+ <text x="468" y="1620" font-size="18" fill="#197f70" font-weight="700" text-anchor="start"><tspan x="468" dy="0">VERIFY</tspan></text>
20
+ <text x="1072" y="1620" font-size="16" fill="#197f70" font-weight="400" text-anchor="end"><tspan x="1072" dy="0">recorded stage</tspan></text>
21
+ <rect x="450" y="2140" width="640" height="320" rx="12" fill="#f7fbfa" stroke="#bfded6" stroke-width="2" stroke-dasharray="8 6"/>
22
+ <text x="468" y="2170" font-size="18" fill="#197f70" font-weight="700" text-anchor="start"><tspan x="468" dy="0">DELIVER</tspan></text>
23
+ <text x="1072" y="2170" font-size="16" fill="#197f70" font-weight="400" text-anchor="end"><tspan x="1072" dy="0">recorded stage</tspan></text>
24
+ <g id="flow-diagnosis" data-node="diagnosis">
25
+ <rect x="1480" y="1490" width="450" height="770" rx="12" fill="#fff0d6" stroke="#b86b0a" stroke-width="2.5"/>
26
+ </g>
27
+ <polyline data-from="step-1" data-to="step-2" data-kind="work" points="770,320 770,340" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
28
+ <polyline data-edge="true" data-from="step-1" data-to="step-2" data-kind="work" points="770,320 770,340" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
29
+ <polyline data-from="step-2" data-to="step-3" data-kind="work" points="770,430 770,450" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
30
+ <polyline data-edge="true" data-from="step-2" data-to="step-3" data-kind="work" points="770,430 770,450" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
31
+ <polyline data-from="step-3" data-to="step-4" data-kind="work" points="770,550 770,570" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
32
+ <polyline data-edge="true" data-from="step-3" data-to="step-4" data-kind="work" points="770,550 770,570" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
33
+ <polyline data-from="step-4" data-to="step-5" data-kind="work" points="770,670 770,690" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
34
+ <polyline data-edge="true" data-from="step-4" data-to="step-5" data-kind="work" points="770,670 770,690" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
35
+ <polyline data-from="step-5" data-to="step-6" data-kind="work" points="770,790 770,810" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
36
+ <polyline data-edge="true" data-from="step-5" data-to="step-6" data-kind="work" points="770,790 770,810" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
37
+ <polyline data-from="step-6" data-to="decision" data-kind="work" points="1070,860 1440,860" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
38
+ <polyline data-edge="true" data-from="step-6" data-to="decision" data-kind="work" points="1070,860 1440,860" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
39
+ <polyline data-from="decision" data-to="ask" data-kind="decision" points="1640,860 1730,860" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
40
+ <polyline data-edge="true" data-from="decision" data-to="ask" data-kind="decision" points="1640,860 1730,860" fill="none" stroke="#2b69b0" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-decision)"/>
41
+ <polyline data-from="decision" data-to="step-7" data-kind="work" points="1540,913 1540,1015 1070,1015" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
42
+ <polyline data-edge="true" data-from="decision" data-to="step-7" data-kind="work" points="1540,913 1540,1015 1070,1015" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
43
+ <polyline data-from="ask" data-to="step-5" data-kind="decision" points="1830,810 1830,740 1070,740" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
44
+ <polyline data-edge="true" data-from="ask" data-to="step-5" data-kind="decision" points="1830,810 1830,740 1070,740" fill="none" stroke="#2b69b0" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-decision)"/>
45
+ <polyline data-from="ask" data-to="record-blocked" data-kind="blocked" points="1930,860 1955,860 1955,2420 1930,2420" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
46
+ <polyline data-edge="true" data-from="ask" data-to="record-blocked" data-kind="blocked" points="1930,860 1955,860 1955,2420 1930,2420" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
47
+ <polyline points="770,1110 1468,1110" fill="none" stroke="#8caaa3" stroke-width="1.5" stroke-dasharray="3 5"/>
48
+ <polyline data-from="step-7" data-to="step-8" data-kind="work" points="770,1065 770,1170" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
49
+ <polyline data-edge="true" data-from="step-7" data-to="step-8" data-kind="work" points="770,1065 770,1170" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
50
+ <polyline data-from="step-8" data-to="focused-check" data-kind="work" points="770,1270 770,1289" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
51
+ <polyline data-edge="true" data-from="step-8" data-to="focused-check" data-kind="work" points="770,1270 770,1289" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
52
+ <polyline data-from="focused-check" data-to="step-9" data-kind="work" points="770,1375 770,1420" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
53
+ <polyline data-edge="true" data-from="focused-check" data-to="step-9" data-kind="work" points="770,1375 770,1420" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
54
+ <polyline data-from="step-9" data-to="step-10" data-kind="work" points="770,1550 770,1640" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
55
+ <polyline data-edge="true" data-from="step-9" data-to="step-10" data-kind="work" points="770,1550 770,1640" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
56
+ <polyline data-from="step-10" data-to="checks" data-kind="work" points="770,1740 770,1757" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
57
+ <polyline data-edge="true" data-from="step-10" data-to="checks" data-kind="work" points="770,1740 770,1757" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
58
+ <polyline data-from="checks" data-to="step-11" data-kind="work" points="770,1843 770,1880" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
59
+ <polyline data-edge="true" data-from="checks" data-to="step-11" data-kind="work" points="770,1843 770,1880" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
60
+ <polyline data-from="step-11" data-to="review" data-kind="work" points="770,1980 770,1997" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
61
+ <polyline data-edge="true" data-from="step-11" data-to="review" data-kind="work" points="770,1980 770,1997" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
62
+ <polyline data-from="review" data-to="step-12" data-kind="work" points="770,2083 770,2190" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
63
+ <polyline data-edge="true" data-from="review" data-to="step-12" data-kind="work" points="770,2083 770,2190" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
64
+ <polyline data-from="step-12" data-to="complete" data-kind="work" points="770,2290 770,2330" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
65
+ <polyline data-edge="true" data-from="step-12" data-to="complete" data-kind="work" points="770,2290 770,2330" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
66
+ <polyline data-from="focused-check" data-to="diagnosis" data-kind="recovery" points="910,1332 1440,1332 1440,1540 1480,1540" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
67
+ <polyline data-edge="true" data-from="focused-check" data-to="diagnosis" data-kind="recovery" points="910,1332 1440,1332 1440,1540 1480,1540" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
68
+ <polyline data-from="checks" data-to="diagnosis" data-kind="recovery" points="910,1800 1440,1800 1440,1540 1480,1540" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
69
+ <polyline data-edge="true" data-from="checks" data-to="diagnosis" data-kind="recovery" points="910,1800 1440,1800 1440,1540 1480,1540" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
70
+ <polyline data-from="review" data-to="diagnosis" data-kind="recovery" points="910,2040 1440,2040 1440,1540 1480,1540" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
71
+ <polyline data-edge="true" data-from="review" data-to="diagnosis" data-kind="recovery" points="910,2040 1440,2040 1440,1540 1480,1540" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
72
+ <polyline data-from="complete" data-to="diagnosis" data-kind="recovery" points="1070,2375 1440,2375 1440,1540 1480,1540" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
73
+ <polyline data-edge="true" data-from="complete" data-to="diagnosis" data-kind="recovery" points="1070,2375 1440,2375 1440,1540 1480,1540" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
74
+ <polyline data-from="diagnosis" data-to="step-8" data-kind="recovery" points="1494,1655 1300,1655 1300,1220 1070,1220" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
75
+ <polyline data-edge="true" data-from="diagnosis" data-to="step-8" data-kind="recovery" points="1494,1655 1300,1655 1300,1220 1070,1220" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
76
+ <polyline data-from="diagnosis" data-to="step-4" data-kind="recovery" points="1494,1755 1380,1755 1380,620 1070,620" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
77
+ <polyline data-edge="true" data-from="diagnosis" data-to="step-4" data-kind="recovery" points="1494,1755 1380,1755 1380,620 1070,620" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
78
+ <polyline data-from="diagnosis" data-to="step-10" data-kind="recovery" points="1494,1915 1220,1915 1220,1690 1070,1690" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
79
+ <polyline data-edge="true" data-from="diagnosis" data-to="step-10" data-kind="recovery" points="1494,1915 1220,1915 1220,1690 1070,1690" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
80
+ <polyline data-from="diagnosis" data-to="step-10" data-kind="recovery" points="1494,2065 1140,2065 1140,1780 995,1780 995,1740" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
81
+ <polyline data-edge="true" data-from="diagnosis" data-to="step-10" data-kind="recovery" points="1494,2065 1140,2065 1140,1780 995,1780 995,1740" fill="none" stroke="#b86b0a" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-recovery)"/>
82
+ <polyline data-from="diagnosis" data-to="record-blocked" data-kind="blocked" points="1705,2230 1705,2380" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
83
+ <polyline data-edge="true" data-from="diagnosis" data-to="record-blocked" data-kind="blocked" points="1705,2230 1705,2380" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
84
+ <polyline data-from="guard" data-to="halted" data-kind="blocked" points="1705,375 1705,425" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
85
+ <polyline data-edge="true" data-from="guard" data-to="halted" data-kind="blocked" points="1705,375 1705,425" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
86
+ <polyline data-from="halted" data-to="record-blocked" data-kind="blocked" points="1930,490 1990,490 1990,2445 1930,2445" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
87
+ <polyline data-edge="true" data-from="halted" data-to="record-blocked" data-kind="blocked" points="1930,490 1990,490 1990,2445 1930,2445" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
88
+ <polyline data-from="complete" data-to="host-gate" data-kind="work" points="770,2420 770,2510" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
89
+ <polyline data-edge="true" data-from="complete" data-to="host-gate" data-kind="work" points="770,2420 770,2510" fill="none" stroke="#197f70" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-work)"/>
90
+ <polyline data-from="record-blocked" data-to="host-gate" data-kind="blocked" points="1705,2470 1705,2510" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
91
+ <polyline data-edge="true" data-from="record-blocked" data-to="host-gate" data-kind="blocked" points="1705,2470 1705,2510" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
92
+ <polyline data-from="host-gate" data-to="ready" data-kind="decision" points="770,2650 770,2730" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
93
+ <polyline data-edge="true" data-from="host-gate" data-to="ready" data-kind="decision" points="770,2650 770,2730" fill="none" stroke="#2b69b0" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-decision)"/>
94
+ <polyline data-from="host-gate" data-to="blocked" data-kind="blocked" points="1705,2650 1705,2730" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
95
+ <polyline data-edge="true" data-from="host-gate" data-to="blocked" data-kind="blocked" points="1705,2650 1705,2730" fill="none" stroke="#b72d4f" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-blocked)"/>
96
+ <polyline data-from="ready" data-to="team" data-kind="decision" points="770,2830 770,2900" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
97
+ <polyline data-edge="true" data-from="ready" data-to="team" data-kind="decision" points="770,2830 770,2900" fill="none" stroke="#2b69b0" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-decision)"/>
98
+ <polyline data-from="team" data-to="publication" data-kind="decision" points="770,3010 770,3070" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
99
+ <polyline data-edge="true" data-from="team" data-to="publication" data-kind="decision" points="770,3010 770,3070" fill="none" stroke="#2b69b0" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-decision)"/>
100
+ <polyline data-from="team" data-to="promote" data-kind="knowledge" points="1705,3010 1705,3070" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
101
+ <polyline data-edge="true" data-from="team" data-to="promote" data-kind="knowledge" points="1705,3010 1705,3070" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" marker-end="url(#arrow-knowledge)"/>
102
+ <polyline data-from="context" data-to="step-3" data-kind="knowledge" points="380,390 410,390 410,480 470,480" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
103
+ <polyline data-edge="true" data-from="context" data-to="step-3" data-kind="knowledge" points="380,390 410,390 410,480 470,480" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
104
+ <polyline data-from="ledger" data-to="step-3" data-kind="knowledge" points="380,705 425,705 425,520 470,520" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
105
+ <polyline data-edge="true" data-from="ledger" data-to="step-3" data-kind="knowledge" points="380,705 425,705 425,520 470,520" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
106
+ <polyline data-from="recipes" data-to="step-2" data-kind="knowledge" points="380,1115 440,1115 440,385 470,385" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
107
+ <polyline data-edge="true" data-from="recipes" data-to="step-2" data-kind="knowledge" points="380,1115 440,1115 440,385 470,385" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
108
+ <polyline data-from="step-8" data-to="ledger" data-kind="knowledge" points="470,1235 405,1235 405,830 380,830" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
109
+ <polyline data-edge="true" data-from="step-8" data-to="ledger" data-kind="knowledge" points="470,1235 405,1235 405,830 380,830" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
110
+ <polyline data-from="step-9" data-to="context" data-kind="knowledge" points="470,1490 390,1490 390,535 380,535" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
111
+ <polyline data-edge="true" data-from="step-9" data-to="context" data-kind="knowledge" points="470,1490 390,1490 390,535 380,535" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
112
+ <polyline data-from="recipes" data-to="step-10" data-kind="knowledge" points="210,1260 210,1690 470,1690" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
113
+ <polyline data-edge="true" data-from="recipes" data-to="step-10" data-kind="knowledge" points="210,1260 210,1690 470,1690" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
114
+ <polyline data-from="promote" data-to="context" data-kind="knowledge" points="1930,3135 1970,3135 1970,3240 20,3240 20,410 40,410" fill="none" stroke="white" stroke-width="8" stroke-linejoin="round"/>
115
+ <polyline data-edge="true" data-from="promote" data-to="context" data-kind="knowledge" points="1930,3135 1970,3135 1970,3240 20,3240 20,410 40,410" fill="none" stroke="#7044b4" stroke-width="3" stroke-linejoin="round" stroke-dasharray="8 6" marker-end="url(#arrow-knowledge)"/>
116
+ <text x="1010" y="75" font-size="64" fill="#16225a" font-weight="800" text-anchor="middle"><tspan x="1010" dy="0">CYC Stack</tspan></text>
117
+ <text x="1010" y="120" font-size="31" fill="#16225a" font-weight="700" text-anchor="middle"><tspan x="1010" dy="0">Engineering, knowledge &amp; evidence flow</tspan></text>
118
+ <text x="1010" y="157" font-size="20" fill="#334362" font-weight="400" text-anchor="middle"><tspan x="1010" dy="0">Common implementation route · 12 responsibilities inside 4 recorded stages</tspan></text>
119
+ <g id="flow-step-1" data-node="step-1">
120
+ <a href="#step-1" aria-label="1. Define observable success — read the step explanation">
121
+ <rect x="470" y="230" width="600" height="90" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
122
+ <text x="492" y="256" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">1. Define observable success</tspan></text>
123
+ <text x="492" y="280" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Record the outcome, constraints and acceptance criteria.</tspan></text>
124
+ <text x="492" y="313" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Scout · Frame when the goal is unclear</tspan></text>
125
+ </a>
126
+ </g>
127
+ <g id="flow-step-2" data-node="step-2">
128
+ <a href="#step-2" aria-label="2. Select route &amp; risk — read the step explanation">
129
+ <rect x="470" y="340" width="600" height="90" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
130
+ <text x="492" y="366" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">2. Select route &amp; risk</tspan></text>
131
+ <text x="492" y="390" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Choose the playbook, checks and review depth.</tspan></text>
132
+ <text x="492" y="423" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Scout · Challenge for high-risk work</tspan></text>
133
+ </a>
134
+ </g>
135
+ <g id="flow-step-3" data-node="step-3">
136
+ <a href="#step-3" aria-label="3. Retrieve matched history — read the step explanation">
137
+ <rect x="470" y="450" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
138
+ <text x="492" y="476" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">3. Retrieve matched history</tspan></text>
139
+ <text x="492" y="500" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Find component decisions and prior failed approaches.</tspan><tspan x="492" dy="22">Carry the relevant constraints into the plan.</tspan></text>
140
+ <text x="492" y="543" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Context · Error Ledger</tspan></text>
141
+ </a>
142
+ </g>
143
+ <g id="flow-step-4" data-node="step-4">
144
+ <a href="#step-4" aria-label="4. Revalidate that history — read the step explanation">
145
+ <rect x="470" y="570" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
146
+ <text x="492" y="596" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">4. Revalidate that history</tspan></text>
147
+ <text x="492" y="620" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Compare recorded claims with current code and changes.</tspan><tspan x="492" dy="22">Replace stale assumptions before relying on them.</tspan></text>
148
+ <text x="492" y="663" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Context · Understand when evidence conflicts</tspan></text>
149
+ </a>
150
+ </g>
151
+ <g id="flow-step-5" data-node="step-5">
152
+ <a href="#step-5" aria-label="5. Trace impact &amp; choose design — read the step explanation">
153
+ <rect x="470" y="690" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
154
+ <text x="492" y="716" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">5. Trace impact &amp; choose design</tspan></text>
155
+ <text x="492" y="740" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Follow writers, readers, state and interface contracts.</tspan><tspan x="492" dy="22">Name affected consumers and a check for each.</tspan></text>
156
+ <text x="492" y="783" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Impact · Design · Understand as needed</tspan></text>
157
+ </a>
158
+ </g>
159
+ <g id="flow-step-6" data-node="step-6">
160
+ <a href="#step-6" aria-label="6. Explain &amp; settle decisions — read the step explanation">
161
+ <rect x="470" y="810" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
162
+ <text x="492" y="836" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">6. Explain &amp; settle decisions</tspan></text>
163
+ <text x="492" y="860" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Connect present behavior to the proposed mechanism.</tspan><tspan x="492" dy="22">Resolve decisions that could change the solution.</tspan></text>
164
+ <text x="492" y="903" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Scout · Teach only for a requested lesson</tspan></text>
165
+ </a>
166
+ </g>
167
+ <g id="flow-step-7" data-node="step-7">
168
+ <a href="#step-7" aria-label="7. Plan evaluable slices — read the step explanation">
169
+ <rect x="470" y="965" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
170
+ <text x="492" y="991" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">7. Plan evaluable slices</tspan></text>
171
+ <text x="492" y="1015" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Give each slice an observable outcome and check.</tspan><tspan x="492" dy="22">High risk: challenge the plan; otherwise proceed.</tspan></text>
172
+ <text x="492" y="1058" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Scout · Challenge for high-risk plans</tspan></text>
173
+ </a>
174
+ </g>
175
+ <g id="flow-step-8" data-node="step-8">
176
+ <a href="#step-8" aria-label="8. Build in tested slices — read the step explanation">
177
+ <rect x="470" y="1170" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
178
+ <text x="492" y="1196" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">8. Build in tested slices</tspan></text>
179
+ <text x="492" y="1220" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Reproduce or pin behavior, implement, inspect the diff.</tspan><tspan x="492" dy="22">Explain the effect on dependent components.</tspan></text>
180
+ <text x="492" y="1263" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Build · Error Ledger when attempts fail</tspan></text>
181
+ </a>
182
+ </g>
183
+ <g id="flow-step-9" data-node="step-9">
184
+ <a href="#step-9" aria-label="9. Retain useful project knowledge — read the step explanation">
185
+ <rect x="470" y="1420" width="600" height="130" rx="12" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
186
+ <text x="492" y="1446" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">9. Retain useful project knowledge</tspan></text>
187
+ <text x="492" y="1470" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Update component docs and index when learning is useful.</tspan><tspan x="492" dy="22">Keep verified facts; label undecided proposals as pending.</tspan><tspan x="492" dy="22">Finalize authorized context and ledger edits before checks.</tspan></text>
188
+ <text x="492" y="1543" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Context · Error Ledger for failure history</tspan></text>
189
+ </a>
190
+ </g>
191
+ <g id="flow-step-10" data-node="step-10">
192
+ <a href="#step-10" aria-label="10. Prove tests &amp; verify behavior — read the step explanation">
193
+ <rect x="470" y="1640" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
194
+ <text x="492" y="1666" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">10. Prove tests &amp; verify behavior</tspan></text>
195
+ <text x="492" y="1690" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Original-code proof where required; run configured checks.</tspan><tspan x="492" dy="22">Exercise affected consumers against stable covered files.</tspan></text>
196
+ <text x="492" y="1733" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Verify</tspan></text>
197
+ </a>
198
+ </g>
199
+ <g id="flow-step-11" data-node="step-11">
200
+ <a href="#step-11" aria-label="11. Review intent &amp; code quality — read the step explanation">
201
+ <rect x="470" y="1880" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
202
+ <text x="492" y="1906" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">11. Review intent &amp; code quality</tspan></text>
203
+ <text x="492" y="1930" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Inspect intent, consumers and project conventions.</tspan><tspan x="492" dy="22">Resolve or dismiss findings with recorded evidence.</tspan></text>
204
+ <text x="492" y="1973" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Verify · Challenge for consequential review</tspan></text>
205
+ </a>
206
+ </g>
207
+ <g id="flow-step-12" data-node="step-12">
208
+ <a href="#step-12" aria-label="12. Account for outcome &amp; learning — read the step explanation">
209
+ <rect x="470" y="2190" width="600" height="100" rx="12" fill="#e6f5ef" stroke="#197f70" stroke-width="2"/>
210
+ <text x="492" y="2216" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">12. Account for outcome &amp; learning</tspan></text>
211
+ <text x="492" y="2240" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Record criteria, limits, learning and ledger disposition.</tspan><tspan x="492" dy="22">Reuse the shared review and explain maintenance.</tspan></text>
212
+ <text x="492" y="2283" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="492" dy="0">Skills: Deliver · Context for retained learning</tspan></text>
213
+ </a>
214
+ </g>
215
+ <g id="flow-decision" data-node="decision"><polygon points="1540,807 1640,860 1540,913 1440,860" fill="#fff0d6" stroke="#b86b0a" stroke-width="2.5"/></g>
216
+ <text x="1540" y="855" font-size="18" fill="#16225a" font-weight="700" text-anchor="middle"><tspan x="1540" dy="0">Decision</tspan><tspan x="1540" dy="23">unresolved?</tspan></text>
217
+ <g id="flow-ask" data-node="ask">
218
+ <rect x="1730" y="810" width="200" height="100" rx="12" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
219
+ <text x="1752" y="844" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1752" dy="0">Get input</tspan></text>
220
+ <text x="1752" y="874" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1752" dy="0">Ask the engineer</tspan><tspan x="1752" dy="25">or investigate.</tspan></text>
221
+ </g>
222
+ <text x="1480" y="1098" font-size="19" fill="#197f70" font-weight="700" text-anchor="start"><tspan x="1480" dy="0">NOTE · SCOUT HANDOFF</tspan></text>
223
+ <text x="1480" y="1128" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1480" dy="0">Settled alignment and named consumers</tspan><tspan x="1480" dy="25">with checks are required to pass.</tspan></text>
224
+ <g id="flow-focused-check" data-node="focused-check"><polygon points="770,1289 910,1332 770,1375 630,1332" fill="#fff0d6" stroke="#b86b0a" stroke-width="2.5"/></g>
225
+ <text x="770" y="1327" font-size="18" fill="#16225a" font-weight="700" text-anchor="middle"><tspan x="770" dy="0">Slice check</tspan><tspan x="770" dy="23">passes?</tspan></text>
226
+ <g id="flow-checks" data-node="checks"><polygon points="770,1757 910,1800 770,1843 630,1800" fill="#fff0d6" stroke="#b86b0a" stroke-width="2.5"/></g>
227
+ <text x="770" y="1795" font-size="18" fill="#16225a" font-weight="700" text-anchor="middle"><tspan x="770" dy="0">Checks pass on</tspan><tspan x="770" dy="23">stable source?</tspan></text>
228
+ <g id="flow-review" data-node="review"><polygon points="770,1997 910,2040 770,2083 630,2040" fill="#fff0d6" stroke="#b86b0a" stroke-width="2.5"/></g>
229
+ <text x="770" y="2035" font-size="18" fill="#16225a" font-weight="700" text-anchor="middle"><tspan x="770" dy="0">No open findings;</tspan><tspan x="770" dy="23">consumers checked?</tspan></text>
230
+ <g id="flow-complete" data-node="complete">
231
+ <rect x="470" y="2330" width="600" height="90" rx="12" fill="white" stroke="#197f70" stroke-width="2"/>
232
+ <text x="492" y="2364" font-size="23" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">Record Deliver → run complete</tspan></text>
233
+ <text x="492" y="2394" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Require current evidence, criteria and artifact checks.</tspan></text>
234
+ </g>
235
+ <text x="1705" y="1525" font-size="25" fill="#16225a" font-weight="800" text-anchor="middle"><tspan x="1705" dy="0">DIAGNOSE &amp; ROUTE</tspan></text>
236
+ <text x="1705" y="1555" font-size="19" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1705" dy="0">What does the evidence invalidate?</tspan></text>
237
+ <g id="flow-route-1600" data-node="route-1600">
238
+ <rect x="1494" y="1600" width="422" height="110" rx="12" fill="white" stroke="#d6a45f" stroke-width="2"/>
239
+ <text x="1516" y="1626" font-size="19" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1516" dy="0">R1 · Implementation defect</tspan></text>
240
+ <text x="1516" y="1650" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1516" dy="0">Design still valid → repair the code.</tspan><tspan x="1516" dy="22">Repeat affected checks and current review.</tspan></text>
241
+ <text x="1516" y="1703" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="1516" dy="0">Skills: Build · Error Ledger</tspan></text>
242
+ </g>
243
+ <g id="flow-route-1730" data-node="route-1730">
244
+ <rect x="1494" y="1730" width="422" height="110" rx="12" fill="white" stroke="#d6a45f" stroke-width="2"/>
245
+ <text x="1516" y="1756" font-size="19" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1516" dy="0">R2 · False premise / missed consumer</tspan></text>
246
+ <text x="1516" y="1780" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1516" dy="0">Revisit context, impact and design.</tspan><tspan x="1516" dy="22">Update the plan and consumer checks.</tspan></text>
247
+ <text x="1516" y="1833" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="1516" dy="0">Skills: Understand · Impact · Design</tspan></text>
248
+ </g>
249
+ <g id="flow-route-1860" data-node="route-1860">
250
+ <rect x="1494" y="1860" width="422" height="110" rx="12" fill="white" stroke="#d6a45f" stroke-width="2"/>
251
+ <text x="1516" y="1886" font-size="19" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1516" dy="0">R3 · Candidate changed after review</tspan></text>
252
+ <text x="1516" y="1910" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1516" dy="0">Old evidence describes different files.</tspan><tspan x="1516" dy="22">Repeat verification AND semantic review.</tspan></text>
253
+ <text x="1516" y="1963" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="1516" dy="0">Skills: Verify</tspan></text>
254
+ </g>
255
+ <g id="flow-route-1990" data-node="route-1990">
256
+ <rect x="1494" y="1990" width="422" height="110" rx="12" fill="white" stroke="#d6a45f" stroke-width="2"/>
257
+ <text x="1516" y="2016" font-size="19" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1516" dy="0">R4 · Check observes the wrong thing</tspan></text>
258
+ <text x="1516" y="2040" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1516" dy="0">Correct an unprotected target or assertion.</tspan><tspan x="1516" dy="22">Protected check / config → new authorized run.</tspan></text>
259
+ <text x="1516" y="2093" font-size="15" fill="#2b69b0" font-weight="600" text-anchor="start"><tspan x="1516" dy="0">Skills: Frame · Verify</tspan></text>
260
+ </g>
261
+ <g id="flow-route-2120" data-node="route-2120">
262
+ <rect x="1494" y="2120" width="422" height="110" rx="12" fill="white" stroke="#d6a45f" stroke-width="2"/>
263
+ <text x="1516" y="2154" font-size="19" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1516" dy="0">Missing prerequisite / exhausted</tspan></text>
264
+ <text x="1516" y="2184" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1516" dy="0">More patches cannot supply missing input.</tspan><tspan x="1516" dy="25">Preserve findings; do not claim completion.</tspan></text>
265
+ </g>
266
+ <g id="flow-record-blocked" data-node="record-blocked">
267
+ <rect x="1480" y="2380" width="450" height="90" rx="12" fill="#ffedf2" stroke="#b72d4f" stroke-width="2"/>
268
+ <text x="1502" y="2414" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1502" dy="0">Disclose the unfinished outcome</tspan></text>
269
+ <text x="1502" y="2444" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1502" dy="0">Blocked, exhausted or halted · retain evidence</tspan></text>
270
+ </g>
271
+ <g id="flow-guard" data-node="guard">
272
+ <rect x="1480" y="240" width="450" height="135" rx="12" fill="#ffedf2" stroke="#b72d4f" stroke-width="2"/>
273
+ <text x="1502" y="274" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1502" dy="0">CONTROLLER GUARD CHECK</tspan></text>
274
+ <text x="1502" y="304" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1502" dy="0">At record, verify, retry, resume and complete:</tspan><tspan x="1502" dy="25">did protected or out-of-scope files change?</tspan><tspan x="1502" dy="25">No: continue the requested operation.</tspan></text>
275
+ </g>
276
+ <g id="flow-halted" data-node="halted">
277
+ <rect x="1480" y="425" width="450" height="135" rx="12" fill="#ffedf2" stroke="#b72d4f" stroke-width="2"/>
278
+ <text x="1502" y="459" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1502" dy="0">HALTED · terminal run</tspan></text>
279
+ <text x="1502" y="489" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1502" dy="0">Preserve the changed files for review; no rollback.</tspan><tspan x="1502" dy="25">Resolve scope / authorization before a new run.</tspan><tspan x="1502" dy="25">The halted run cannot resume.</tspan></text>
280
+ </g>
281
+ <g id="flow-host-gate" data-node="host-gate">
282
+ <rect x="470" y="2510" width="1460" height="140" rx="12" fill="#edf1fa" stroke="#16225a" stroke-width="2"/>
283
+ <text x="492" y="2544" font-size="25" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">HOST DELIVERY GATE · enforced when the hook is active</tspan></text>
284
+ <text x="492" y="2574" font-size="19" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Ready: this session’s relevant touched runs are complete and applicable response checks pass.</tspan><tspan x="492" dy="25">Blocked: disclose the unfinished outcome with current review evidence and applicable native reply checks.</tspan><tspan x="492" dy="25">An actively running unfinished run must continue or be recorded with an appropriate non-running outcome.</tspan></text>
285
+ </g>
286
+ <g id="flow-ready" data-node="ready">
287
+ <rect x="470" y="2730" width="600" height="100" rx="12" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
288
+ <text x="492" y="2764" font-size="23" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">READY · reviewable result</tspan></text>
289
+ <text x="492" y="2794" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Show the candidate, evidence, reasoning and limits.</tspan></text>
290
+ </g>
291
+ <g id="flow-blocked" data-node="blocked">
292
+ <rect x="1480" y="2730" width="450" height="130" rx="12" fill="#ffedf2" stroke="#b72d4f" stroke-width="2"/>
293
+ <text x="1502" y="2764" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1502" dy="0">BLOCKED · explain what remains</tspan></text>
294
+ <text x="1502" y="2794" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1502" dy="0">No completion claim or publication path.</tspan><tspan x="1502" dy="25">Blocked run: may resume after resolving input.</tspan><tspan x="1502" dy="25">Exhausted / halted: new run; fresh evidence.</tspan></text>
295
+ </g>
296
+ <g id="flow-team" data-node="team">
297
+ <rect x="470" y="2900" width="1460" height="110" rx="12" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
298
+ <text x="492" y="2934" font-size="25" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">Developer / team review · project-controlled follow-through</tspan></text>
299
+ <text x="492" y="2964" font-size="19" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Review the actual change and its evidence. Completion is not human acceptance or permission to publish.</tspan><tspan x="492" dy="25">Publication and acceptance of a pending finding are separate decisions.</tspan></text>
300
+ </g>
301
+ <g id="flow-publication" data-node="publication">
302
+ <rect x="470" y="3070" width="600" height="110" rx="12" fill="#eaf3ff" stroke="#2b69b0" stroke-width="2"/>
303
+ <text x="492" y="3104" font-size="23" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="492" dy="0">Authorized PR → review → merge</tspan></text>
304
+ <text x="492" y="3134" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="492" dy="0">Reuse the generated review; satisfy project rules.</tspan><tspan x="492" dy="25">Requested revisions after completion use a new run.</tspan></text>
305
+ </g>
306
+ <g id="flow-promote" data-node="promote">
307
+ <rect x="1480" y="3070" width="450" height="130" rx="12" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
308
+ <text x="1502" y="3104" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="1502" dy="0">Promote accepted pending learning</tspan></text>
309
+ <text x="1502" y="3134" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="1502" dy="0">Only if a pending finding exists and is accepted.</tspan><tspan x="1502" dy="25">Separately reviewed documentation update.</tspan><tspan x="1502" dy="25">Merge is not a prerequisite.</tspan></text>
310
+ </g>
311
+ <g id="flow-context" data-node="context">
312
+ <rect x="40" y="230" width="340" height="330" rx="12" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
313
+ <text x="62" y="264" font-size="20" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="62" dy="0">COMPONENT CONTEXT DOCS</tspan></text>
314
+ <text x="62" y="294" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="62" dy="0">docs/context/&lt;area&gt;.md</tspan><tspan x="62" dy="25">docs/context/INDEX.md</tspan><tspan x="62" dy="25">One document per component or area.</tspan><tspan x="62" dy="25">Decisions, dead ends and gotchas</tspan><tspan x="62" dy="25">Paths, revision and check evidence</tspan><tspan x="62" dy="25">Update at 9 when useful; index by path.</tspan><tspan x="62" dy="25">Read at 3; revalidate at 4.</tspan><tspan x="62" dy="25">Retain verified technical facts.</tspan><tspan x="62" dy="25">Adopt decisions with acceptance.</tspan></text>
315
+ </g>
316
+ <g id="flow-ledger" data-node="ledger">
317
+ <rect x="40" y="620" width="340" height="280" rx="12" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
318
+ <text x="62" y="654" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="62" dy="0">ERROR TRIAGE LEDGER</tspan></text>
319
+ <text x="62" y="684" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="62" dy="0">Error signatures, attempts and results</tspan><tspan x="62" dy="25">Confirmed causes; regression guards</tspan><tspan x="62" dy="25"></tspan><tspan x="62" dy="25">Read at 3. Record attempts during</tspan><tspan x="62" dy="25">implementation AND recovery.</tspan><tspan x="62" dy="25">Required at delivery for bug-fix runs</tspan><tspan x="62" dy="25">or any run with recorded failures.</tspan></text>
320
+ </g>
321
+ <g id="flow-recipes" data-node="recipes">
322
+ <rect x="40" y="1030" width="340" height="230" rx="12" fill="#f5effc" stroke="#7044b4" stroke-width="2"/>
323
+ <text x="62" y="1064" font-size="22" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="62" dy="0">PLAYBOOKS &amp; RECIPES</tspan></text>
324
+ <text x="62" y="1094" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="62" dy="0">Choose how to investigate and build.</tspan><tspan x="62" dy="25">Exercise the actual user behavior.</tspan><tspan x="62" dy="25"></tspan><tspan x="62" dy="25">Select the route at 2.</tspan><tspan x="62" dy="25">Use the relevant checks at 10.</tspan></text>
325
+ </g>
326
+ <g id="flow-budget-note" data-node="budget-note">
327
+ <rect x="40" y="1810" width="340" height="320" rx="12" fill="#fff0d6" stroke="#b86b0a" stroke-width="2"/>
328
+ <text x="62" y="1844" font-size="20" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="62" dy="0">WHY THE LOOP IS BOUNDED</tspan></text>
329
+ <text x="62" y="1874" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="62" dy="0">Configurable defaults:</tspan><tspan x="62" dy="25">3 recorded failures; stop earlier at</tspan><tspan x="62" dy="25">2 consecutive identical signatures.</tspan><tspan x="62" dy="25"></tspan><tspan x="62" dy="25">A recorded rewind invalidates</tspan><tspan x="62" dy="25">dependent later handoffs and</tspan><tspan x="62" dy="25">executable verification.</tspan><tspan x="62" dy="25">Returning never resets the budget.</tspan><tspan x="62" dy="25">Unreported attempts are not visible.</tspan></text>
330
+ </g>
331
+ <g id="flow-trust-note" data-node="trust-note">
332
+ <rect x="40" y="2210" width="340" height="340" rx="12" fill="#f3f6fa" stroke="#ced9e5" stroke-width="2"/>
333
+ <text x="62" y="2244" font-size="20" fill="#16225a" font-weight="700" text-anchor="start"><tspan x="62" dy="0">WHAT THE TEAM CAN INSPECT</tspan></text>
334
+ <text x="62" y="2274" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="62" dy="0">Criterion and consumer results</tspan><tspan x="62" dy="25">Command receipts and file fingerprints</tspan><tspan x="62" dy="25">Review findings and resolution evidence</tspan><tspan x="62" dy="25">Retry history and retained reasoning</tspan><tspan x="62" dy="25">Local by default; share through review.</tspan><tspan x="62" dy="25"></tspan><tspan x="62" dy="25">The controller validates records and</tspan><tspan x="62" dy="25">current covered files. It cannot prove</tspan><tspan x="62" dy="25">that tests are meaningful or an</tspan><tspan x="62" dy="25">agent’s judgment is correct.</tspan></text>
335
+ </g>
336
+ <text x="470" y="3290" font-size="19" fill="#16225a" font-weight="600" text-anchor="start"><tspan x="470" dy="0">A completed run is terminal. Later requested revisions start a new scoped run with fresh evidence.</tspan></text>
337
+ <text x="40" y="3320" font-size="17" fill="#334362" font-weight="400" text-anchor="start"><tspan x="40" dy="0">Ordinary path: run start records Scout; run finish batches Build recording, proof, checks, Verify, Deliver and completion.</tspan></text>
338
+ <text x="1110" y="2450" font-size="16" fill="#b86b0a" font-weight="400" text-anchor="start"><tspan x="1110" dy="0">R1–R4: match source cards to return arrows.</tspan><tspan x="1110" dy="25">Dots join paths; other crossings stay separate.</tspan></text>
339
+ <text x="40" y="3350" font-size="19" fill="#334362" font-weight="400" text-anchor="start"><tspan x="40" dy="0">Arrows: teal = forward work · amber = recovery · blue = developer decisions · red = unfinished outcome</tspan></text>
340
+ <text x="40" y="3383" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="40" dy="0">Dashed purple = knowledge read / write. The 12 responsibilities are not separate runtime states. Other playbooks have their own sequences.</tspan></text>
341
+ <text x="40" y="3416" font-size="18" fill="#334362" font-weight="400" text-anchor="start"><tspan x="40" dy="0">Skills = CYC methods selected as needed, not automatic dispatch. Click a numbered step for its trigger, worked example and expected evidence.</tspan></text>
342
+ <rect x="1662.975" y="823" width="44.05" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
343
+ <text x="1685" y="843" font-size="17" fill="#2b69b0" font-weight="600" text-anchor="middle"><tspan x="1685" dy="0">Yes</tspan></text>
344
+ <rect x="1542.65" y="937" width="34.7" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
345
+ <text x="1560" y="957" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="1560" dy="0">No</tspan></text>
346
+ <rect x="1471.75" y="701" width="296.5" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
347
+ <text x="1620" y="721" font-size="17" fill="#2b69b0" font-weight="600" text-anchor="middle"><tspan x="1620" dy="0">Resolved: revisit the approach</tspan></text>
348
+ <g transform="rotate(-90 1948 1260)">
349
+ <rect x="1825.6" y="1241" width="244.8" height="26" rx="4" fill="white" stroke="none" stroke-width="2"/>
350
+ <text x="1948" y="1260" font-size="16" fill="#b72d4f" font-weight="600" text-anchor="middle"><tspan x="1948" dy="0">Required input unavailable</tspan></text>
351
+ </g>
352
+ <rect x="800.9" y="1127" width="128.2" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
353
+ <text x="865" y="1147" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="865" dy="0">Record Scout</tspan></text>
354
+ <rect x="635.775" y="1382" width="268.45000000000005" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
355
+ <text x="770" y="1402" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="770" dy="0">Yes · finish planned slices</tspan></text>
356
+ <rect x="795.9" y="1561" width="128.2" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
357
+ <text x="860" y="1581" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="860" dy="0">Record Build</tspan></text>
358
+ <rect x="797.975" y="1845" width="44.05" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
359
+ <text x="820" y="1865" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="820" dy="0">Yes</tspan></text>
360
+ <rect x="778.175" y="2109" width="193.65" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
361
+ <text x="875" y="2129" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="875" dy="0">Yes · record Verify</tspan></text>
362
+ <rect x="940.65" y="1298" width="34.7" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
363
+ <text x="958" y="1318" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="958" dy="0">No</tspan></text>
364
+ <rect x="940.65" y="1766" width="34.7" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
365
+ <text x="958" y="1786" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="958" dy="0">No</tspan></text>
366
+ <rect x="940.65" y="2006" width="34.7" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
367
+ <text x="958" y="2026" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="958" dy="0">No</tspan></text>
368
+ <circle cx="1440" cy="1332" r="5" fill="#b86b0a"/>
369
+ <circle cx="1440" cy="1540" r="5" fill="#b86b0a"/>
370
+ <circle cx="1440" cy="1800" r="5" fill="#b86b0a"/>
371
+ <circle cx="1440" cy="2040" r="5" fill="#b86b0a"/>
372
+ <circle cx="1440" cy="2375" r="5" fill="#b86b0a"/>
373
+ <rect x="1187.2" y="2338" width="165.60000000000002" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
374
+ <text x="1270" y="2358" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1270" dy="0">Rejected / stale</tspan></text>
375
+ <rect x="1107.2" y="1181" width="165.60000000000002" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
376
+ <text x="1190" y="1201" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1190" dy="0">R1 · Repair code</tspan></text>
377
+ <rect x="1123.5" y="581" width="203.00000000000003" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
378
+ <text x="1225" y="601" font-size="17" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1225" dy="0">R2 · Revisit premise</tspan></text>
379
+ <rect x="1075.4" y="1653" width="139.20000000000002" height="26" rx="4" fill="white" stroke="none" stroke-width="2"/>
380
+ <text x="1145" y="1672" font-size="16" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1145" dy="0">R3 · Re-verify</tspan></text>
381
+ <rect x="998.4" y="1747" width="139.20000000000002" height="26" rx="4" fill="white" stroke="none" stroke-width="2"/>
382
+ <text x="1068" y="1766" font-size="16" fill="#b86b0a" font-weight="600" text-anchor="middle"><tspan x="1068" dy="0">R4 · Fix check</tspan></text>
383
+ <rect x="1594.15" y="2307" width="221.70000000000002" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
384
+ <text x="1705" y="2327" font-size="17" fill="#b72d4f" font-weight="600" text-anchor="middle"><tspan x="1705" dy="0">Record status + reason</tspan></text>
385
+ <rect x="1584.8" y="383" width="240.4" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
386
+ <text x="1705" y="403" font-size="17" fill="#b72d4f" font-weight="600" text-anchor="middle"><tspan x="1705" dy="0">Yes · guard records halt</tspan></text>
387
+ <g transform="rotate(-90 1983 1800)">
388
+ <rect x="1829.8" y="1781" width="306.40000000000003" height="26" rx="4" fill="white" stroke="none" stroke-width="2"/>
389
+ <text x="1983" y="1800" font-size="16" fill="#b72d4f" font-weight="600" text-anchor="middle"><tspan x="1983" dy="0">Halt → disclose preserved changes</tspan></text>
390
+ </g>
391
+ <rect x="673.175" y="2460" width="193.65" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
392
+ <text x="770" y="2480" font-size="17" fill="#197f70" font-weight="600" text-anchor="middle"><tspan x="770" dy="0">Completion succeeds</tspan></text>
393
+ <rect x="781.625" y="2672" width="62.75000000000001" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
394
+ <text x="813" y="2692" font-size="17" fill="#2b69b0" font-weight="600" text-anchor="middle"><tspan x="813" dy="0">Ready</tspan></text>
395
+ <rect x="1719.275" y="2672" width="81.45" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
396
+ <text x="1760" y="2692" font-size="17" fill="#b72d4f" font-weight="600" text-anchor="middle"><tspan x="1760" dy="0">Blocked</tspan></text>
397
+ <rect x="691.875" y="3029" width="156.25" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
398
+ <text x="770" y="3049" font-size="17" fill="#2b69b0" font-weight="600" text-anchor="middle"><tspan x="770" dy="0">When authorized</tspan></text>
399
+ <rect x="1584.8" y="3029" width="240.4" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
400
+ <text x="1705" y="3049" font-size="17" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="1705" dy="0">Pending finding accepted</tspan></text>
401
+ <rect x="415.7" y="453" width="44.6" height="23" rx="4" fill="white" stroke="none" stroke-width="2"/>
402
+ <text x="438" y="469" font-size="13" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="438" dy="0">Read</tspan></text>
403
+ <rect x="419.7" y="495" width="44.6" height="23" rx="4" fill="white" stroke="none" stroke-width="2"/>
404
+ <text x="442" y="511" font-size="13" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="442" dy="0">Read</tspan></text>
405
+ <rect x="401.55" y="356" width="58.900000000000006" height="23" rx="4" fill="white" stroke="none" stroke-width="2"/>
406
+ <text x="431" y="372" font-size="13" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="431" dy="0">Select</tspan></text>
407
+ <rect x="381.4" y="1206" width="87.2" height="22" rx="4" fill="white" stroke="none" stroke-width="2"/>
408
+ <text x="425" y="1221" font-size="12" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="425" dy="0">Log attempts</tspan></text>
409
+ <rect x="360.525" y="1460" width="108.95" height="23" rx="4" fill="white" stroke="none" stroke-width="2"/>
410
+ <text x="415" y="1476" font-size="13" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="415" dy="0">Write + index</tspan></text>
411
+ <rect x="251.225" y="1654" width="137.55" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
412
+ <text x="320" y="1674" font-size="17" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="320" dy="0">Check recipes</tspan></text>
413
+ <rect x="655.8499999999999" y="3202" width="558.3000000000001" height="27" rx="4" fill="white" stroke="none" stroke-width="2"/>
414
+ <text x="935" y="3222" font-size="17" fill="#7044b4" font-weight="600" text-anchor="middle"><tspan x="935" dy="0">Next task retrieves and revalidates the retained knowledge</tspan></text>
415
+ </svg>
@@ -0,0 +1,42 @@
1
+ # Architecture and code review decisions
2
+
3
+ Use this guide when a change affects shared state, an interface or a meaningful failure path. Apply it to the actual diff and callers; it does not add another controller stage. [Engineering principles](principles.md) describe the overall review responsibilities.
4
+
5
+ ## Choose a structure that protects the contract
6
+
7
+ Begin with one legitimate caller: what can it supply, what does it expect and which result must remain consistent? Trace the authoritative state, the operation that changes it, stored representations and downstream readers. Include configuration or registered callbacks when they connect behavior outside direct imports.
8
+
9
+ | Question | Evidence to examine |
10
+ | --- | --- |
11
+ | Where is a shared rule enforced? | The actual writers and the paths that can bypass or repeat the rule |
12
+ | Can callers observe inconsistent state? | The transition, related updates, old records and a relevant interruption or retry |
13
+ | What decision belongs behind this interface? | Which details a caller must currently coordinate, and which consumer needs those details |
14
+ | What changes together when requirements change? | Repeated policy, synchronized declarations and the callers that depend on them |
15
+ | Does an existing component already serve this task? | Its contract, current consumers and the specific missing behavior |
16
+
17
+ Keep a suitable project pattern. Compare a different design only when uncertainty could materially affect correctness, ownership or maintenance. Explain the trade-off through a concrete operation. A component's size or number of callers is a reason to investigate its responsibility, not sufficient evidence to delete it.
18
+
19
+ Use the relevant worked guide for the decision:
20
+
21
+ - [Code standards](engineering/code-standards.md) for comments, types, component structure and error interpretation.
22
+ - [Domain design](engineering/domain-design.md) for invariants, transitions and several readers or writers.
23
+ - [Failure handling](engineering/failure-handling.md) for rejection, partial effects and retry behavior.
24
+
25
+ For a small local change, state the fitting existing pattern and the check that protects it. Do not create an abstraction or comparison exercise solely to fill an assessment.
26
+
27
+ ## Review findings before turning them into edits
28
+
29
+ A useful finding identifies the location, legitimate trigger or plausible maintenance change, consequence and supporting evidence. Reproduce a suspected runtime failure when practical. For a structural concern, show the repeated policy or caller coordination that makes the next change difficult. Label an untested hypothesis.
30
+
31
+ Choose a disposition based on that evidence:
32
+
33
+ | Disposition | What must be recorded |
34
+ | --- | --- |
35
+ | Repair within scope | The observed defect, correction and check of the affected behavior |
36
+ | Investigate before accepting | The unresolved consequential question and the evidence needed to settle it |
37
+ | Keep outside this change | Why the improvement is useful but unnecessary for the current task |
38
+ | Dismiss | The caller or contract evidence showing that the concern does not apply |
39
+
40
+ Review the repair itself. Confirm that consumers still satisfy their contracts and that an error or compatibility path was not removed merely to simplify the diff. Keep required unresolved findings open. A successful review may find no actionable issue; a passing test suite does not establish every architectural judgment.
41
+
42
+ In a managed implementation run, record this reasoning in the Verify assessment alongside each named consumer's executed checks. Distinguish self-review, another agent's review and human acceptance. If a repair changes covered source, refresh the affected verification before completion.