coentrify 0.0.1 → 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.
- package/LICENSE +18 -0
- package/README.md +5 -4
- package/bin/coentrify.js +79 -12
- package/package.json +3 -2
- package/src/changelog/0.0.1.md +259 -0
- package/src/changelog/0.0.2.md +219 -0
- package/src/changelog/0.0.3.md +81 -0
- package/src/changelog/0.0.4.md +198 -0
- package/src/changelog/0.0.5.md +160 -0
- package/src/changelog/0.0.6.md +282 -0
- package/src/changelog/0.0.7.md +113 -0
- package/src/changelog/0.0.8.md +212 -0
- package/src/changelog/0.1.0.md +9 -0
- package/src/changelog/overview.md +13 -0
- package/src/coentrify-json.md +72 -0
- package/src/commands.md +48 -0
- package/src/glossary.md +132 -0
- package/src/how-it-works.md +51 -0
- package/src/onboarding.md +140 -0
- package/src/origin.md +19 -0
- package/src/philosophy.md +99 -0
- package/src/proof.md +596 -0
- package/src/readme.md +76 -0
- package/src/recommendations.md +100 -0
- package/src/standards/ai/match-known-commands-deterministically-classify-the-rest.md +22 -0
- package/src/standards/ai/overview.md +6 -0
- package/src/standards/ai/prompt-small-models-differently.md +21 -0
- package/src/standards/angular/canmatch-wildcard-for-route-access.md +22 -0
- package/src/standards/angular/interface-not-abstract-class-for-mock-swap.md +37 -0
- package/src/standards/angular/no-any-in-templates.md +25 -0
- package/src/standards/angular/no-inline-templates.md +14 -0
- package/src/standards/angular/one-component-per-folder-flat.md +12 -0
- package/src/standards/angular/one-projected-node-per-control-flow-block.md +19 -0
- package/src/standards/angular/overview.md +16 -0
- package/src/standards/angular/prefer-content-projection-over-props-angular.md +17 -0
- package/src/standards/angular/projected-content-is-never-styled-by-the-host.md +23 -0
- package/src/standards/angular/static-attribute-not-literal-binding.md +23 -0
- package/src/standards/angular/track-timed-items-by-an-id.md +17 -0
- package/src/standards/angular/ui-copy-in-template.md +26 -0
- package/src/standards/angular/use-modern-angular-template-apis.md +20 -0
- package/src/standards/architecture/adopt-configure-override.md +25 -0
- package/src/standards/architecture/app-shield.md +57 -0
- package/src/standards/architecture/converge-only-once-proven.md +22 -0
- package/src/standards/architecture/folder-concerns.md +28 -0
- package/src/standards/architecture/overview.md +11 -0
- package/src/standards/architecture/per-application-split-over-shared-branching.md +25 -0
- package/src/standards/architecture/separation-before-layer-standards.md +17 -0
- package/src/standards/architecture/unique-where-it-counts.md +19 -0
- package/src/standards/behavior/a-go-before-work-elsewhere.md +17 -0
- package/src/standards/behavior/a-maybe-is-a-trigger-to-investigate.md +20 -0
- package/src/standards/behavior/a-name-describes-its-unit.md +19 -0
- package/src/standards/behavior/a-quiet-tree-while-a-suite-runs.md +19 -0
- package/src/standards/behavior/always-make-no-mistakes.md +45 -0
- package/src/standards/behavior/always-verify-before-reporting-done.md +18 -0
- package/src/standards/behavior/always-work-from-a-plan.md +29 -0
- package/src/standards/behavior/anchor-edits-after-formatting.md +17 -0
- package/src/standards/behavior/backward-trace-missing-prerequisites.md +20 -0
- package/src/standards/behavior/code-review-compounds-into-patterns-and-sweeps.md +21 -0
- package/src/standards/behavior/communication-boundary.md +18 -0
- package/src/standards/behavior/dev-tiers.md +25 -0
- package/src/standards/behavior/docs-hold-only-what-the-director-decided.md +23 -0
- package/src/standards/behavior/dont-filter-data-without-a-spec.md +20 -0
- package/src/standards/behavior/dont-introduce-tech-debt.md +25 -0
- package/src/standards/behavior/feature-workflow.md +31 -0
- package/src/standards/behavior/file-a-change-with-coentrify.md +24 -0
- package/src/standards/behavior/flag-every-addition-of-your-own.md +22 -0
- package/src/standards/behavior/free-text-replies-no-buttons.md +20 -0
- package/src/standards/behavior/general-working-rules.md +37 -0
- package/src/standards/behavior/non-destructive-documenting-and-test-automation.md +20 -0
- package/src/standards/behavior/normal-dashes.md +15 -0
- package/src/standards/behavior/note-issues.md +26 -0
- package/src/standards/behavior/overview.md +46 -0
- package/src/standards/behavior/own-ports-own-processes.md +37 -0
- package/src/standards/behavior/project-lifecycle.md +21 -0
- package/src/standards/behavior/propagate-renames-and-convention-changes-everywhere.md +16 -0
- package/src/standards/behavior/prose-style.md +24 -0
- package/src/standards/behavior/prototype-mode-is-speed-first.md +20 -0
- package/src/standards/behavior/regular-layered-gap-analysis.md +20 -0
- package/src/standards/behavior/reload-the-standards-after-compacting.md +16 -0
- package/src/standards/behavior/review-changes-before-reporting-done.md +17 -0
- package/src/standards/behavior/review-every-capture-before-reporting.md +21 -0
- package/src/standards/behavior/standards-maintenance.md +65 -0
- package/src/standards/behavior/standards-over-skills.md +17 -0
- package/src/standards/behavior/sweeps-enumerate-into-tech-debt-first.md +20 -0
- package/src/standards/behavior/sync-the-docs-after-every-change.md +20 -0
- package/src/standards/behavior/the-quality-of-the-question.md +17 -0
- package/src/standards/behavior/things-of-one-kind-are-consistent.md +20 -0
- package/src/standards/behavior/understand-the-need.md +69 -0
- package/src/standards/behavior/use-us-english-everywhere.md +17 -0
- package/src/standards/behavior/verify-apis-against-docs-and-the-installed-artifact.md +17 -0
- package/src/standards/behavior/verify-control-before-rename.md +11 -0
- package/src/standards/code/code-principles.md +32 -0
- package/src/standards/code/escape-hatch-comments.md +20 -0
- package/src/standards/code/name-by-concept-not-copy.md +20 -0
- package/src/standards/code/no-abbreviated-names.md +20 -0
- package/src/standards/code/no-describe-what-comments.md +26 -0
- package/src/standards/code/overview.md +10 -0
- package/src/standards/code/pre-empt-recurring-code-review-nits.md +31 -0
- package/src/standards/commits/commits.md +44 -0
- package/src/standards/commits/gate-commits-on-exit-codes.md +22 -0
- package/src/standards/commits/main-stays-green-work-stays-clean.md +23 -0
- package/src/standards/commits/overview.md +8 -0
- package/src/standards/commits/verify-staging-before-committing.md +29 -0
- package/src/standards/docs/application-template.md +89 -0
- package/src/standards/docs/docs-are-hierarchical-explicit-and-short.md +48 -0
- package/src/standards/docs/docs-describe-behavior-not-wiring.md +24 -0
- package/src/standards/docs/docs-folder-structure.md +38 -0
- package/src/standards/docs/docs-state-knowledge.md +23 -0
- package/src/standards/docs/documentation-philosophy.md +62 -0
- package/src/standards/docs/feature-spec-template.md +89 -0
- package/src/standards/docs/feature-template.md +62 -0
- package/src/standards/docs/file-names.md +20 -0
- package/src/standards/docs/glossary.md +18 -0
- package/src/standards/docs/library-feedback.md +20 -0
- package/src/standards/docs/no-faux-headers-in-lists.md +18 -0
- package/src/standards/docs/overview.md +20 -0
- package/src/standards/docs/ui-vocabulary.md +31 -0
- package/src/standards/docs/workspace-levels.md +24 -0
- package/src/standards/docs/workspace-suite.md +24 -0
- package/src/standards/docs/workspace-template.md +41 -0
- package/src/standards/e2e/e2e-assert-before-interacting.md +21 -0
- package/src/standards/e2e/e2e-mock-contract.md +20 -0
- package/src/standards/e2e/e2e-runs-on-the-development-build.md +18 -0
- package/src/standards/e2e/e2e-test-conventions.md +61 -0
- package/src/standards/e2e/e2e-tests-must-demonstrate-behavior.md +28 -0
- package/src/standards/e2e/one-check-for-many-canvas-clicks.md +17 -0
- package/src/standards/e2e/overview.md +14 -0
- package/src/standards/e2e/per-feature-overview-test.md +30 -0
- package/src/standards/e2e/real-input-for-frame-races.md +25 -0
- package/src/standards/e2e/substring-locator-collisions.md +23 -0
- package/src/standards/e2e/use-the-e2e-pipeline-for-browser-probing.md +18 -0
- package/src/standards/electron/electron-packaging-and-suite.md +22 -0
- package/src/standards/electron/electron-shell-shape.md +21 -0
- package/src/standards/electron/overview.md +6 -0
- package/src/standards/gamedev/2d-visual-design.md +22 -0
- package/src/standards/gamedev/budget-exceptions.json +6 -0
- package/src/standards/gamedev/captures-and-reels.md +39 -0
- package/src/standards/gamedev/devbox.md +21 -0
- package/src/standards/gamedev/game-design-laws-experience.md +68 -0
- package/src/standards/gamedev/game-design-laws-guidance.md +43 -0
- package/src/standards/gamedev/game-design-laws-own-style.md +33 -0
- package/src/standards/gamedev/game-design-laws-progress.md +54 -0
- package/src/standards/gamedev/game-design-laws-quality.md +30 -0
- package/src/standards/gamedev/game-design-laws-story.md +45 -0
- package/src/standards/gamedev/game-design-laws-ui.md +52 -0
- package/src/standards/gamedev/game-design-laws-world.md +38 -0
- package/src/standards/gamedev/game-design-laws.md +112 -0
- package/src/standards/gamedev/game-phases-concept.md +29 -0
- package/src/standards/gamedev/game-phases-design.md +39 -0
- package/src/standards/gamedev/game-phases-development.md +30 -0
- package/src/standards/gamedev/game-phases-live.md +19 -0
- package/src/standards/gamedev/game-phases.md +52 -0
- package/src/standards/gamedev/game-work-workflow.md +47 -0
- package/src/standards/gamedev/gamedev-working-cadence.md +52 -0
- package/src/standards/gamedev/incremental-pacing.md +22 -0
- package/src/standards/gamedev/launch-strategy.md +50 -0
- package/src/standards/gamedev/measure-sound-never-guess.md +24 -0
- package/src/standards/gamedev/overview.md +29 -0
- package/src/standards/gamedev/own-icons.md +19 -0
- package/src/standards/gamedev/silent-runs.md +26 -0
- package/src/standards/gamedev/sprite-sheet-frames.md +23 -0
- package/src/standards/overview.md +43 -0
- package/src/standards/records/activity-log.md +33 -0
- package/src/standards/records/changelog-per-version.md +43 -0
- package/src/standards/records/healing-log.md +23 -0
- package/src/standards/records/overview.md +10 -0
- package/src/standards/records/playtest-files.md +38 -0
- package/src/standards/records/request-log.md +30 -0
- package/src/standards/records/user-test-files.md +21 -0
- package/src/standards/reporting/change-report.md +43 -0
- package/src/standards/reporting/overview.md +6 -0
- package/src/standards/reporting/reels-and-video-proof.md +32 -0
- package/src/standards/scripts/no-npx-in-scripts.md +20 -0
- package/src/standards/scripts/npm-script-naming.md +43 -0
- package/src/standards/scripts/overview.md +7 -0
- package/src/standards/scripts/thin-wrappers-in-ci-and-hooks.md +25 -0
- package/src/standards/security/keep-personal-data-out-of-requests.md +16 -0
- package/src/standards/security/keep-secrets-away-from-agents.md +21 -0
- package/src/standards/security/never-access-the-keychain.md +16 -0
- package/src/standards/security/overview.md +7 -0
- package/src/standards/simple-workflow/bugs-template.md +38 -0
- package/src/standards/simple-workflow/overview.md +12 -0
- package/src/standards/simple-workflow/plan-template.md +50 -0
- package/src/standards/simple-workflow/plans-vs-persistent-files.md +31 -0
- package/src/standards/simple-workflow/remove-completed-items-from-docs.md +19 -0
- package/src/standards/simple-workflow/roadmap-template.md +41 -0
- package/src/standards/simple-workflow/technical-debt-template.md +44 -0
- package/src/standards/simple-workflow/the-simple-workflow.md +48 -0
- package/src/standards/simple-workflow/todo-template.md +31 -0
- package/src/standards/tests/a-bugs-test-reproduces-with-real-input.md +18 -0
- package/src/standards/tests/bracket-state-changes-with-contrast-assertions.md +37 -0
- package/src/standards/tests/gestures-in-tests.md +35 -0
- package/src/standards/tests/implementation-agnostic-assertions.md +20 -0
- package/src/standards/tests/implementation-agnostic-locators.md +18 -0
- package/src/standards/tests/overview.md +13 -0
- package/src/standards/tests/realistic-test-data-variance.md +24 -0
- package/src/standards/tests/seed-surfaces-every-state-on-page-1.md +17 -0
- package/src/standards/tests/test-design.md +47 -0
- package/src/standards/tests/test-the-system-behind-a-mock.md +21 -0
- package/src/standards/tickets-workflow/agent-roles.md +54 -0
- package/src/standards/tickets-workflow/budget-exceptions.json +6 -0
- package/src/standards/tickets-workflow/building-a-ticket.md +47 -0
- package/src/standards/tickets-workflow/overview.md +15 -0
- package/src/standards/tickets-workflow/stabilize-before-adding.md +18 -0
- package/src/standards/tickets-workflow/the-builder.md +28 -0
- package/src/standards/tickets-workflow/the-conductor.md +44 -0
- package/src/standards/tickets-workflow/the-done-part.md +23 -0
- package/src/standards/tickets-workflow/ticket-template.md +96 -0
- package/src/standards/tickets-workflow/work-item-names.md +30 -0
- package/src/standards/tickets-workflow/work-tracking.md +177 -0
- package/src/standards/tickets-workflow/work-workflow.md +123 -0
- package/src/standards/tickets-workflow/writing-a-ticket.md +50 -0
- package/src/standards/tooling/browser-captures-go-to-disk.md +20 -0
- package/src/standards/tooling/check-where-a-pane-click-landed.md +19 -0
- package/src/standards/tooling/defer-tooling-until-the-cost-shows-up.md +19 -0
- package/src/standards/tooling/develop-against-mocks.md +19 -0
- package/src/standards/tooling/hygiene-tests-run-on-their-own-runner.md +18 -0
- package/src/standards/tooling/lightweight-test-reporting-only.md +16 -0
- package/src/standards/tooling/node-versions.md +24 -0
- package/src/standards/tooling/overview.md +17 -0
- package/src/standards/tooling/parallel-agents.md +45 -0
- package/src/standards/tooling/playwright-parallel-runs.md +30 -0
- package/src/standards/tooling/playwright-video-recording.md +32 -0
- package/src/standards/tooling/read-before-you-truncate.md +19 -0
- package/src/standards/tooling/start-playwright-on-a-clean-port.md +22 -0
- package/src/standards/tooling/vitepress-wiki.md +38 -0
- package/src/standards/typescript/always-add-explicit-types.md +32 -0
- package/src/standards/typescript/barrel-imports.md +21 -0
- package/src/standards/typescript/no-magic-values.md +52 -0
- package/src/standards/typescript/one-artifact-per-file.md +19 -0
- package/src/standards/typescript/overview.md +8 -0
- package/src/standards/ui/communicate-state.md +21 -0
- package/src/standards/ui/never-obscure-information-the-user-needs.md +26 -0
- package/src/standards/ui/overview.md +16 -0
- package/src/standards/ui/pixel-perfect-design-check.md +22 -0
- package/src/standards/ui/ui-component-design.md +34 -0
- package/src/standards/ui/ui-components-first.md +25 -0
- package/src/standards/ui/ui-layout-via-slot-composition.md +33 -0
- package/src/standards/ui/ui-library-is-domain-agnostic.md +20 -0
- package/src/standards/ui/ui-refactor-preserve-dont-redesign.md +25 -0
- package/src/standards/ui/ui-styleguide.md +30 -0
- package/src/standards/ui/ui-variants-by-function-not-by-color.md +23 -0
- package/src/standards/ui/validation-errors-fire-on-submit.md +20 -0
- package/src/standards/ui/walk-the-users-journey.md +29 -0
- package/src/standards/web/always-use-design-tokens-for-colors.md +24 -0
- package/src/standards/web/dark-mode-through-tokens.md +19 -0
- package/src/standards/web/hidden-attribute-loses-to-display.md +22 -0
- package/src/standards/web/overview.md +9 -0
- package/src/standards/web/scss-shared-partial-imports.md +16 -0
- package/src/standards/web/transitions-only-on-user-toggle.md +19 -0
- package/src/standards.md +66 -0
- package/src/tools/overview.md +22 -0
- package/src/tools/scripts/coentrify-update.py +242 -0
- package/src/tools/scripts/unlink-missing-standards.py +138 -0
- package/src/tools/specs/changelog-append.md +15 -0
- package/src/tools/specs/coentrify-json-check.md +21 -0
- package/src/tools/specs/commit-gate.md +32 -0
- package/src/tools/specs/healing-append.md +15 -0
- package/src/tools/specs/landing.md +29 -0
- package/src/tools/specs/refuse-wrap-up-questions.md +22 -0
- 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
|
|
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
|
-
- `npx coentrify` - sets the project up with
|
|
8
|
-
- `npx coentrify make no mistakes` - sets the project up
|
|
7
|
+
- `npx coentrify` - sets the project up with you in the loop: the agent recommends, and you choose
|
|
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
|
-
- `npx coentrify explain` -
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
const
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
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
|
|
14
|
-
if (
|
|
81
|
+
const run = COMMANDS[command];
|
|
82
|
+
if (run === undefined) {
|
|
15
83
|
console.error(USAGE);
|
|
16
84
|
process.exit(1);
|
|
17
85
|
}
|
|
18
|
-
|
|
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
|
|
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)
|