@dalzoubi/dev-agents-sync 2.0.1 → 2.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalzoubi/dev-agents-sync",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "type": "module",
   "description": "CLI that syncs managed dev-agent prompts into consumer repos (.claude/ and/or .cursor/).",
   "license": "UNLICENSED",

package/tests/define-vertical-slice-principle.test.mjs

@@ -0,0 +1,82 @@
+/**
+ * tests/define-vertical-slice-principle.test.mjs
+ *
+ * Slice: vertical-slice-guidance
+ *
+ * Asserts that the "Implementation slices" Q&A item in
+ * .agents/skills/define-spec-session.md has been updated to state:
+ *
+ *   1. Each slice must include all layers needed to demonstrate its outcome
+ *      end-to-end (vertical slice principle).
+ *   2. Each slice must be independently demonstrable, deployable, or testable.
+ *
+ * These tests FAIL before the implementation change lands and PASS after.
+ *
+ * Path under test: .agents/skills/define-spec-session.md (relative to repo root)
+ * Test runner: node --test (Node built-in, >= 20)
+ */
+
+import { describe, it, before } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+// ---------------------------------------------------------------------------
+// Resolve the file under test relative to this file's location.
+// Repo layout: packages/dev-agents-sync/tests/ -> repo root is 3 levels up.
+// ---------------------------------------------------------------------------
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = path.resolve(__dirname, '../../..');
+const SKILL_FILE = path.join(REPO_ROOT, '.agents', 'skills', 'define-spec-session.md');
+
+let content;
+
+before(() => {
+  content = readFileSync(SKILL_FILE, 'utf8');
+});
+
+// ---------------------------------------------------------------------------
+// Criterion 1 — vertical slice principle: all layers required end-to-end
+// ---------------------------------------------------------------------------
+
+describe('define-spec-session.md — vertical slice principle (all layers, end-to-end)', () => {
+  it('states that each slice must include all layers needed to demonstrate its outcome end-to-end', () => {
+    // The Implementation slices item must explicitly instruct the model that
+    // every slice should span all the layers needed to deliver its stated
+    // outcome (i.e., it is a vertical slice, not a horizontal layer slice).
+    const allLayersEndToEnd =
+      /all\s+layers\s+needed/i.test(content) ||
+      /end[- ]to[- ]end\s+(?:value|outcome|behavior|demonstration|demonstr)/i.test(content) ||
+      /(?:span|include|cover)\s+all\s+(?:required\s+)?layers/i.test(content) ||
+      /vertical\s+slice/i.test(content);
+
+    assert.ok(
+      allLayersEndToEnd,
+      'define-spec-session.md must state that each slice must include all layers needed to demonstrate its outcome end-to-end',
+    );
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Criterion 2 — independent demonstrability / deployability / testability
+// ---------------------------------------------------------------------------
+
+describe('define-spec-session.md — each slice independently demonstrable', () => {
+  it('states that each slice can be reviewed, deployed, or tested independently', () => {
+    // The Implementation slices item must convey that the slice is
+    // independently usable — reviewable, deployable, or testable on its own —
+    // not merely that it has a name and scope.
+    const independentlyDemonstrableOrDeployable =
+      /independently\s+(?:demonstrabl|deployabl|reviewabl|testabl)/i.test(content) ||
+      /(?:demonstrabl|deployabl|reviewabl|testabl)\w*\s+independently/i.test(content) ||
+      /(?:reviewed|deployed|tested)\s+independently/i.test(content) ||
+      /independently\s+(?:reviewed|deployed|tested)/i.test(content);
+
+    assert.ok(
+      independentlyDemonstrableOrDeployable,
+      'define-spec-session.md must state that each slice can be reviewed, deployed, or tested independently',
+    );
+  });
+});