contract-driven-delivery 2.0.17 → 2.0.19

package/assets/skills/contract-driven-delivery/templates/tasks.yml

@@ -11,7 +11,9 @@ tasks:
   # status: pending | done | skipped
   - { id: "1.1", section: Preparation, title: "Confirm classification and required artifacts", status: pending }
   - { id: "1.2", section: Preparation, title: "Confirm contracts to update", status: pending }
-  - { id: "1.3", section: Preparation, title: "Confirm CI/CD gate plan", status: pending }
+  - { id: "1.3", section: Preparation, title: "Confirm design decisions if required", status: pending }
+  - { id: "1.4", section: Preparation, title: "Confirm CI/CD gate plan", status: pending }
+  - { id: "1.5", section: Preparation, title: "Confirm implementation plan", status: pending }
   - { id: "2.1", section: "Contract Updates", title: "API contract", status: pending }
   - { id: "2.2", section: "Contract Updates", title: "CSS/UI contract", status: pending }
   - { id: "2.3", section: "Contract Updates", title: "Env contract", status: pending }

package/assets/skills/contract-driven-delivery/templates/test-plan.md

@@ -22,4 +22,4 @@ Mark all that apply: unit / contract / integration / e2e / data-boundary / resil
 
 ## Notes
 
-(Keep this section under 10 lines. Implementation detail belongs in the test files themselves.)
+(Keep this section under 10 lines. Implementation detail belongs in the test files themselves. Do not repeat full implementation-plan or CI-gate content here.)

package/assets/specs-templates/change-classification.md

@@ -16,9 +16,10 @@
 ## Architecture Review Required
 - yes / no
 - reason: (fill only if yes)
+<!-- If yes, Optional Artifacts must set design.md to yes and Required Agents must include spec-architect. -->
 
 ## Required Artifacts
-Always required: change-request.md, change-classification.md, test-plan.md, ci-gates.md, tasks.yml
+Always required: change-request.md, change-classification.md, implementation-plan.md, test-plan.md, ci-gates.md, tasks.yml, context-manifest.md
 
 ## Optional Artifacts (default: no — set yes only with explicit reason)
 | artifact | create? | reason |
@@ -29,6 +30,14 @@ Always required: change-request.md, change-classification.md, test-plan.md, ci-g
 | design.md | no | |
 | qa-report.md | no | |
 | regression-report.md | no | |
+| visual-review-report.md | no | |
+| monkey-test-report.md | no | |
+| stress-soak-report.md | no | |
+
+Artifact minimization:
+- Prefer optional `agent-log/*.yml` pointers for routine review evidence.
+- Create report markdown only for blocking findings, approved-with-risk, excluded pre-existing failures, visual evidence bundles, or high-risk load/soak results.
+- Later artifacts should reference earlier artifacts by path/section/id instead of duplicating full content.
 
 ## Required Contracts
 - API:
@@ -61,7 +70,8 @@ Always required: change-request.md, change-classification.md, test-plan.md, ci-g
 
 ## Tasks Not Applicable
 <!-- Comma-separated task IDs from tasks.yml that do NOT apply to this change.
-     /cdd-new SKILL marks these as `status: skipped` in tasks.yml. -->
+     /cdd-new SKILL marks these as `status: skipped` in tasks.yml.
+     Include 1.3 when design.md is not required. -->
 - not-applicable:
 
 ## Clarifications or Assumptions

package/assets/specs-templates/ci-gates.md

@@ -29,3 +29,7 @@
 ## Artifact Retention
 
 ## Merge Eligibility Decision
+
+## Notes
+
+Reference test-plan.md rows or gate names instead of duplicating full test strategy.

package/assets/specs-templates/implementation-plan.md

@@ -0,0 +1,65 @@
+---
+change-id: <id>
+schema-version: 0.1.0
+last-changed: <date>
+---
+
+# Implementation Plan: <change-id>
+
+## Objective
+
+(Concrete outcome the implementation agents must deliver.)
+
+## Execution Scope
+
+### In Scope
+- 
+
+### Out of Scope
+- 
+
+## Required Changes
+
+| id | area | required action | owner agent |
+|---|---|---|---|
+| IP-1 |  |  |  |
+
+## Source Artifact Pointers
+
+| source | relevant pointer | used for |
+|---|---|---|
+| test-plan.md | AC-1 | tests to run/write |
+| ci-gates.md | required gates table | verification commands |
+| design.md | Decision:  | implementation constraint |
+
+## File-Level Plan
+
+| path or glob | action | notes |
+|---|---|---|
+|  |  |  |
+
+## Contract Updates
+
+- API:
+- CSS/UI:
+- Env:
+- Data shape:
+- Business logic:
+- CI/CD:
+
+## Test Execution Plan
+
+| acceptance criterion | test file / command | expected signal |
+|---|---|---|
+| AC-1 |  |  |
+
+## Handoff Constraints
+
+- Implementation agents must not infer missing requirements from chat history.
+- Do not re-copy full design, test strategy, CI policy, or contract prose into this plan; follow the source pointers above.
+- If this plan omits a required file, behavior, contract, or test, stop and report `blocked`.
+- Keep implementation within the file-level plan unless a Context Expansion Request is approved.
+
+## Known Risks
+
+- 

