contract-driven-delivery 1.0.0

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

@@ -0,0 +1,48 @@
+# Change Classification
+
+## Change Types
+- primary:
+- secondary:
+
+## Risk Level
+- low / medium / high / critical
+
+## Impact Radius
+- isolated / module-level / cross-module / system-wide
+
+## Required Artifacts
+| artifact | required | reason |
+|---|---:|---|
+| current-behavior.md |  |  |
+| proposal.md |  |  |
+| spec.md |  |  |
+| design.md |  |  |
+| contracts.md |  |  |
+| test-plan.md | yes | every implementation change requires test planning |
+| ci-gates.md | yes | every implementation change requires CI/CD gate planning |
+| qa-report.md |  |  |
+| regression-report.md |  |  |
+
+## Required Contracts
+- API:
+- CSS/UI:
+- Env:
+- Data shape:
+- Business logic:
+- CI/CD:
+
+## Required Test Families
+- unit:
+- contract:
+- integration:
+- E2E:
+- visual:
+- data-boundary:
+- resilience:
+- fuzz/monkey:
+- stress:
+- soak:
+
+## Required Agents
+
+## Assumptions / Clarifications

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

@@ -0,0 +1,15 @@
+# Change Request
+
+## Original Request
+
+## Business / User Goal
+
+## Non-goals
+
+## Constraints
+
+## Known Context
+
+## Open Questions
+
+## Requested Delivery Date / Priority

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

@@ -0,0 +1,31 @@
+# CI/CD Gate Plan
+
+## Change ID
+
+## Required Gates
+| gate | tier | required | trigger | command/workflow | expected artifact |
+|---|---:|---:|---|---|---|
+| lint | 1 | yes | pull_request |  |  |
+| build | 1 | yes | pull_request |  |  |
+| unit | 1 | yes | pull_request |  |  |
+| contract | 1 | conditional | pull_request |  |  |
+| integration | 1/3 | conditional | pull_request/nightly |  |  |
+| e2e-critical | 1 | conditional | pull_request |  |  |
+| visual | 2 | conditional | pull_request |  |  |
+| data-boundary | 1 | conditional | pull_request |  |  |
+| resilience | 1/3 | conditional | pull_request/nightly |  |  |
+| fuzz/monkey | 1/3 | conditional | pull_request/nightly |  |  |
+| stress | 4/5 | conditional | weekly/manual |  |  |
+| soak | 4/5 | conditional | weekly/manual |  |  |
+
+## New Workflow Changes
+
+## Required Check Policy
+
+## Informational Gate Promotion Policy
+
+## Rollback Policy
+
+## Artifact Retention
+
+## Merge Eligibility Decision

package/assets/specs-templates/contracts.md

@@ -0,0 +1,37 @@
+# Contract Change Report
+
+## API Contract
+- changed:
+- files:
+- compatibility:
+- tests:
+
+## CSS/UI Contract
+- changed:
+- files:
+- visual evidence required:
+- tests:
+
+## Env Contract
+- changed:
+- variables:
+- public/private scope:
+- deployment impact:
+- tests:
+
+## Data Shape Contract
+- changed:
+- required columns/types:
+- malformed data behavior:
+- tests:
+
+## Business Logic Contract
+- changed:
+- decision table:
+- regression tests:
+
+## CI/CD Contract
+- changed:
+- gates:
+- required checks:
+- promotion policy:

package/assets/specs-templates/current-behavior.md

@@ -0,0 +1,17 @@
+# Current Behavior
+
+## Current User Flow
+
+## Current API / Data Flow
+
+## Current Business Rules
+
+## Current UI States
+
+## Current Tests
+
+## Known Issues
+
+## Compatibility Constraints
+
+## Regression Scope

package/assets/specs-templates/design.md

@@ -0,0 +1,23 @@
+# Technical Design
+
+## Architecture Summary
+
+## Affected Components
+
+## API Design
+
+## Data / Schema Design
+
+## UI / UX Design
+
+## Env / Config Design
+
+## Error Handling
+
+## Performance Considerations
+
+## Security Considerations
+
+## Deployment / Rollback
+
+## Architecture Decision Notes

