coentrify 0.0.2 → 0.1.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 (261) hide show
  1. package/LICENSE +18 -0
  2. package/README.md +2 -1
  3. package/bin/coentrify.js +79 -12
  4. package/package.json +3 -2
  5. package/src/changelog/0.0.1.md +259 -0
  6. package/src/changelog/0.0.2.md +219 -0
  7. package/src/changelog/0.0.3.md +81 -0
  8. package/src/changelog/0.0.4.md +198 -0
  9. package/src/changelog/0.0.5.md +160 -0
  10. package/src/changelog/0.0.6.md +282 -0
  11. package/src/changelog/0.0.7.md +113 -0
  12. package/src/changelog/0.0.8.md +212 -0
  13. package/src/changelog/0.1.0.md +9 -0
  14. package/src/changelog/overview.md +13 -0
  15. package/src/coentrify-json.md +72 -0
  16. package/src/commands.md +48 -0
  17. package/src/glossary.md +132 -0
  18. package/src/how-it-works.md +51 -0
  19. package/src/onboarding.md +140 -0
  20. package/src/origin.md +19 -0
  21. package/src/philosophy.md +99 -0
  22. package/src/proof.md +596 -0
  23. package/src/readme.md +76 -0
  24. package/src/recommendations.md +100 -0
  25. package/src/standards/ai/match-known-commands-deterministically-classify-the-rest.md +22 -0
  26. package/src/standards/ai/overview.md +6 -0
  27. package/src/standards/ai/prompt-small-models-differently.md +21 -0
  28. package/src/standards/angular/canmatch-wildcard-for-route-access.md +22 -0
  29. package/src/standards/angular/interface-not-abstract-class-for-mock-swap.md +37 -0
  30. package/src/standards/angular/no-any-in-templates.md +25 -0
  31. package/src/standards/angular/no-inline-templates.md +14 -0
  32. package/src/standards/angular/one-component-per-folder-flat.md +12 -0
  33. package/src/standards/angular/one-projected-node-per-control-flow-block.md +19 -0
  34. package/src/standards/angular/overview.md +16 -0
  35. package/src/standards/angular/prefer-content-projection-over-props-angular.md +17 -0
  36. package/src/standards/angular/projected-content-is-never-styled-by-the-host.md +23 -0
  37. package/src/standards/angular/static-attribute-not-literal-binding.md +23 -0
  38. package/src/standards/angular/track-timed-items-by-an-id.md +17 -0
  39. package/src/standards/angular/ui-copy-in-template.md +26 -0
  40. package/src/standards/angular/use-modern-angular-template-apis.md +20 -0
  41. package/src/standards/architecture/adopt-configure-override.md +25 -0
  42. package/src/standards/architecture/app-shield.md +57 -0
  43. package/src/standards/architecture/converge-only-once-proven.md +22 -0
  44. package/src/standards/architecture/folder-concerns.md +28 -0
  45. package/src/standards/architecture/overview.md +11 -0
  46. package/src/standards/architecture/per-application-split-over-shared-branching.md +25 -0
  47. package/src/standards/architecture/separation-before-layer-standards.md +17 -0
  48. package/src/standards/architecture/unique-where-it-counts.md +19 -0
  49. package/src/standards/behavior/a-go-before-work-elsewhere.md +17 -0
  50. package/src/standards/behavior/a-maybe-is-a-trigger-to-investigate.md +20 -0
  51. package/src/standards/behavior/a-name-describes-its-unit.md +19 -0
  52. package/src/standards/behavior/a-quiet-tree-while-a-suite-runs.md +19 -0
  53. package/src/standards/behavior/always-make-no-mistakes.md +45 -0
  54. package/src/standards/behavior/always-verify-before-reporting-done.md +18 -0
  55. package/src/standards/behavior/always-work-from-a-plan.md +29 -0
  56. package/src/standards/behavior/anchor-edits-after-formatting.md +17 -0
  57. package/src/standards/behavior/backward-trace-missing-prerequisites.md +20 -0
  58. package/src/standards/behavior/code-review-compounds-into-patterns-and-sweeps.md +21 -0
  59. package/src/standards/behavior/communication-boundary.md +18 -0
  60. package/src/standards/behavior/dev-tiers.md +25 -0
  61. package/src/standards/behavior/docs-hold-only-what-the-director-decided.md +23 -0
  62. package/src/standards/behavior/dont-filter-data-without-a-spec.md +20 -0
  63. package/src/standards/behavior/dont-introduce-tech-debt.md +25 -0
  64. package/src/standards/behavior/feature-workflow.md +31 -0
  65. package/src/standards/behavior/file-a-change-with-coentrify.md +24 -0
  66. package/src/standards/behavior/flag-every-addition-of-your-own.md +22 -0
  67. package/src/standards/behavior/free-text-replies-no-buttons.md +20 -0
  68. package/src/standards/behavior/general-working-rules.md +37 -0
  69. package/src/standards/behavior/non-destructive-documenting-and-test-automation.md +20 -0
  70. package/src/standards/behavior/normal-dashes.md +15 -0
  71. package/src/standards/behavior/note-issues.md +26 -0
  72. package/src/standards/behavior/overview.md +46 -0
  73. package/src/standards/behavior/own-ports-own-processes.md +37 -0
  74. package/src/standards/behavior/project-lifecycle.md +21 -0
  75. package/src/standards/behavior/propagate-renames-and-convention-changes-everywhere.md +16 -0
  76. package/src/standards/behavior/prose-style.md +24 -0
  77. package/src/standards/behavior/prototype-mode-is-speed-first.md +20 -0
  78. package/src/standards/behavior/regular-layered-gap-analysis.md +20 -0
  79. package/src/standards/behavior/reload-the-standards-after-compacting.md +16 -0
  80. package/src/standards/behavior/review-changes-before-reporting-done.md +17 -0
  81. package/src/standards/behavior/review-every-capture-before-reporting.md +21 -0
  82. package/src/standards/behavior/standards-maintenance.md +65 -0
  83. package/src/standards/behavior/standards-over-skills.md +17 -0
  84. package/src/standards/behavior/sweeps-enumerate-into-tech-debt-first.md +20 -0
  85. package/src/standards/behavior/sync-the-docs-after-every-change.md +20 -0
  86. package/src/standards/behavior/the-quality-of-the-question.md +17 -0
  87. package/src/standards/behavior/things-of-one-kind-are-consistent.md +20 -0
  88. package/src/standards/behavior/understand-the-need.md +69 -0
  89. package/src/standards/behavior/use-us-english-everywhere.md +17 -0
  90. package/src/standards/behavior/verify-apis-against-docs-and-the-installed-artifact.md +17 -0
  91. package/src/standards/behavior/verify-control-before-rename.md +11 -0
  92. package/src/standards/code/code-principles.md +32 -0
  93. package/src/standards/code/escape-hatch-comments.md +20 -0
  94. package/src/standards/code/name-by-concept-not-copy.md +20 -0
  95. package/src/standards/code/no-abbreviated-names.md +20 -0
  96. package/src/standards/code/no-describe-what-comments.md +26 -0
  97. package/src/standards/code/overview.md +10 -0
  98. package/src/standards/code/pre-empt-recurring-code-review-nits.md +31 -0
  99. package/src/standards/commits/commits.md +44 -0
  100. package/src/standards/commits/gate-commits-on-exit-codes.md +22 -0
  101. package/src/standards/commits/main-stays-green-work-stays-clean.md +23 -0
  102. package/src/standards/commits/overview.md +8 -0
  103. package/src/standards/commits/verify-staging-before-committing.md +29 -0
  104. package/src/standards/docs/application-template.md +89 -0
  105. package/src/standards/docs/docs-are-hierarchical-explicit-and-short.md +48 -0
  106. package/src/standards/docs/docs-describe-behavior-not-wiring.md +24 -0
  107. package/src/standards/docs/docs-folder-structure.md +38 -0
  108. package/src/standards/docs/docs-state-knowledge.md +23 -0
  109. package/src/standards/docs/documentation-philosophy.md +62 -0
  110. package/src/standards/docs/feature-spec-template.md +89 -0
  111. package/src/standards/docs/feature-template.md +62 -0
  112. package/src/standards/docs/file-names.md +20 -0
  113. package/src/standards/docs/glossary.md +18 -0
  114. package/src/standards/docs/library-feedback.md +20 -0
  115. package/src/standards/docs/no-faux-headers-in-lists.md +18 -0
  116. package/src/standards/docs/overview.md +20 -0
  117. package/src/standards/docs/ui-vocabulary.md +31 -0
  118. package/src/standards/docs/workspace-levels.md +24 -0
  119. package/src/standards/docs/workspace-suite.md +24 -0
  120. package/src/standards/docs/workspace-template.md +41 -0
  121. package/src/standards/e2e/e2e-assert-before-interacting.md +21 -0
  122. package/src/standards/e2e/e2e-mock-contract.md +20 -0
  123. package/src/standards/e2e/e2e-runs-on-the-development-build.md +18 -0
  124. package/src/standards/e2e/e2e-test-conventions.md +61 -0
  125. package/src/standards/e2e/e2e-tests-must-demonstrate-behavior.md +28 -0
  126. package/src/standards/e2e/one-check-for-many-canvas-clicks.md +17 -0
  127. package/src/standards/e2e/overview.md +14 -0
  128. package/src/standards/e2e/per-feature-overview-test.md +30 -0
  129. package/src/standards/e2e/real-input-for-frame-races.md +25 -0
  130. package/src/standards/e2e/substring-locator-collisions.md +23 -0
  131. package/src/standards/e2e/use-the-e2e-pipeline-for-browser-probing.md +18 -0
  132. package/src/standards/electron/electron-packaging-and-suite.md +22 -0
  133. package/src/standards/electron/electron-shell-shape.md +21 -0
  134. package/src/standards/electron/overview.md +6 -0
  135. package/src/standards/gamedev/2d-visual-design.md +22 -0
  136. package/src/standards/gamedev/budget-exceptions.json +6 -0
  137. package/src/standards/gamedev/captures-and-reels.md +39 -0
  138. package/src/standards/gamedev/devbox.md +21 -0
  139. package/src/standards/gamedev/game-design-laws-experience.md +68 -0
  140. package/src/standards/gamedev/game-design-laws-guidance.md +43 -0
  141. package/src/standards/gamedev/game-design-laws-own-style.md +33 -0
  142. package/src/standards/gamedev/game-design-laws-progress.md +54 -0
  143. package/src/standards/gamedev/game-design-laws-quality.md +30 -0
  144. package/src/standards/gamedev/game-design-laws-story.md +45 -0
  145. package/src/standards/gamedev/game-design-laws-ui.md +52 -0
  146. package/src/standards/gamedev/game-design-laws-world.md +38 -0
  147. package/src/standards/gamedev/game-design-laws.md +112 -0
  148. package/src/standards/gamedev/game-phases-concept.md +29 -0
  149. package/src/standards/gamedev/game-phases-design.md +39 -0
  150. package/src/standards/gamedev/game-phases-development.md +30 -0
  151. package/src/standards/gamedev/game-phases-live.md +19 -0
  152. package/src/standards/gamedev/game-phases.md +52 -0
  153. package/src/standards/gamedev/game-work-workflow.md +47 -0
  154. package/src/standards/gamedev/gamedev-working-cadence.md +52 -0
  155. package/src/standards/gamedev/incremental-pacing.md +22 -0
  156. package/src/standards/gamedev/launch-strategy.md +50 -0
  157. package/src/standards/gamedev/measure-sound-never-guess.md +24 -0
  158. package/src/standards/gamedev/overview.md +29 -0
  159. package/src/standards/gamedev/own-icons.md +19 -0
  160. package/src/standards/gamedev/silent-runs.md +26 -0
  161. package/src/standards/gamedev/sprite-sheet-frames.md +23 -0
  162. package/src/standards/overview.md +43 -0
  163. package/src/standards/records/activity-log.md +33 -0
  164. package/src/standards/records/changelog-per-version.md +43 -0
  165. package/src/standards/records/healing-log.md +23 -0
  166. package/src/standards/records/overview.md +10 -0
  167. package/src/standards/records/playtest-files.md +38 -0
  168. package/src/standards/records/request-log.md +30 -0
  169. package/src/standards/records/user-test-files.md +21 -0
  170. package/src/standards/reporting/change-report.md +43 -0
  171. package/src/standards/reporting/overview.md +6 -0
  172. package/src/standards/reporting/reels-and-video-proof.md +32 -0
  173. package/src/standards/scripts/no-npx-in-scripts.md +20 -0
  174. package/src/standards/scripts/npm-script-naming.md +43 -0
  175. package/src/standards/scripts/overview.md +7 -0
  176. package/src/standards/scripts/thin-wrappers-in-ci-and-hooks.md +25 -0
  177. package/src/standards/security/keep-personal-data-out-of-requests.md +16 -0
  178. package/src/standards/security/keep-secrets-away-from-agents.md +21 -0
  179. package/src/standards/security/never-access-the-keychain.md +16 -0
  180. package/src/standards/security/overview.md +7 -0
  181. package/src/standards/simple-workflow/bugs-template.md +38 -0
  182. package/src/standards/simple-workflow/overview.md +12 -0
  183. package/src/standards/simple-workflow/plan-template.md +50 -0
  184. package/src/standards/simple-workflow/plans-vs-persistent-files.md +31 -0
  185. package/src/standards/simple-workflow/remove-completed-items-from-docs.md +19 -0
  186. package/src/standards/simple-workflow/roadmap-template.md +41 -0
  187. package/src/standards/simple-workflow/technical-debt-template.md +44 -0
  188. package/src/standards/simple-workflow/the-simple-workflow.md +48 -0
  189. package/src/standards/simple-workflow/todo-template.md +31 -0
  190. package/src/standards/tests/a-bugs-test-reproduces-with-real-input.md +18 -0
  191. package/src/standards/tests/bracket-state-changes-with-contrast-assertions.md +37 -0
  192. package/src/standards/tests/gestures-in-tests.md +35 -0
  193. package/src/standards/tests/implementation-agnostic-assertions.md +20 -0
  194. package/src/standards/tests/implementation-agnostic-locators.md +18 -0
  195. package/src/standards/tests/overview.md +13 -0
  196. package/src/standards/tests/realistic-test-data-variance.md +24 -0
  197. package/src/standards/tests/seed-surfaces-every-state-on-page-1.md +17 -0
  198. package/src/standards/tests/test-design.md +47 -0
  199. package/src/standards/tests/test-the-system-behind-a-mock.md +21 -0
  200. package/src/standards/tickets-workflow/agent-roles.md +54 -0
  201. package/src/standards/tickets-workflow/budget-exceptions.json +6 -0
  202. package/src/standards/tickets-workflow/building-a-ticket.md +47 -0
  203. package/src/standards/tickets-workflow/overview.md +15 -0
  204. package/src/standards/tickets-workflow/stabilize-before-adding.md +18 -0
  205. package/src/standards/tickets-workflow/the-builder.md +28 -0
  206. package/src/standards/tickets-workflow/the-conductor.md +44 -0
  207. package/src/standards/tickets-workflow/the-done-part.md +23 -0
  208. package/src/standards/tickets-workflow/ticket-template.md +96 -0
  209. package/src/standards/tickets-workflow/work-item-names.md +30 -0
  210. package/src/standards/tickets-workflow/work-tracking.md +177 -0
  211. package/src/standards/tickets-workflow/work-workflow.md +123 -0
  212. package/src/standards/tickets-workflow/writing-a-ticket.md +50 -0
  213. package/src/standards/tooling/browser-captures-go-to-disk.md +20 -0
  214. package/src/standards/tooling/check-where-a-pane-click-landed.md +19 -0
  215. package/src/standards/tooling/defer-tooling-until-the-cost-shows-up.md +19 -0
  216. package/src/standards/tooling/develop-against-mocks.md +19 -0
  217. package/src/standards/tooling/hygiene-tests-run-on-their-own-runner.md +18 -0
  218. package/src/standards/tooling/lightweight-test-reporting-only.md +16 -0
  219. package/src/standards/tooling/node-versions.md +24 -0
  220. package/src/standards/tooling/overview.md +17 -0
  221. package/src/standards/tooling/parallel-agents.md +45 -0
  222. package/src/standards/tooling/playwright-parallel-runs.md +30 -0
  223. package/src/standards/tooling/playwright-video-recording.md +32 -0
  224. package/src/standards/tooling/read-before-you-truncate.md +19 -0
  225. package/src/standards/tooling/start-playwright-on-a-clean-port.md +22 -0
  226. package/src/standards/tooling/vitepress-wiki.md +38 -0
  227. package/src/standards/typescript/always-add-explicit-types.md +32 -0
  228. package/src/standards/typescript/barrel-imports.md +21 -0
  229. package/src/standards/typescript/no-magic-values.md +52 -0
  230. package/src/standards/typescript/one-artifact-per-file.md +19 -0
  231. package/src/standards/typescript/overview.md +8 -0
  232. package/src/standards/ui/communicate-state.md +21 -0
  233. package/src/standards/ui/never-obscure-information-the-user-needs.md +26 -0
  234. package/src/standards/ui/overview.md +16 -0
  235. package/src/standards/ui/pixel-perfect-design-check.md +22 -0
  236. package/src/standards/ui/ui-component-design.md +34 -0
  237. package/src/standards/ui/ui-components-first.md +25 -0
  238. package/src/standards/ui/ui-layout-via-slot-composition.md +33 -0
  239. package/src/standards/ui/ui-library-is-domain-agnostic.md +20 -0
  240. package/src/standards/ui/ui-refactor-preserve-dont-redesign.md +25 -0
  241. package/src/standards/ui/ui-styleguide.md +30 -0
  242. package/src/standards/ui/ui-variants-by-function-not-by-color.md +23 -0
  243. package/src/standards/ui/validation-errors-fire-on-submit.md +20 -0
  244. package/src/standards/ui/walk-the-users-journey.md +29 -0
  245. package/src/standards/web/always-use-design-tokens-for-colors.md +24 -0
  246. package/src/standards/web/dark-mode-through-tokens.md +19 -0
  247. package/src/standards/web/hidden-attribute-loses-to-display.md +22 -0
  248. package/src/standards/web/overview.md +9 -0
  249. package/src/standards/web/scss-shared-partial-imports.md +16 -0
  250. package/src/standards/web/transitions-only-on-user-toggle.md +19 -0
  251. package/src/standards.md +66 -0
  252. package/src/tools/overview.md +22 -0
  253. package/src/tools/scripts/coentrify-update.py +242 -0
  254. package/src/tools/scripts/unlink-missing-standards.py +138 -0
  255. package/src/tools/specs/changelog-append.md +15 -0
  256. package/src/tools/specs/coentrify-json-check.md +21 -0
  257. package/src/tools/specs/commit-gate.md +32 -0
  258. package/src/tools/specs/healing-append.md +15 -0
  259. package/src/tools/specs/landing.md +29 -0
  260. package/src/tools/specs/refuse-wrap-up-questions.md +22 -0
  261. package/src/tools/specs/reload-core-rules.md +20 -0