package/assets/specs-templates/tasks.yml

@@ -11,7 +11,9 @@ tasks:
   # status: pending | done | skipped   (optional: note: "reason or context")
   - { id: "1.1", section: Preparation, title: "Confirm classification and required artifacts", status: pending }
   - { id: "1.2", section: Preparation, title: "Confirm contracts to update", status: pending }
-  - { id: "1.3", section: Preparation, title: "Confirm CI/CD gate plan", status: pending }
+  - { id: "1.3", section: Preparation, title: "Confirm design decisions if required", status: pending }
+  - { id: "1.4", section: Preparation, title: "Confirm CI/CD gate plan", status: pending }
+  - { id: "1.5", section: Preparation, title: "Confirm implementation plan", status: pending }
   - { id: "2.1", section: "Contract Updates", title: "API contract", status: pending }
   - { id: "2.2", section: "Contract Updates", title: "CSS/UI contract", status: pending }
   - { id: "2.3", section: "Contract Updates", title: "Env contract", status: pending }

package/assets/specs-templates/test-plan.md

@@ -22,4 +22,4 @@ Mark all that apply: unit / contract / integration / e2e / data-boundary / resil
 
 ## Notes
 
-(Keep this section under 10 lines. Implementation detail belongs in the test files themselves.)
+(Keep this section under 10 lines. Implementation detail belongs in the test files themselves. Do not repeat full implementation-plan or CI-gate content here.)

package/dist/cli/index.js

@@ -7756,6 +7756,20 @@ function migrateAgentLogs(changeDir, changed, pendingWrites, pendingDeletes) {
     changed.push(`agent-log/${f} -> agent-log/${yamlName}`);
   }
 }
+function ensureImplementationPlanScaffold(changeId, changeDir, changed, warnings, pendingWrites) {
+  const planPath = join13(changeDir, "implementation-plan.md");
+  if (existsSync12(planPath))
+    return;
+  const templatePath = join13(ASSET.specsTemplates, "implementation-plan.md");
+  if (!existsSync12(templatePath)) {
+    warnings.push("implementation-plan.md template not found; run cdd-kit upgrade --yes after updating cdd-kit");
+    return;
+  }
+  const template = readFileSync11(templatePath, "utf8").replace(/<change-id>/g, changeId).replace(/<id>/g, changeId);
+  pendingWrites.push({ path: planPath, content: template });
+  changed.push("implementation-plan.md: added scaffold");
+  warnings.push("implementation-plan.md scaffold added; fill it before implementation agents continue");
+}
 function migrateOne(changeId, changeDir, enableContextGovernance) {
   const changed = [];
   const warnings = [];
@@ -7793,6 +7807,7 @@ function migrateOne(changeId, changeDir, enableContextGovernance) {
     }
   }
   migrateTasksFile(changeId, changeDir, enableContextGovernance, detectedTier, changed, warnings, pending, deletes);
+  ensureImplementationPlanScaffold(changeId, changeDir, changed, warnings, pending);
   migrateAgentLogs(changeDir, changed, pending, deletes);
   const manifestPath = join13(changeDir, "context-manifest.md");
   if (!existsSync12(manifestPath)) {
@@ -7946,6 +7961,7 @@ var init_migrate = __esm({
   "src/commands/migrate.ts"() {
     "use strict";
     init_logger();
+    init_paths();
   }
 });
 
@@ -11668,6 +11684,7 @@ async function ensureFreshContextIndexes(cwd) {
 var REQUIRED_TEMPLATES = [
   "change-request.md",
   "change-classification.md",
+  "implementation-plan.md",
   "test-plan.md",
   "ci-gates.md",
   "tasks.yml",
@@ -11917,6 +11934,7 @@ var TASKS_STATUS_ENUM = /* @__PURE__ */ new Set([
 var REQUIRED_FILES = [
   "change-request.md",
   "change-classification.md",
+  "implementation-plan.md",
   "test-plan.md",
   "ci-gates.md",
   "tasks.yml",
@@ -11925,6 +11943,7 @@ var REQUIRED_FILES = [
 var TIER_PATTERN = /\b(tier\s*[0-5]|low|medium|high|critical)\b/i;
 var MIN_CHARS = {
   "change-classification.md": 200,
+  "implementation-plan.md": 200,
   "test-plan.md": 200,
   "ci-gates.md": 150,
   "change-request.md": 100,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contract-driven-delivery",
-  "version": "2.0.17",
+  "version": "2.0.19",
   "description": "Contract-driven delivery kit for AI coding agents with deterministic context indexes, manifest-backed read-scope governance, and orchestrated contracts-first delivery.",
   "keywords": [
     "contract-driven",