package/assets/specs-templates/monkey-test-report.md

@@ -0,0 +1,17 @@
+# Monkey Operation Test Report
+
+## Target Feature
+
+## Preventive Spec Cases
+
+## Exploratory Operation Sequences
+| id | sequence | expected safe outcome | result |
+|---|---|---|---|
+
+## Fuzz Payloads / Malformed Data
+
+## Findings
+
+## Required Fixes
+
+## Regression Tests Added

package/assets/specs-templates/project-profile.md

@@ -0,0 +1,38 @@
+# Project Profile
+
+## Project Type
+
+## Detected Stack
+- languages:
+- frontend:
+- backend:
+- database:
+- cache/queue:
+- storage:
+- auth:
+- styling:
+- test frameworks:
+- build/deploy:
+
+## Important Paths
+
+## Commands
+- install:
+- dev:
+- build:
+- lint:
+- typecheck:
+- unit:
+- integration:
+- e2e:
+- contract:
+- stress:
+- soak:
+
+## Existing Contracts
+
+## CI/CD Workflows
+
+## Missing or Weak Standards
+
+## Recommended Next Steps

package/assets/specs-templates/proposal.md

@@ -0,0 +1,17 @@
+# Proposal
+
+## Intent
+
+## Scope
+
+## Out of Scope
+
+## Proposed Approach
+
+## Alternatives Considered
+
+## Compatibility / Migration
+
+## Rollback Plan
+
+## Success Criteria

package/assets/specs-templates/qa-report.md

@@ -0,0 +1,26 @@
+# QA Report
+
+## Summary
+
+## Gate Results
+| gate | command/workflow | result | artifact/log |
+|---|---|---|---|
+
+## Functional Verification
+
+## Contract Verification
+
+## Visual / UX Verification
+
+## E2E / Resilience Verification
+
+## Stress / Soak Verification
+
+## Known Risks
+
+## Failures and Fixback Routing
+| failure | evidence | owner | required fix |
+|---|---|---|---|
+
+## Decision
+approved / blocked / approved-with-risk

package/assets/specs-templates/regression-report.md

@@ -0,0 +1,21 @@
+# Regression Report
+
+## Changed Areas
+
+## Directly Affected Features
+
+## Indirectly Affected Features
+
+## Critical User Journeys Re-tested
+
+## API Regression
+
+## UI Regression
+
+## Data / Business Logic Regression
+
+## CI/CD Regression
+
+## Spec Drift Findings
+
+## Decision

package/assets/specs-templates/spec.md

@@ -0,0 +1,23 @@
+# Specification
+
+## User Stories / Scenarios
+
+### Scenario 1
+Given
+When
+Then
+
+## Functional Requirements
+
+## Non-functional Requirements
+
+## Edge Cases
+
+## Acceptance Criteria
+
+| id | criterion | measurable signal |
+|---|---|---|
+
+## Clarifications
+
+## Open Risks

package/assets/specs-templates/stress-soak-report.md

@@ -0,0 +1,22 @@
+# Stress / Soak Report
+
+## Workload Model
+
+## Environment
+
+## Duration
+
+## Metrics Collected
+
+## Thresholds
+
+## Results
+| metric | threshold | observed | result |
+|---|---|---|---|
+
+## Failures / Degradation
+
+## Artifacts
+
+## Recommendation
+pass / fail / repeat-with-adjusted-load / promote-to-gate

package/assets/specs-templates/tasks.md

