chore: moving towards agentic development

docs/FEATURE_TEMPLATE.md

@@ -0,0 +1,61 @@
+# Feature Name
+
+## Status
+
+Proposed | Active | Deprecated
+
+## Goal
+
+One short paragraph describing the outcome this feature must produce.
+
+## Actors
+
+- Actor 1
+- Actor 2
+
+## Preconditions
+
+- precondition 1
+- precondition 2
+
+## Trigger
+
+What starts this flow.
+
+## Main Flow
+
+1. User or system does something.
+2. System validates.
+3. System stores or updates state.
+4. System emits responses, events, or notifications.
+
+## Alternate Flows
+
+- validation failure
+- unauthorized actor
+- missing dependency
+
+## Business Rules
+
+- rule 1
+- rule 2
+
+## Data / Entities
+
+- entity 1
+- entity 2
+
+## API / UI Surface
+
+- frontend routes
+- backend endpoints
+- roles or permissions
+
+## Acceptance Criteria
+
+- [ ] criterion 1
+- [ ] criterion 2
+
+## Open Questions
+
+- question 1