package/LICENSE ADDED
@@ -0,0 +1,18 @@
1
+ MIT No Attribution
2
+
3
+ Copyright (c) 2026 coentrify
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so.
11
+
12
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
14
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
15
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
16
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
17
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
18
+ SOFTWARE.
package/README.md CHANGED
@@ -2,9 +2,10 @@
2
2
 
3
3
  `npx coentrify` points an agent at [coentrify](https://github.com/coentrify/coentrify): standards, checks and tools for spec-driven development with AI agents.
4
4
 
5
- The package holds no standards. It prints the next step for adopting them, links the latest release of the source, and runs nothing else. It is versioned separately from the standards.
5
+ The package holds the source of coentrify under `src/`: its standards, its tools and its changelog. A project installs it as a dev dependency, and an agent reads the source from `node_modules`. The package's version is coentrify's version.
6
6
 
7
7
  - `npx coentrify` - sets the project up with you in the loop: the agent recommends, and you choose
8
8
  - `npx coentrify make no mistakes` - sets the project up autonomously: the agent chooses, and you veto afterward
9
9
  - `npx coentrify update` - brings the project up to date
10
10
  - `npx coentrify explain` - says what coentrify is
11
+ - `npx coentrify check` - says when `coentrify.json` is behind the installed version, and what changed in between. It runs at the start of a session, and never blocks.
package/bin/coentrify.js CHANGED
@@ -1,19 +1,86 @@
1
1
  #!/usr/bin/env node
2
- const SOURCE = 'https://github.com/coentrify/coentrify';
3
- const BASE = `${SOURCE}/blob/main`;
4
- const USAGE = 'usage: npx coentrify [update | explain | make-no-mistakes]';
5
- const NEXT_STEPS = {
6
- setup: (base) => `Next step: set up coentrify in this project by following its onboarding, ${base}/onboarding.md`,
7
- 'make-no-mistakes': (base) => `Next step: set up coentrify in this project autonomously by following coentrify make no mistakes, ${base}/commands.md#coentrify-make-no-mistakes`,
8
- update: (base) => `Next step: bring this project up to date by following coentrify update, ${base}/commands.md#coentrify-update`,
9
- explain: (base) => `Next step: explain coentrify from its readme, ${base}/readme.md`,
2
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
3
+ import { join } from 'node:path';
4
+
5
+ const PACKAGE = 'coentrify';
6
+ const WIKI = 'https://coentrify.com';
7
+ const INSTALLED = join('node_modules', PACKAGE);
8
+ const SOURCE = `${INSTALLED}/src`;
9
+ const INSTALLED_MANIFEST = join(INSTALLED, 'package.json');
10
+ const CHANGELOG = join(SOURCE, 'changelog');
11
+ const CONFIG = 'coentrify.json';
12
+ const PROJECT_MANIFEST = 'package.json';
13
+ const DEPENDENCIES_INSTALL = 'npm install';
14
+ const README = new URL('../src/readme.md', import.meta.url);
15
+ const VERSION_PAGE = /^(\d+\.\d+\.\d+)\.md$/;
16
+ const SUMMARY = /^# .+\n+([^\n]+)/;
17
+ const INSTALL = `npm install --save-dev ${PACKAGE}`;
18
+ const RAISE = `npm install --save-dev ${PACKAGE}@latest`;
19
+ const UPDATE_STEP = `bring this project up to date by following coentrify update, ${SOURCE}/commands.md#coentrify-update`;
20
+ const USAGE = 'usage: npx coentrify [make-no-mistakes | update | explain | check]';
21
+ const HEADER = `coentrify - spec-driven development, ${WIKI}`;
22
+
23
+ function next(step) {
24
+ console.log(HEADER);
25
+ console.log(`Next step: ${step}`);
26
+ }
27
+
28
+ function readJson(path) {
29
+ return JSON.parse(readFileSync(path, 'utf8'));
30
+ }
31
+
32
+ function parts(version) {
33
+ return version.split('.').map(Number);
34
+ }
35
+
36
+ function compare(first, second) {
37
+ const [a, b] = [parts(first), parts(second)];
38
+ return a[0] - b[0] || a[1] - b[1] || a[2] - b[2];
39
+ }
40
+
41
+ function migrations(from, to) {
42
+ return readdirSync(CHANGELOG)
43
+ .map((file) => file.match(VERSION_PAGE)?.[1])
44
+ .filter((version) => version !== undefined && compare(version, from) > 0 && compare(version, to) <= 0)
45
+ .sort(compare)
46
+ .map((version) => `- ${version}: ${readFileSync(join(CHANGELOG, `${version}.md`), 'utf8').match(SUMMARY)?.[1] ?? ''}`);
47
+ }
48
+
49
+ function check() {
50
+ if (!existsSync(CONFIG)) {
51
+ console.log(`coentrify: no ${CONFIG} here. Set the project up with npx coentrify.`);
52
+ return;
53
+ }
54
+ if (!existsSync(INSTALLED_MANIFEST)) {
55
+ const declared = existsSync(PROJECT_MANIFEST) && PACKAGE in (readJson(PROJECT_MANIFEST).devDependencies ?? {});
56
+ console.log(`coentrify: the project uses coentrify, and it is not installed. Install it with ${declared ? DEPENDENCIES_INSTALL : INSTALL}.`);
57
+ return;
58
+ }
59
+ const project = readJson(CONFIG).version;
60
+ const installed = readJson(INSTALLED_MANIFEST).version;
61
+ if (typeof project !== 'string') {
62
+ console.log(`coentrify: ${CONFIG} has no version. Next step: ${UPDATE_STEP}`);
63
+ } else if (compare(installed, project) > 0) {
64
+ console.log(`coentrify: ${CONFIG} is at ${project}, and the installed coentrify is ${installed}. Next step: ${UPDATE_STEP}`);
65
+ console.log('What changed for a project, by version:');
66
+ console.log(migrations(project, installed).join('\n'));
67
+ } else if (compare(installed, project) < 0) {
68
+ console.log(`coentrify: ${CONFIG} is at ${project}, ahead of the installed coentrify ${installed}. Install it with ${INSTALL}@${project}.`);
69
+ }
70
+ }
71
+
72
+ const COMMANDS = {
73
+ setup: () => next(`install coentrify with ${INSTALL}, then set it up in this project by following its onboarding, ${SOURCE}/onboarding.md`),
74
+ 'make-no-mistakes': () => next(`install coentrify with ${INSTALL}, then set it up in this project autonomously by following coentrify make no mistakes, ${SOURCE}/commands.md#coentrify-make-no-mistakes`),
75
+ update: () => next(`raise coentrify to its latest version with ${RAISE}, then ${UPDATE_STEP}`),
76
+ explain: () => console.log(readFileSync(README, 'utf8')),
77
+ check,
10
78
  };
11
79
 
12
80
  const command = process.argv.slice(2).join('-') || 'setup';
13
- const step = NEXT_STEPS[command];
14
- if (step === undefined) {
81
+ const run = COMMANDS[command];
82
+ if (run === undefined) {
15
83
  console.error(USAGE);
16
84
  process.exit(1);
17
85
  }
18
- console.log(`coentrify - spec-driven development, ${SOURCE}`);
19
- console.log(step(BASE));
86
+ run();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "coentrify",
3
- "version": "0.0.2",
3
+ "version": "0.1.0",
4
4
  "description": "Spec-driven development: standards, checks and tools for working with AI agents.",
5
5
  "license": "MIT-0",
6
6
  "type": "module",
@@ -14,7 +14,8 @@
14
14
  "coentrify": "bin/coentrify.js"
15
15
  },
16
16
  "files": [
17
- "bin"
17
+ "bin",
18
+ "src"
18
19
  ],
19
20
  "engines": {
20
21
  "node": ">=22"
@@ -0,0 +1,259 @@
1
+ # 0.0.1
2
+
3
+ The first version of coentrify. Nothing in it is stable yet.
4
+
5
+ - 187 standards in 21 modules, each module with an overview of its own
6
+ - Ten Read First standards, starting with Always Make No Mistakes
7
+ - The onboarding, the recommendations and the commands
8
+ - `coentrify.json`, with the version and the state of every standard a project takes
9
+ - Scripts and hooks in `tools/`
10
+
11
+ ## AI
12
+
13
+ - Added [Match Known Commands Deterministically, Classify the Rest](../standards/ai/match-known-commands-deterministically-classify-the-rest.md)
14
+ - Added [Prompt Small Models Differently](../standards/ai/prompt-small-models-differently.md)
15
+
16
+ ## Angular
17
+
18
+ - Added Angular Build Checks The Templates
19
+ - Added [canMatch + Wildcard for Route Access](../standards/angular/canmatch-wildcard-for-route-access.md)
20
+ - Added [Interface, Not Abstract Class, For Mock Swap](../standards/angular/interface-not-abstract-class-for-mock-swap.md)
21
+ - Added [No `$any` in Templates](../standards/angular/no-any-in-templates.md)
22
+ - Added [No Inline Templates](../standards/angular/no-inline-templates.md)
23
+ - Added [One Component per Folder, Flat](../standards/angular/one-component-per-folder-flat.md)
24
+ - Added [One Projected Node Per Control-Flow Block](../standards/angular/one-projected-node-per-control-flow-block.md)
25
+ - Added [Prefer Content Projection over Props (Angular)](../standards/angular/prefer-content-projection-over-props-angular.md)
26
+ - Added [Projected Content Is Never Styled by the Host](../standards/angular/projected-content-is-never-styled-by-the-host.md)
27
+ - Added [Static Attribute, Not Literal Binding](../standards/angular/static-attribute-not-literal-binding.md)
28
+ - Added [Track Timed Items by an Id](../standards/angular/track-timed-items-by-an-id.md)
29
+ - Added [UI Copy in Template](../standards/angular/ui-copy-in-template.md)
30
+ - Added [Use Modern Angular Template APIs](../standards/angular/use-modern-angular-template-apis.md)
31
+
32
+ ## Architecture
33
+
34
+ - Added [Adopt, Configure, Override](../standards/architecture/adopt-configure-override.md)
35
+ - Added [App-Shield](../standards/architecture/app-shield.md)
36
+ - Added [Converge Only Once Proven](../standards/architecture/converge-only-once-proven.md)
37
+ - Added [Folder Concerns](../standards/architecture/folder-concerns.md)
38
+ - Added Interceptor Ordering
39
+ - Added [Per-Application Split Over Shared Branching](../standards/architecture/per-application-split-over-shared-branching.md)
40
+ - Added [Separation Before Layer Standards](../standards/architecture/separation-before-layer-standards.md)
41
+
42
+ ## Behavior
43
+
44
+ - Added [A Go Before Work Elsewhere](../standards/behavior/a-go-before-work-elsewhere.md)
45
+ - Added [A Maybe Is A Trigger To Investigate](../standards/behavior/a-maybe-is-a-trigger-to-investigate.md)
46
+ - Added [A Quiet Tree While A Suite Runs](../standards/behavior/a-quiet-tree-while-a-suite-runs.md)
47
+ - Added [Always Make No Mistakes](../standards/behavior/always-make-no-mistakes.md)
48
+ - Added [Always Verify Before Reporting Done](../standards/behavior/always-verify-before-reporting-done.md)
49
+ - Added [Always Work from a Plan](../standards/behavior/always-work-from-a-plan.md)
50
+ - Added [Anchor Edits After Formatting](../standards/behavior/anchor-edits-after-formatting.md)
51
+ - Added [Backward-Trace Missing Prerequisites](../standards/behavior/backward-trace-missing-prerequisites.md)
52
+ - Added [Code Review Compounds Into Patterns and Sweeps](../standards/behavior/code-review-compounds-into-patterns-and-sweeps.md)
53
+ - Added [Communication Boundary](../standards/behavior/communication-boundary.md)
54
+ - Added Decide, Don't Wait
55
+ - Added [Dev Tiers](../standards/behavior/dev-tiers.md)
56
+ - Added [Docs Hold Only What the Director Decided](../standards/behavior/docs-hold-only-what-the-director-decided.md)
57
+ - Added [Don't Filter Data Without a Spec](../standards/behavior/dont-filter-data-without-a-spec.md)
58
+ - Added [Don't Introduce Tech Debt](../standards/behavior/dont-introduce-tech-debt.md)
59
+ - Added [Feature Workflow](../standards/behavior/feature-workflow.md)
60
+ - Added [Flag Every Addition of Your Own](../standards/behavior/flag-every-addition-of-your-own.md)
61
+ - Added [Free Text Replies, No Buttons](../standards/behavior/free-text-replies-no-buttons.md)
62
+ - Added [General Working Rules](../standards/behavior/general-working-rules.md)
63
+ - Added Honest Assessments
64
+ - Added [Non-Destructive Documenting and Test Automation](../standards/behavior/non-destructive-documenting-and-test-automation.md)
65
+ - Added [Normal Dashes](../standards/behavior/normal-dashes.md)
66
+ - Added [Note Issues](../standards/behavior/note-issues.md)
67
+ - Added [Own Ports, Own Processes](../standards/behavior/own-ports-own-processes.md)
68
+ - Added [Project Lifecycle](../standards/behavior/project-lifecycle.md)
69
+ - Added [Propagate Renames and Convention Changes Everywhere](../standards/behavior/propagate-renames-and-convention-changes-everywhere.md)
70
+ - Added [Prose Style](../standards/behavior/prose-style.md)
71
+ - Added [Prototype Mode Is Speed First](../standards/behavior/prototype-mode-is-speed-first.md)
72
+ - Added [Regular Layered Gap Analysis](../standards/behavior/regular-layered-gap-analysis.md)
73
+ - Added [Reload The Standards After Compacting](../standards/behavior/reload-the-standards-after-compacting.md)
74
+ - Added [Review Changes Before Reporting Done](../standards/behavior/review-changes-before-reporting-done.md)
75
+ - Added [Review Every Capture Before Reporting](../standards/behavior/review-every-capture-before-reporting.md)
76
+ - Added [Standards Maintenance](../standards/behavior/standards-maintenance.md)
77
+ - Added [Standards Over Skills](../standards/behavior/standards-over-skills.md)
78
+ - Added [Sweeps Enumerate Into Tech-Debt First](../standards/behavior/sweeps-enumerate-into-tech-debt-first.md)
79
+ - Added [Sync The Docs After Every Change](../standards/behavior/sync-the-docs-after-every-change.md)
80
+ - Added [The Quality Of The Question](../standards/behavior/the-quality-of-the-question.md)
81
+ - Added [Understand The Need](../standards/behavior/understand-the-need.md)
82
+ - Added [Use US English Everywhere](../standards/behavior/use-us-english-everywhere.md)
83
+ - Added [Verify APIs Against Docs And The Installed Artifact](../standards/behavior/verify-apis-against-docs-and-the-installed-artifact.md)
84
+ - Added [Verify Control Before Rename](../standards/behavior/verify-control-before-rename.md)
85
+
86
+ ## Code
87
+
88
+ - Added [Code Principles](../standards/code/code-principles.md)
89
+ - Added [Escape Hatch Comments](../standards/code/escape-hatch-comments.md)
90
+ - Added [Name by Concept, Not Copy](../standards/code/name-by-concept-not-copy.md)
91
+ - Added [No Abbreviated Names](../standards/code/no-abbreviated-names.md)
92
+ - Added [No Describe-What Comments](../standards/code/no-describe-what-comments.md)
93
+ - Added [Pre-empt Recurring Code-Review Nits](../standards/code/pre-empt-recurring-code-review-nits.md)
94
+
95
+ ## Commits
96
+
97
+ - Added [Commits](../standards/commits/commits.md)
98
+ - Added [Gate Commits on Exit Codes](../standards/commits/gate-commits-on-exit-codes.md)
99
+ - Added [Main Stays Green, Work Stays Clean](../standards/commits/main-stays-green-work-stays-clean.md)
100
+ - Added [Verify Staging Before Committing](../standards/commits/verify-staging-before-committing.md)
101
+
102
+ ## Docs
103
+
104
+ - Added [Application Template](../standards/docs/application-template.md)
105
+ - Added [Docs Are Hierarchical, Explicit And Short](../standards/docs/docs-are-hierarchical-explicit-and-short.md)
106
+ - Added [Docs Describe Behavior, Not Wiring](../standards/docs/docs-describe-behavior-not-wiring.md)
107
+ - Added [Docs Folder Structure](../standards/docs/docs-folder-structure.md)
108
+ - Added [Docs State Knowledge](../standards/docs/docs-state-knowledge.md)
109
+ - Added [Documentation Philosophy](../standards/docs/documentation-philosophy.md)
110
+ - Added [Feature Spec Template](../standards/docs/feature-spec-template.md)
111
+ - Added [Feature Template](../standards/docs/feature-template.md)
112
+ - Added [File Names](../standards/docs/file-names.md)
113
+ - Added [Library Feedback](../standards/docs/library-feedback.md)
114
+ - Added [No Faux Headers In Lists](../standards/docs/no-faux-headers-in-lists.md)
115
+ - Added [UI Vocabulary](../standards/docs/ui-vocabulary.md)
116
+ - Added [Workspace Suite](../standards/docs/workspace-suite.md)
117
+ - Added [Workspace Template](../standards/docs/workspace-template.md)
118
+
119
+ ## E2E
120
+
121
+ - Added Canvas Clicks by Coordinates
122
+ - Added [E2E Assert Before Interacting](../standards/e2e/e2e-assert-before-interacting.md)
123
+ - Added [E2E Mock Contract](../standards/e2e/e2e-mock-contract.md)
124
+ - Added [E2E Runs On The Development Build](../standards/e2e/e2e-runs-on-the-development-build.md)
125
+ - Added [E2E Test Conventions](../standards/e2e/e2e-test-conventions.md)
126
+ - Added [E2E Tests Must Demonstrate Behavior](../standards/e2e/e2e-tests-must-demonstrate-behavior.md)
127
+ - Added Init Scripts Need a Navigation
128
+ - Added [Per-Feature Overview Test](../standards/e2e/per-feature-overview-test.md)
129
+ - Added [Real Input For Frame Races](../standards/e2e/real-input-for-frame-races.md)
130
+ - Added [Substring Locator Collisions](../standards/e2e/substring-locator-collisions.md)
131
+ - Added [Use the E2E Pipeline for Browser Probing](../standards/e2e/use-the-e2e-pipeline-for-browser-probing.md)
132
+
133
+ ## Electron
134
+
135
+ - Added [Electron Packaging And Suite](../standards/electron/electron-packaging-and-suite.md)
136
+ - Added [Electron Shell Shape](../standards/electron/electron-shell-shape.md)
137
+
138
+ ## Gamedev
139
+
140
+ - Added [Captures And Reels](../standards/gamedev/captures-and-reels.md)
141
+ - Added Code Based Sound
142
+ - Added [Devbox](../standards/gamedev/devbox.md)
143
+ - Added [Game Design Laws](../standards/gamedev/game-design-laws.md)
144
+ - Added [Game Design Laws: Experience](../standards/gamedev/game-design-laws-experience.md)
145
+ - Added [Game Design Laws: Progress](../standards/gamedev/game-design-laws-progress.md)
146
+ - Added [Game Design Laws: Story](../standards/gamedev/game-design-laws-story.md)
147
+ - Added [Game Design Laws: UI](../standards/gamedev/game-design-laws-ui.md)
148
+ - Added [Game Phases](../standards/gamedev/game-phases.md)
149
+ - Added [Game Work Workflow](../standards/gamedev/game-work-workflow.md)
150
+ - Added [Gamedev Working Cadence](../standards/gamedev/gamedev-working-cadence.md)
151
+ - Added [Own Icons](../standards/gamedev/own-icons.md)
152
+ - Added Pacing Docs
153
+ - Added [Silent Runs](../standards/gamedev/silent-runs.md)
154
+ - Added [Sprite Sheet Frames](../standards/gamedev/sprite-sheet-frames.md)
155
+ - Added Stabilize Before Adding
156
+ - Added Visual Design
157
+
158
+ ## Records
159
+
160
+ - Added [Activity Log](../standards/records/activity-log.md)
161
+ - Added [Changelog Per Version](../standards/records/changelog-per-version.md)
162
+ - Added [Playtest Files](../standards/records/playtest-files.md)
163
+ - Added [Request Log](../standards/records/request-log.md)
164
+
165
+ ## Reporting
166
+
167
+ - Added [Change Report](../standards/reporting/change-report.md)
168
+ - Added [Reels And Video Proof](../standards/reporting/reels-and-video-proof.md)
169
+
170
+ ## Scripts
171
+
172
+ - Added [No npx in Scripts](../standards/scripts/no-npx-in-scripts.md)
173
+ - Added [npm Script Naming](../standards/scripts/npm-script-naming.md)
174
+ - Added [Thin Wrappers in CI and Hooks](../standards/scripts/thin-wrappers-in-ci-and-hooks.md)
175
+
176
+ ## Security
177
+
178
+ - Added [Never Access the Keychain](../standards/security/never-access-the-keychain.md)
179
+
180
+ ## Simple Workflow
181
+
182
+ - Added [Bugs Template](../standards/simple-workflow/bugs-template.md)
183
+ - Added [Plan Template](../standards/simple-workflow/plan-template.md)
184
+ - Added [Plans vs Persistent Files](../standards/simple-workflow/plans-vs-persistent-files.md)
185
+ - Added [Remove Completed Items from Docs](../standards/simple-workflow/remove-completed-items-from-docs.md)
186
+ - Added [Roadmap Template](../standards/simple-workflow/roadmap-template.md)
187
+ - Added [Technical Debt Template](../standards/simple-workflow/technical-debt-template.md)
188
+ - Added [The Simple Workflow](../standards/simple-workflow/the-simple-workflow.md)
189
+ - Added [Todo Template](../standards/simple-workflow/todo-template.md)
190
+
191
+ ## Tests
192
+
193
+ - Added [A Bug's Test Reproduces With Real Input](../standards/tests/a-bugs-test-reproduces-with-real-input.md)
194
+ - Added [Bracket State Changes With Contrast Assertions](../standards/tests/bracket-state-changes-with-contrast-assertions.md)
195
+ - Added [Gestures In Tests](../standards/tests/gestures-in-tests.md)
196
+ - Added [Implementation-Agnostic Assertions](../standards/tests/implementation-agnostic-assertions.md)
197
+ - Added [Implementation-Agnostic Locators](../standards/tests/implementation-agnostic-locators.md)
198
+ - Added [Realistic Test Data Variance](../standards/tests/realistic-test-data-variance.md)
199
+ - Added [Seed Surfaces Every State on Page 1](../standards/tests/seed-surfaces-every-state-on-page-1.md)
200
+ - Added [Test Design](../standards/tests/test-design.md)
201
+
202
+ ## Tickets Workflow
203
+
204
+ - Added [Agent Roles](../standards/tickets-workflow/agent-roles.md)
205
+ - Added [Building A Ticket](../standards/tickets-workflow/building-a-ticket.md)
206
+ - Added [The Conductor](../standards/tickets-workflow/the-conductor.md)
207
+ - Added [The Done Part](../standards/tickets-workflow/the-done-part.md)
208
+ - Added [Ticket Template](../standards/tickets-workflow/ticket-template.md)
209
+ - Added [Work Item Names](../standards/tickets-workflow/work-item-names.md)
210
+ - Added [Work Tracking](../standards/tickets-workflow/work-tracking.md)
211
+ - Added [Work Workflow](../standards/tickets-workflow/work-workflow.md)
212
+ - Added [Writing A Ticket](../standards/tickets-workflow/writing-a-ticket.md)
213
+
214
+ ## Tooling
215
+
216
+ - Added [Browser Captures Go To Disk](../standards/tooling/browser-captures-go-to-disk.md)
217
+ - Added [Check Where A Pane Click Landed](../standards/tooling/check-where-a-pane-click-landed.md)
218
+ - Added [Defer Tooling Until The Cost Shows Up](../standards/tooling/defer-tooling-until-the-cost-shows-up.md)
219
+ - Added [Develop Against Mocks](../standards/tooling/develop-against-mocks.md)
220
+ - Added [Hygiene Tests Run on Their Own Runner](../standards/tooling/hygiene-tests-run-on-their-own-runner.md)
221
+ - Added Kill a Lingering Playwright Server Before Captures
222
+ - Added [Lightweight Test Reporting Only](../standards/tooling/lightweight-test-reporting-only.md)
223
+ - Added [Node Versions](../standards/tooling/node-versions.md)
224
+ - Added [Parallel Agents](../standards/tooling/parallel-agents.md)
225
+ - Added [Playwright Parallel Runs](../standards/tooling/playwright-parallel-runs.md)
226
+ - Added [Playwright Video Recording](../standards/tooling/playwright-video-recording.md)
227
+ - Added [Read Before You Truncate](../standards/tooling/read-before-you-truncate.md)
228
+ - Added Settings Changes Need a Fresh Session
229
+ - Added [VitePress Wiki](../standards/tooling/vitepress-wiki.md)
230
+
231
+ ## TypeScript
232
+
233
+ - Added [Always Add Explicit Types](../standards/typescript/always-add-explicit-types.md)
234
+ - Added [Barrel Imports](../standards/typescript/barrel-imports.md)
235
+ - Added [No Magic Values](../standards/typescript/no-magic-values.md)
236
+ - Added [One Artifact Per File](../standards/typescript/one-artifact-per-file.md)
237
+
238
+ ## UI
239
+
240
+ - Added [Communicate State](../standards/ui/communicate-state.md)
241
+ - Added [Never Obscure Information the User Needs](../standards/ui/never-obscure-information-the-user-needs.md)
242
+ - Added [Pixel-Perfect Design Check](../standards/ui/pixel-perfect-design-check.md)
243
+ - Added [UI Component Design](../standards/ui/ui-component-design.md)
244
+ - Added [UI Components First](../standards/ui/ui-components-first.md)
245
+ - Added [UI Layout via Slot Composition](../standards/ui/ui-layout-via-slot-composition.md)
246
+ - Added [UI Library Is Domain-Agnostic](../standards/ui/ui-library-is-domain-agnostic.md)
247
+ - Added [UI Refactor: Preserve, Don't Redesign](../standards/ui/ui-refactor-preserve-dont-redesign.md)
248
+ - Added [UI Styleguide](../standards/ui/ui-styleguide.md)
249
+ - Added [UI Variants By Function, Not By Color](../standards/ui/ui-variants-by-function-not-by-color.md)
250
+ - Added [Validation Errors Fire on Submit](../standards/ui/validation-errors-fire-on-submit.md)
251
+ - Added [Walk The User's Journey](../standards/ui/walk-the-users-journey.md)
252
+
253
+ ## Web
254
+
255
+ - Added [Always Use Design Tokens for Colors](../standards/web/always-use-design-tokens-for-colors.md)
256
+ - Added [Dark Mode Through Tokens](../standards/web/dark-mode-through-tokens.md)
257
+ - Added [Hidden Attribute Loses To Display](../standards/web/hidden-attribute-loses-to-display.md)
258
+ - Added [SCSS Shared Partial Imports](../standards/web/scss-shared-partial-imports.md)
259
+ - Added [Transitions Only On User Toggle](../standards/web/transitions-only-on-user-toggle.md)
@@ -0,0 +1,219 @@
1
+ # 0.0.2
2
+
3
+ The standards are vetted against current models for the first time. Nothing in it is stable yet.
4
+
5
+ - 185 standards in 21 modules: 144 changed and two went
6
+ - The first round of the relevance vetting: 15 corrections of agent behavior, probed on Claude Opus 5.5 and Claude Sonnet 5.5. Eight stay, five shrank and two went
7
+ - The proof page, with every experiment and the models it was measured on
8
+ - The commit gate hook refuses a commit that follows a `git add` in the same command
9
+ - Scripts that check `coentrify.json` and that remove links to standards a project did not take
10
+ - Title case for every section header, with a check that fails on one out of it
11
+
12
+ ## AI
13
+
14
+ - Changed [Match Known Commands Deterministically, Classify the Rest](../standards/ai/match-known-commands-deterministically-classify-the-rest.md)
15
+ - Changed [Prompt Small Models Differently](../standards/ai/prompt-small-models-differently.md)
16
+
17
+ ## Angular
18
+
19
+ - Changed Angular Build Checks The Templates
20
+ - Changed [Interface, Not Abstract Class, For Mock Swap](../standards/angular/interface-not-abstract-class-for-mock-swap.md)
21
+ - Changed [One Projected Node Per Control-Flow Block](../standards/angular/one-projected-node-per-control-flow-block.md)
22
+ - Changed [Projected Content Is Never Styled by the Host](../standards/angular/projected-content-is-never-styled-by-the-host.md)
23
+ - Changed [Track Timed Items by an Id](../standards/angular/track-timed-items-by-an-id.md)
24
+ - Changed [Use Modern Angular Template APIs](../standards/angular/use-modern-angular-template-apis.md)
25
+
26
+ ## Architecture
27
+
28
+ - Changed [Adopt, Configure, Override](../standards/architecture/adopt-configure-override.md)
29
+ - Changed [App-Shield](../standards/architecture/app-shield.md)
30
+ - Changed [Converge Only Once Proven](../standards/architecture/converge-only-once-proven.md)
31
+ - Changed [Folder Concerns](../standards/architecture/folder-concerns.md)
32
+ - Changed Interceptor Ordering
33
+ - Changed [Per-Application Split Over Shared Branching](../standards/architecture/per-application-split-over-shared-branching.md)
34
+ - Changed [Separation Before Layer Standards](../standards/architecture/separation-before-layer-standards.md)
35
+
36
+ ## Behavior
37
+
38
+ - Changed [A Go Before Work Elsewhere](../standards/behavior/a-go-before-work-elsewhere.md)
39
+ - Changed [A Maybe Is A Trigger To Investigate](../standards/behavior/a-maybe-is-a-trigger-to-investigate.md)
40
+ - Changed [A Quiet Tree While A Suite Runs](../standards/behavior/a-quiet-tree-while-a-suite-runs.md)
41
+ - Changed [Always Make No Mistakes](../standards/behavior/always-make-no-mistakes.md)
42
+ - Changed [Always Verify Before Reporting Done](../standards/behavior/always-verify-before-reporting-done.md)
43
+ - Changed [Always Work from a Plan](../standards/behavior/always-work-from-a-plan.md)
44
+ - Changed [Anchor Edits After Formatting](../standards/behavior/anchor-edits-after-formatting.md)
45
+ - Changed [Code Review Compounds Into Patterns and Sweeps](../standards/behavior/code-review-compounds-into-patterns-and-sweeps.md)
46
+ - Removed Decide, Don't Wait
47
+ - Changed [Dev Tiers](../standards/behavior/dev-tiers.md)
48
+ - Changed [Docs Hold Only What the Director Decided](../standards/behavior/docs-hold-only-what-the-director-decided.md)
49
+ - Changed [Don't Filter Data Without a Spec](../standards/behavior/dont-filter-data-without-a-spec.md)
50
+ - Changed [Don't Introduce Tech Debt](../standards/behavior/dont-introduce-tech-debt.md)
51
+ - Changed [Flag Every Addition of Your Own](../standards/behavior/flag-every-addition-of-your-own.md)
52
+ - Changed [Free Text Replies, No Buttons](../standards/behavior/free-text-replies-no-buttons.md)
53
+ - Changed [General Working Rules](../standards/behavior/general-working-rules.md)
54
+ - Removed Honest Assessments
55
+ - Changed [Normal Dashes](../standards/behavior/normal-dashes.md)
56
+ - Changed [Note Issues](../standards/behavior/note-issues.md)
57
+ - Changed [Project Lifecycle](../standards/behavior/project-lifecycle.md)
58
+ - Changed [Propagate Renames and Convention Changes Everywhere](../standards/behavior/propagate-renames-and-convention-changes-everywhere.md)
59
+ - Changed [Prose Style](../standards/behavior/prose-style.md)
60
+ - Changed [Prototype Mode Is Speed First](../standards/behavior/prototype-mode-is-speed-first.md)
61
+ - Changed [Regular Layered Gap Analysis](../standards/behavior/regular-layered-gap-analysis.md)
62
+ - Changed [Reload The Standards After Compacting](../standards/behavior/reload-the-standards-after-compacting.md)
63
+ - Changed [Review Changes Before Reporting Done](../standards/behavior/review-changes-before-reporting-done.md)
64
+ - Changed [Review Every Capture Before Reporting](../standards/behavior/review-every-capture-before-reporting.md)
65
+ - Changed [Standards Maintenance](../standards/behavior/standards-maintenance.md)
66
+ - Changed [Standards Over Skills](../standards/behavior/standards-over-skills.md)
67
+ - Changed [Sweeps Enumerate Into Tech-Debt First](../standards/behavior/sweeps-enumerate-into-tech-debt-first.md)
68
+ - Changed [Sync The Docs After Every Change](../standards/behavior/sync-the-docs-after-every-change.md)
69
+ - Changed [The Quality Of The Question](../standards/behavior/the-quality-of-the-question.md)
70
+ - Changed [Understand The Need](../standards/behavior/understand-the-need.md)
71
+ - Changed [Verify APIs Against Docs And The Installed Artifact](../standards/behavior/verify-apis-against-docs-and-the-installed-artifact.md)
72
+ - Changed [Verify Control Before Rename](../standards/behavior/verify-control-before-rename.md)
73
+
74
+ ## Code
75
+
76
+ - Changed [Escape Hatch Comments](../standards/code/escape-hatch-comments.md)
77
+ - Changed [Name by Concept, Not Copy](../standards/code/name-by-concept-not-copy.md)
78
+ - Changed [No Abbreviated Names](../standards/code/no-abbreviated-names.md)
79
+ - Changed [No Describe-What Comments](../standards/code/no-describe-what-comments.md)
80
+ - Changed [Pre-empt Recurring Code-Review Nits](../standards/code/pre-empt-recurring-code-review-nits.md)
81
+
82
+ ## Commits
83
+
84
+ - Changed [Gate Commits on Exit Codes](../standards/commits/gate-commits-on-exit-codes.md)
85
+ - Changed [Main Stays Green, Work Stays Clean](../standards/commits/main-stays-green-work-stays-clean.md)
86
+ - Changed [Verify Staging Before Committing](../standards/commits/verify-staging-before-committing.md)
87
+
88
+ ## Docs
89
+
90
+ - Changed [Application Template](../standards/docs/application-template.md)
91
+ - Changed [Docs Are Hierarchical, Explicit And Short](../standards/docs/docs-are-hierarchical-explicit-and-short.md)
92
+ - Changed [Docs State Knowledge](../standards/docs/docs-state-knowledge.md)
93
+ - Changed [Documentation Philosophy](../standards/docs/documentation-philosophy.md)
94
+ - Changed [Feature Spec Template](../standards/docs/feature-spec-template.md)
95
+ - Changed [Feature Template](../standards/docs/feature-template.md)
96
+ - Changed [File Names](../standards/docs/file-names.md)
97
+ - Changed [Library Feedback](../standards/docs/library-feedback.md)
98
+ - Changed [No Faux Headers In Lists](../standards/docs/no-faux-headers-in-lists.md)
99
+ - Changed [UI Vocabulary](../standards/docs/ui-vocabulary.md)
100
+ - Changed [Workspace Suite](../standards/docs/workspace-suite.md)
101
+
102
+ ## E2E
103
+
104
+ - Changed Canvas Clicks by Coordinates
105
+ - Changed [E2E Assert Before Interacting](../standards/e2e/e2e-assert-before-interacting.md)
106
+ - Changed [E2E Mock Contract](../standards/e2e/e2e-mock-contract.md)
107
+ - Changed [E2E Runs On The Development Build](../standards/e2e/e2e-runs-on-the-development-build.md)
108
+ - Changed [E2E Test Conventions](../standards/e2e/e2e-test-conventions.md)
109
+ - Changed [E2E Tests Must Demonstrate Behavior](../standards/e2e/e2e-tests-must-demonstrate-behavior.md)
110
+ - Changed Init Scripts Need a Navigation
111
+ - Changed [Per-Feature Overview Test](../standards/e2e/per-feature-overview-test.md)
112
+ - Changed [Real Input For Frame Races](../standards/e2e/real-input-for-frame-races.md)
113
+ - Changed [Substring Locator Collisions](../standards/e2e/substring-locator-collisions.md)
114
+ - Changed [Use the E2E Pipeline for Browser Probing](../standards/e2e/use-the-e2e-pipeline-for-browser-probing.md)
115
+
116
+ ## Electron
117
+
118
+ - Changed [Electron Packaging And Suite](../standards/electron/electron-packaging-and-suite.md)
119
+ - Changed [Electron Shell Shape](../standards/electron/electron-shell-shape.md)
120
+
121
+ ## Gamedev
122
+
123
+ - Changed [Captures And Reels](../standards/gamedev/captures-and-reels.md)
124
+ - Changed Code Based Sound
125
+ - Changed [Devbox](../standards/gamedev/devbox.md)
126
+ - Changed [Game Design Laws](../standards/gamedev/game-design-laws.md)
127
+ - Changed [Gamedev Working Cadence](../standards/gamedev/gamedev-working-cadence.md)
128
+ - Changed [Own Icons](../standards/gamedev/own-icons.md)
129
+ - Changed Pacing Docs
130
+ - Changed [Silent Runs](../standards/gamedev/silent-runs.md)
131
+ - Changed [Sprite Sheet Frames](../standards/gamedev/sprite-sheet-frames.md)
132
+ - Changed Stabilize Before Adding
133
+
134
+ ## Records
135
+
136
+ - Changed [Activity Log](../standards/records/activity-log.md)
137
+ - Changed [Changelog Per Version](../standards/records/changelog-per-version.md)
138
+ - Changed [Playtest Files](../standards/records/playtest-files.md)
139
+ - Changed [Request Log](../standards/records/request-log.md)
140
+
141
+ ## Reporting
142
+
143
+ - Changed [Change Report](../standards/reporting/change-report.md)
144
+
145
+ ## Scripts
146
+
147
+ - Changed [npm Script Naming](../standards/scripts/npm-script-naming.md)
148
+ - Changed [Thin Wrappers in CI and Hooks](../standards/scripts/thin-wrappers-in-ci-and-hooks.md)
149
+
150
+ ## Security
151
+
152
+ - Changed [Never Access the Keychain](../standards/security/never-access-the-keychain.md)
153
+
154
+ ## Simple Workflow
155
+
156
+ - Changed [Bugs Template](../standards/simple-workflow/bugs-template.md)
157
+ - Changed [Plan Template](../standards/simple-workflow/plan-template.md)
158
+ - Changed [Plans vs Persistent Files](../standards/simple-workflow/plans-vs-persistent-files.md)
159
+ - Changed [Remove Completed Items from Docs](../standards/simple-workflow/remove-completed-items-from-docs.md)
160
+ - Changed [Roadmap Template](../standards/simple-workflow/roadmap-template.md)
161
+ - Changed [Technical Debt Template](../standards/simple-workflow/technical-debt-template.md)
162
+ - Changed [The Simple Workflow](../standards/simple-workflow/the-simple-workflow.md)
163
+ - Changed [Todo Template](../standards/simple-workflow/todo-template.md)
164
+
165
+ ## Tests
166
+
167
+ - Changed [A Bug's Test Reproduces With Real Input](../standards/tests/a-bugs-test-reproduces-with-real-input.md)
168
+ - Changed [Bracket State Changes With Contrast Assertions](../standards/tests/bracket-state-changes-with-contrast-assertions.md)
169
+ - Changed [Implementation-Agnostic Assertions](../standards/tests/implementation-agnostic-assertions.md)
170
+ - Changed [Implementation-Agnostic Locators](../standards/tests/implementation-agnostic-locators.md)
171
+ - Changed [Realistic Test Data Variance](../standards/tests/realistic-test-data-variance.md)
172
+ - Changed [Seed Surfaces Every State on Page 1](../standards/tests/seed-surfaces-every-state-on-page-1.md)
173
+ - Changed [Test Design](../standards/tests/test-design.md)
174
+
175
+ ## Tickets Workflow
176
+
177
+ - Changed [Building A Ticket](../standards/tickets-workflow/building-a-ticket.md)
178
+
179
+ ## Tooling
180
+
181
+ - Changed [Browser Captures Go To Disk](../standards/tooling/browser-captures-go-to-disk.md)
182
+ - Changed [Check Where A Pane Click Landed](../standards/tooling/check-where-a-pane-click-landed.md)
183
+ - Changed [Defer Tooling Until The Cost Shows Up](../standards/tooling/defer-tooling-until-the-cost-shows-up.md)
184
+ - Changed [Hygiene Tests Run on Their Own Runner](../standards/tooling/hygiene-tests-run-on-their-own-runner.md)
185
+ - Changed Kill a Lingering Playwright Server Before Captures
186
+ - Changed [Lightweight Test Reporting Only](../standards/tooling/lightweight-test-reporting-only.md)
187
+ - Changed [Node Versions](../standards/tooling/node-versions.md)
188
+ - Changed [Read Before You Truncate](../standards/tooling/read-before-you-truncate.md)
189
+ - Changed Settings Changes Need a Fresh Session
190
+ - Changed [VitePress Wiki](../standards/tooling/vitepress-wiki.md)
191
+
192
+ ## TypeScript
193
+
194
+ - Changed [Always Add Explicit Types](../standards/typescript/always-add-explicit-types.md)
195
+ - Changed [Barrel Imports](../standards/typescript/barrel-imports.md)
196
+ - Changed [One Artifact Per File](../standards/typescript/one-artifact-per-file.md)
197
+
198
+ ## UI
199
+
200
+ - Changed [Communicate State](../standards/ui/communicate-state.md)
201
+ - Changed [Never Obscure Information the User Needs](../standards/ui/never-obscure-information-the-user-needs.md)
202
+ - Changed [Pixel-Perfect Design Check](../standards/ui/pixel-perfect-design-check.md)
203
+ - Changed [UI Component Design](../standards/ui/ui-component-design.md)
204
+ - Changed [UI Components First](../standards/ui/ui-components-first.md)
205
+ - Changed [UI Layout via Slot Composition](../standards/ui/ui-layout-via-slot-composition.md)
206
+ - Changed [UI Library Is Domain-Agnostic](../standards/ui/ui-library-is-domain-agnostic.md)
207
+ - Changed [UI Refactor: Preserve, Don't Redesign](../standards/ui/ui-refactor-preserve-dont-redesign.md)
208
+ - Changed [UI Styleguide](../standards/ui/ui-styleguide.md)
209
+ - Changed [UI Variants By Function, Not By Color](../standards/ui/ui-variants-by-function-not-by-color.md)
210
+ - Changed [Validation Errors Fire on Submit](../standards/ui/validation-errors-fire-on-submit.md)
211
+ - Changed [Walk The User's Journey](../standards/ui/walk-the-users-journey.md)
212
+
213
+ ## Web
214
+
215
+ - Changed [Always Use Design Tokens for Colors](../standards/web/always-use-design-tokens-for-colors.md)
216
+ - Changed [Dark Mode Through Tokens](../standards/web/dark-mode-through-tokens.md)
217
+ - Changed [Hidden Attribute Loses To Display](../standards/web/hidden-attribute-loses-to-display.md)
218
+ - Changed [SCSS Shared Partial Imports](../standards/web/scss-shared-partial-imports.md)
219
+ - Changed [Transitions Only On User Toggle](../standards/web/transitions-only-on-user-toggle.md)