semantic add

.specify/templates/tasks-template.md

@@ -88,12 +88,17 @@ Examples of foundational tasks (adjust based on your project):
 
 ### Implementation for User Story 1
 
-- [ ] T012 [P] [US1] Create [Entity1] model in src/models/[entity1].py
-- [ ] T013 [P] [US1] Create [Entity2] model in src/models/[entity2].py
-- [ ] T014 [US1] Implement [Service] in src/services/[service].py (depends on T012, T013)
-- [ ] T015 [US1] Implement [endpoint/feature] in src/[location]/[file].py
-- [ ] T016 [US1] Add validation and error handling
-- [ ] T017 [US1] Add logging for user story 1 operations
+> **Protocol Note**: Follow Semantic Protocol. Define contracts (`[DEF]`, `@PRE`, `@POST`) BEFORE implementing logic.
+
+- [ ] T012 [P] [US1] Define contracts/scaffolding for [Entity1] in src/models/[entity1].py
+- [ ] T013 [P] [US1] Define contracts/scaffolding for [Entity2] in src/models/[entity2].py
+- [ ] T014 [P] [US1] Implement logic for [Entity1] in src/models/[entity1].py
+- [ ] T015 [P] [US1] Implement logic for [Entity2] in src/models/[entity2].py
+- [ ] T016 [US1] Define contracts/scaffolding for [Service] in src/services/[service].py
+- [ ] T017 [US1] Implement logic for [Service] in src/services/[service].py
+- [ ] T018 [US1] Define contracts/scaffolding for [endpoint/feature] in src/[location]/[file].py
+- [ ] T019 [US1] Implement logic for [endpoint/feature] in src/[location]/[file].py
+- [ ] T020 [US1] Verify semantic compliance and belief state logging
 
 **Checkpoint**: At this point, User Story 1 should be fully functional and testable independently
 
@@ -112,10 +117,13 @@ Examples of foundational tasks (adjust based on your project):
 
 ### Implementation for User Story 2
 
-- [ ] T020 [P] [US2] Create [Entity] model in src/models/[entity].py
-- [ ] T021 [US2] Implement [Service] in src/services/[service].py
-- [ ] T022 [US2] Implement [endpoint/feature] in src/[location]/[file].py
-- [ ] T023 [US2] Integrate with User Story 1 components (if needed)
+- [ ] T021 [P] [US2] Define contracts/scaffolding for [Entity] in src/models/[entity].py
+- [ ] T022 [P] [US2] Implement logic for [Entity] in src/models/[entity].py
+- [ ] T023 [US2] Define contracts/scaffolding for [Service] in src/services/[service].py
+- [ ] T024 [US2] Implement logic for [Service] in src/services/[service].py
+- [ ] T025 [US2] Define contracts/scaffolding for [endpoint/feature] in src/[location]/[file].py
+- [ ] T026 [US2] Implement logic for [endpoint/feature] in src/[location]/[file].py
+- [ ] T027 [US2] Integrate with User Story 1 components (if needed)
 
 **Checkpoint**: At this point, User Stories 1 AND 2 should both work independently
 
@@ -134,9 +142,12 @@ Examples of foundational tasks (adjust based on your project):
 
 ### Implementation for User Story 3
 
-- [ ] T026 [P] [US3] Create [Entity] model in src/models/[entity].py
-- [ ] T027 [US3] Implement [Service] in src/services/[service].py
-- [ ] T028 [US3] Implement [endpoint/feature] in src/[location]/[file].py
+- [ ] T028 [P] [US3] Define contracts/scaffolding for [Entity] in src/models/[entity].py
+- [ ] T029 [P] [US3] Implement logic for [Entity] in src/models/[entity].py
+- [ ] T030 [US3] Define contracts/scaffolding for [Service] in src/services/[service].py
+- [ ] T031 [US3] Implement logic for [Service] in src/services/[service].py
+- [ ] T032 [US3] Define contracts/scaffolding for [endpoint/feature] in src/[location]/[file].py
+- [ ] T033 [US3] Implement logic for [endpoint/feature] in src/[location]/[file].py
 
 **Checkpoint**: All user stories should now be independently functional
 
@@ -179,6 +190,7 @@ Examples of foundational tasks (adjust based on your project):
 ### Within Each User Story
 
 - Tests (if included) MUST be written and FAIL before implementation
+- **Contracts First**: Define module structure and contracts (`[DEF]`, `@PRE`, `@POST`) before logic
 - Models before services
 - Services before endpoints
 - Core implementation before integration
@@ -202,9 +214,9 @@ Examples of foundational tasks (adjust based on your project):
 Task: "Contract test for [endpoint] in tests/contract/test_[name].py"
 Task: "Integration test for [user journey] in tests/integration/test_[name].py"
 
-# Launch all models for User Story 1 together:
-Task: "Create [Entity1] model in src/models/[entity1].py"
-Task: "Create [Entity2] model in src/models/[entity2].py"
+# Launch all contracts for User Story 1 together:
+Task: "Define contracts/scaffolding for [Entity1] in src/models/[entity1].py"
+Task: "Define contracts/scaffolding for [Entity2] in src/models/[entity2].py"
 ```
 
 ---