sedd 0.1.0

package/templates/sedd.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://sedd.dev/sedd.schema.json",
+  "title": "SEDD Configuration",
+  "description": "Configuration file for SEDD (Spec & Expectation Driven Development)",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "specsDir": {
+      "type": "string",
+      "default": ".sedd",
+      "description": "Directory for storing feature specifications. Default: '.sedd', use 'specs' for legacy projects."
+    },
+    "branchPattern": {
+      "type": "string",
+      "default": "{{id}}-{{name}}",
+      "description": "Pattern for feature branch names. Variables: {{id}}, {{name}}"
+    },
+    "autoSplit": {
+      "type": "object",
+      "description": "Auto-split configuration for large files",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable automatic file splitting"
+        },
+        "maxLines": {
+          "type": "integer",
+          "default": 400,
+          "minimum": 100,
+          "maximum": 1000,
+          "description": "Maximum lines before auto-split triggers"
+        }
+      },
+      "additionalProperties": false
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Hook behavior configuration",
+      "properties": {
+        "assertive": {
+          "type": "boolean",
+          "default": true,
+          "description": "Force skill activation (true) or just suggest (false)"
+        },
+        "skills": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": ["langchain-expert", "architecture-mapper", "defect-analyzer"],
+          "description": "Skills to activate based on prompt keywords"
+        },
+        "checkOnlyCurrentMigration": {
+          "type": "boolean",
+          "default": true,
+          "description": "Only check current migration, not historical migrations"
+        },
+        "showSyncWarnings": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show warnings when task files are out of sync"
+        },
+        "blockOnSyncError": {
+          "type": "boolean",
+          "default": false,
+          "description": "Block Claude from stopping if files are out of sync (optional, disabled by default)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "commit": {
+      "type": "object",
+      "description": "Git commit configuration",
+      "properties": {
+        "askBeforeCommit": {
+          "type": "boolean",
+          "default": true,
+          "description": "Ask user confirmation before committing"
+        },
+        "messagePattern": {
+          "type": "string",
+          "default": "{{type}}({{id}}): {{message}}",
+          "description": "Commit message pattern. Variables: {{type}}, {{id}}, {{message}}"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/templates/spec-template.md

@@ -0,0 +1,114 @@
+# Feature Specification: {{FEATURE_NAME}}
+
+> Feature ID: {{FEATURE_ID}}
+> Created: {{TIMESTAMP}}
+> Status: Draft
+
+## Overview
+
+Brief description of what this feature does and why it's needed.
+
+---
+
+## Expectation
+
+> What do you expect as the final outcome of this feature?
+
+[User's expectation here]
+
+---
+
+## User Stories
+
+### US1: [Story Title] (P1 - Critical)
+
+**As a** [user type]
+**I want** [goal]
+**So that** [benefit]
+
+**Acceptance Criteria:**
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+---
+
+### US2: [Story Title] (P2 - Important)
+
+**As a** [user type]
+**I want** [goal]
+**So that** [benefit]
+
+**Acceptance Criteria:**
+- [ ] Criterion 1
+
+---
+
+## Functional Requirements
+
+| ID | Requirement | Priority | Status |
+|----|-------------|----------|--------|
+| FR-001 | Description | P1 | NEEDS_CLARIFICATION |
+| FR-002 | Description | P2 | Draft |
+
+---
+
+## Non-Functional Requirements
+
+| ID | Requirement | Metric |
+|----|-------------|--------|
+| NFR-001 | Performance | Response < 200ms |
+| NFR-002 | Security | Authentication required |
+
+---
+
+## Key Entities
+
+```
++--------------+     +--------------+
+|   Entity1    |----▶|   Entity2    |
++--------------+     +--------------+
+```
+
+| Entity | Type | Description |
+|--------|------|-------------|
+| Entity1 | Aggregate | Main entity |
+| Entity2 | Entity | Related entity |
+
+> **Note:** Full TypeScript interfaces are in `interfaces.ts`
+
+---
+
+## Success Criteria
+
+| ID | Criterion | Measurement |
+|----|-----------|-------------|
+| SC-001 | User adoption | > 80% of users |
+| SC-002 | Error rate | < 1% |
+
+---
+
+## Out of Scope
+
+- Item 1
+- Item 2
+
+---
+
+## Open Questions
+
+Items marked NEEDS_CLARIFICATION will be addressed in migrations.
+
+- [ ] Question 1?
+- [ ] Question 2?
+
+---
+
+## Migrations
+
+Clarifications and tasks are organized in migration folders:
+
+| Migration | Created | Status | Tasks |
+|-----------|---------|--------|-------|
+| - | - | - | - |
+
+> Run `/sedd.clarify` to create a new migration with clarifications and tasks.

package/templates/tasks-template.md

@@ -0,0 +1,58 @@
+# Tasks - Migration {{MIGRATION_ID}}
+
+> Migration: {{MIGRATION_ID}}
+> Timestamp: {{TIMESTAMP}}
+> Parent: {{PARENT_MIGRATION}}
+
+## Summary
+
+Total: {{TOTAL_TASKS}} | Completed: 0 | Pending: {{TOTAL_TASKS}}
+
+---
+
+## Tasks
+
+### Foundation
+
+- [ ] T{{MIGRATION_ID}}-001 [Foundation] [Task description] `path/to/file.ts`
+- [ ] T{{MIGRATION_ID}}-002 [Foundation] [Task description] `path/to/file.ts`
+
+### User Story 1
+
+- [ ] T{{MIGRATION_ID}}-003 [US1] [Task description] `path/to/file.ts`
+- [ ] T{{MIGRATION_ID}}-004 [US1] [Task description] `path/to/file.ts`
+
+### User Story 2
+
+- [ ] T{{MIGRATION_ID}}-005 [US2] [Task description] `path/to/file.ts`
+
+---
+
+## Dependencies
+
+```
+T{{MIGRATION_ID}}-001, T{{MIGRATION_ID}}-002 (Foundation)
+        |
+        v
+T{{MIGRATION_ID}}-003 -> T{{MIGRATION_ID}}-004 (US1)
+        |
+        v
+T{{MIGRATION_ID}}-005 (US2)
+```
+
+---
+
+## Legend
+
+- `[Foundation]` = Foundational task, must complete first
+- `[USx]` = Belongs to User Story X
+- `[P]` = Can run in parallel with other [P] tasks
+- File paths in backticks indicate target file
+
+---
+
+## Related
+
+- **Clarifications:** See `clarify.md` in this migration
+- **Decisions:** See `decisions.md` in this migration
+- **Progress:** See `progress.md` in feature root