specky-sdd 1.0.0

package/templates/bugfix.md

@@ -0,0 +1,45 @@
+# Bugfix Spec: {{bug_title}}
+
+> Structured specification for bug investigation and resolution.
+
+---
+
+## 1. Current Behavior
+
+{{current_behavior}}
+
+---
+
+## 2. Expected Behavior
+
+{{expected_behavior}}
+
+---
+
+## 3. Unchanged Behavior
+
+The following behaviors must remain unchanged after the fix:
+
+{{#each unchanged_behavior}}
+- {{this}}
+{{/each}}
+
+---
+
+## 4. Root Cause Analysis
+
+{{root_cause}}
+
+---
+
+## 5. Test Plan
+
+{{test_plan}}
+
+---
+
+## Metadata
+
+- **Reported:** {{date}}
+- **Severity:** {{severity}}
+- **Related Requirements:** {{related_requirements}}

package/templates/constitution.md

@@ -0,0 +1,56 @@
+# {{project_name}} — Constitution
+
+> The foundational charter for the **{{project_name}}** project, establishing principles, constraints, and success criteria.
+
+---
+
+## Article 1: Project Identity
+
+- **Name:** {{project_name}}
+- **Description:** {{description}}
+- **Creator:** {{author}}
+- **License:** {{license}}
+
+---
+
+## Article 2: Principles
+
+{{#each principles}}
+- {{this}}
+{{/each}}
+
+---
+
+## Article 3: Constraints
+
+{{#each constraints}}
+- {{this}}
+{{/each}}
+
+---
+
+## Article 4: Success Criteria
+
+| ID | Criterion | Measure |
+|----|-----------|---------|
+| SC-001 | Project compiles without errors | `npm run build` exits 0 |
+| SC-002 | All requirements traceable | Every REQ has design + task mapping |
+| SC-003 | Quality gates pass | Analysis gate returns APPROVE |
+
+---
+
+## Article 5: Scope
+
+### In Scope
+- {{scope_in}}
+
+### Out of Scope
+- {{scope_out}}
+
+---
+
+## Amendment Log
+
+| # | Date | Author | Rationale | Articles Affected |
+|---|------|--------|-----------|-------------------|
+| — | — | — | Initial version | All |

package/templates/design.md

@@ -0,0 +1,47 @@
+# {{project_name}} — Design
+
+> Architecture, diagrams, ADRs, and API contracts.
+
+---
+
+## 1. Architecture Overview
+
+{{architecture_overview}}
+
+---
+
+## 2. System Diagrams
+
+{{#each diagrams}}
+### {{this}}
+{{/each}}
+
+---
+
+## 3. Architecture Decision Records
+
+{{#each adrs}}
+### {{this}}
+{{/each}}
+
+---
+
+## 4. API Contracts
+
+{{api_contracts}}
+
+---
+
+## 5. Data Models
+
+{{data_models}}
+
+---
+
+## 6. Error Handling Strategy
+
+{{error_handling}}
+
+---
+
+**Covers:** {{requirement_references}}

package/templates/specification.md

@@ -0,0 +1,49 @@
+# {{project_name}} — Specification
+
+> All requirements use **EARS notation** (Easy Approach to Requirements Syntax). Each requirement is testable, unambiguous, and traceable to the Constitution's success criteria.
+
+---
+
+## Table of Contents
+
+- [1. Core Requirements](#1-core-requirements)
+- [2. Functional Requirements](#2-functional-requirements)
+- [3. Non-Functional Requirements](#3-non-functional-requirements)
+- [Acceptance Criteria Summary](#acceptance-criteria-summary)
+
+---
+
+## 1. Core Requirements
+
+{{requirements_core}}
+
+---
+
+## 2. Functional Requirements
+
+{{requirements_functional}}
+
+---
+
+## 3. Non-Functional Requirements
+
+{{requirements_nonfunctional}}
+
+---
+
+## Acceptance Criteria Summary
+
+| ID | Requirement | Test Method |
+|----|-------------|-------------|
+{{acceptance_criteria_table}}
+
+---
+
+## Self-Assessment
+
+| Criterion | Score | Notes |
+|-----------|-------|-------|
+| EARS notation compliance | {{ears_compliance}} | |
+| Testability | {{testability_score}} | Every requirement has acceptance criteria |
+| Traceability | {{traceability_score}} | Every requirement traces to Constitution |
+| Uniqueness of IDs | {{uniqueness_score}} | No duplicate requirement IDs |

package/templates/sync-report.md

@@ -0,0 +1,43 @@
+# Sync Report: {{project_name}}
+
+> Drift analysis between specification and implementation.
+
+---
+
+## Summary
+
+- **In Sync:** {{in_sync}}
+- **Last Checked:** {{last_checked}}
+- **Drift Items:** {{drift_count}}
+
+---
+
+## Requirements Coverage
+
+| Requirement | Implementation | Status |
+|-------------|---------------|--------|
+{{coverage_table}}
+
+---
+
+## Drift Items
+
+{{#each drift_items}}
+- {{this}}
+{{/each}}
+
+---
+
+## Orphan Code
+
+Files not traced to any requirement:
+
+{{#each orphan_files}}
+- {{this}}
+{{/each}}
+
+---
+
+## Recommendation
+
+{{recommendation}}

package/templates/tasks.md

@@ -0,0 +1,38 @@
+# {{project_name}} — Tasks
+
+> Sequenced implementation tasks with pre-implementation gates, `[P]` parallel markers, effort estimates, and requirement traceability.
+
+---
+
+## Pre-Implementation Gates
+
+Before writing any code, the following gates must pass:
+
+{{#each gates}}
+- [ ] {{this}}
+{{/each}}
+
+---
+
+## Task Breakdown
+
+| ID | Task | [P] | Effort | Depends On | Traces To |
+|----|------|-----|--------|------------|-----------|
+{{task_table}}
+
+---
+
+## Dependency Graph
+
+```
+{{dependency_graph}}
+```
+
+---
+
+## Effort Summary
+
+| Phase | Tasks | Parallel | Effort |
+|-------|-------|----------|--------|
+{{effort_summary}}
+| **Total** | **{{total_tasks}}** | **{{parallel_tasks}}** | **{{total_effort}}** |