@@ -0,0 +1,43 @@
+# Tasks
+
+## 1. Preparation
+- [ ] 1.1 Confirm classification and required artifacts
+- [ ] 1.2 Confirm contracts to update
+- [ ] 1.3 Confirm CI/CD gate plan
+
+## 2. Contract Updates
+- [ ] 2.1 API contract
+- [ ] 2.2 CSS/UI contract
+- [ ] 2.3 Env contract
+- [ ] 2.4 Data shape contract
+- [ ] 2.5 Business logic contract
+- [ ] 2.6 CI/CD contract
+
+## 3. Tests First
+- [ ] 3.1 Unit/contract tests
+- [ ] 3.2 Integration tests
+- [ ] 3.3 E2E/resilience tests
+- [ ] 3.4 Data-boundary/monkey tests
+- [ ] 3.5 Stress/soak tests if required
+
+## 4. Implementation
+- [ ] 4.1 Backend
+- [ ] 4.2 Frontend
+- [ ] 4.3 Env/deploy
+- [ ] 4.4 CI/CD workflows
+
+## 5. Review
+- [ ] 5.1 UI/UX review
+- [ ] 5.2 Visual review
+- [ ] 5.3 Contract review
+- [ ] 5.4 QA review
+
+## 6. Verification
+- [ ] 6.1 Local gates
+- [ ] 6.2 PR required gates
+- [ ] 6.3 Informational gates
+- [ ] 6.4 Nightly/weekly/manual gates if required
+
+## 7. Archive
+- [ ] 7.1 Archive change
+- [ ] 7.2 Promote durable learnings to contracts or CLAUDE.md

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

@@ -0,0 +1,31 @@
+# Test Plan
+
+## Acceptance Criteria Mapping
+| requirement | test family | planned file/spec | expected evidence |
+|---|---|---|---|
+
+## Unit Tests
+
+## Contract Tests
+
+## Integration Tests
+
+## E2E Tests
+
+## Visual Tests / Review
+
+## Data Boundary Tests
+
+## Resilience Tests
+
+## Fuzz / Monkey Operation Tests
+
+## Stress Tests
+
+## Soak Tests
+
+## Mutation Checks
+
+## Commands
+
+## CI/CD Gate Mapping

package/assets/specs-templates/visual-review-report.md

@@ -0,0 +1,33 @@
+# Visual Review Report
+
+## Affected Screens
+
+## Viewports Checked
+- desktop:
+- tablet:
+- mobile:
+
+## States Checked
+- default:
+- loading:
+- empty:
+- error:
+- disabled:
+- focus/keyboard:
+- long text:
+- no permission:
+
+## Evidence
+- screenshots:
+- videos:
+- traces:
+- diff reports:
+
+## CSS Contract Findings
+
+## Accessibility Findings
+
+## Required Fixes
+
+## Decision
+approved / changes-required

package/assets/tests-templates/data-boundary/malformed-data.spec.md

@@ -0,0 +1,14 @@
+# Data Boundary Test Template
+
+## Dataset Shape
+
+## Malformed Case
+- missing column
+- wrong type
+- null value
+- large data
+- unexpected enum
+
+## Expected Behavior
+
+## Error Code / UI State

package/assets/tests-templates/e2e/critical-journey.spec.md

@@ -0,0 +1,13 @@
+# E2E Critical Journey Template
+
+## Journey
+
+## Preconditions
+
+## Steps
+
+## Expected Results
+
+## Failure Evidence
+
+## Artifacts

package/assets/tests-templates/monkey/operation-sequence.spec.md

@@ -0,0 +1,11 @@
+# Monkey Operation Test Template
+
+## Operation Sequence
+
+## Risk Being Tested
+
+## Expected Safe Outcome
+
+## Assertion
+
+## Regression Link

package/assets/tests-templates/resilience/api-failure.spec.md

@@ -0,0 +1,12 @@
+# Resilience Test Template
+
+## Failure Mode
+- API 500 / 503 / timeout / abort / slow network
+
+## User Action
+
+## Expected Safe Behavior
+
+## Mutation Check
+
+## CI Gate Tier

package/assets/tests-templates/soak/soak-profile.md

@@ -0,0 +1,15 @@
+# Soak Profile
+
+## Target Feature
+
+## Duration
+
+## Refresh / Request Pattern
+
+## Cache / Queue / DB Expectations
+
+## Metrics
+
+## Failure Thresholds
+
+## Artifact Retention

package/assets/tests-templates/stress/load-profile.md

@@ -0,0 +1,15 @@
+# Stress Load Profile
+
+## Target Feature
+
+## Workload Mix
+
+## Concurrency
+
+## Data Volume
+
+## Duration
+
+## Metrics
+
+## Thresholds

package/bin/cdd.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js';