@aslomon/effectum 0.1.0

package/workshop/templates/prd.md

@@ -0,0 +1,133 @@
+# PRD: [Feature Name]
+
+## Problem
+
+[2-4 sentences. What is the problem? Why does it need to be solved? Who is affected? Include business context.]
+
+## Goal
+
+[1-3 sentences. What should work when this is done? Include measurable success criteria.]
+
+## User Stories
+
+- As a [role], I want to [action], so that [benefit]
+- As a [role], I want to [action], so that [benefit]
+- As a [role], I want to [action], so that [benefit]
+
+## Acceptance Criteria
+
+- [ ] AC1: [Concrete, testable criterion]
+- [ ] AC2: [Concrete, testable criterion]
+- [ ] AC3: Given [precondition], When [action], Then [expected result]
+- [ ] AC4: Given [precondition], When [action], Then [expected result]
+
+## Scope
+
+### In Scope
+
+- [Feature/component being built]
+- [Feature/component being built]
+
+### Out of Scope
+
+- [Explicit exclusion]
+- [Explicit exclusion]
+
+### Non-Goals
+
+- [Something someone might expect, but is intentionally excluded]
+
+## Data Model
+
+### [table_name]
+
+| Column     | Type        | Constraints                     | Description           |
+| ---------- | ----------- | ------------------------------- | --------------------- |
+| id         | uuid        | PK, default gen_random_uuid()   | Primary key           |
+| org_id     | uuid        | FK → organizations.id, NOT NULL | Tenant isolation      |
+| [field]    | [type]      | [constraints]                   | [description]         |
+| created_at | timestamptz | NOT NULL, default now()         | Creation timestamp    |
+| updated_at | timestamptz | NOT NULL, default now()         | Last update timestamp |
+
+### Relations
+
+- [table_a] belongs to [table_b] via [foreign_key]
+
+### RLS Policies
+
+- [table_name]: [policy description]
+
+### Indexes
+
+- [table_name]: [index description]
+
+## API Design
+
+### [HTTP_METHOD] /api/[resource]
+
+**Purpose:** [What this endpoint does]
+
+**Authentication:** Required / Public
+
+**Request:**
+
+```json
+{
+  "field": "type — description"
+}
+```
+
+**Response (200):**
+
+```json
+{
+  "data": {}
+}
+```
+
+**Error Responses:**
+
+- 400: [When and why]
+- 401: [When and why]
+- 403: [When and why]
+- 404: [When and why]
+
+## UI/UX
+
+- [Layout description or Figma link]
+- [Responsive requirements]
+- [Key interaction patterns]
+- [Empty states, loading states, error states]
+
+## Constraints
+
+- Performance: [requirements]
+- Dependencies: [external services, existing features]
+- Security: [specific requirements]
+
+## Quality Gates
+
+Automated checks that MUST pass before the feature is considered done:
+
+- Build: `pnpm build` — 0 errors
+- Types: `tsc --noEmit` — 0 errors
+- Tests: `pnpm vitest run` — all pass, 80%+ coverage on new code
+- Lint: `pnpm lint` — 0 errors, 0 warnings
+- E2E: `npx playwright test` — all pass (if applicable)
+- Security: `/code-review` — no OWASP vulnerabilities
+- RLS: Supabase security advisor — no warnings (if DB changes)
+- No Debug Logs: 0 `console.log` in production code
+- Type Safety: no `any`, no `as` casts in new code
+- File Size: no file exceeds 300 lines
+- Custom: [project-specific checks]
+
+## Autonomy Rules
+
+- Design: [Follow DESIGN.md / use best judgment / ask]
+- Libraries: [use existing dependencies only / free to add]
+- Architecture: [follow existing patterns in src/lib/ / free to decide]
+- On ambiguity: [decide autonomously and document / stop and ask]
+
+## Completion Promise
+
+"[All acceptance criteria met, build passes, all tests pass, 0 lint errors, no console.log in production code]"

package/workshop/templates/requirements-map.md

@@ -0,0 +1,48 @@
+# Requirements Map: [Project Name]
+
+## v1 (Must-Have)
+
+| ID    | Requirement               | PRD       | Priority | Status  |
+| ----- | ------------------------- | --------- | -------- | ------- |
+| R-001 | [Requirement description] | [PRD-NNN] | P0       | planned |
+| R-002 | [Requirement description] | [PRD-NNN] | P0       | planned |
+| R-003 | [Requirement description] | [PRD-NNN] | P1       | planned |
+| R-004 | [Requirement description] | [PRD-NNN] | P1       | planned |
+
+## v2 (Nice-to-Have)
+
+| ID    | Requirement               | PRD       | Priority | Status  |
+| ----- | ------------------------- | --------- | -------- | ------- |
+| R-010 | [Requirement description] | [PRD-NNN] | P2       | planned |
+| R-011 | [Requirement description] | [PRD-NNN] | P2       | planned |
+
+## v3 (Future)
+
+| ID    | Requirement               | PRD       | Priority | Status  |
+| ----- | ------------------------- | --------- | -------- | ------- |
+| R-020 | [Requirement description] | [PRD-NNN] | P3       | planned |
+
+## Out of Scope
+
+- [Explicit exclusion 1]
+- [Explicit exclusion 2]
+- [Explicit exclusion 3]
+
+## Priority Legend
+
+| Priority | Meaning                                     |
+| -------- | ------------------------------------------- |
+| P0       | Must-have for launch. Blocks release.       |
+| P1       | Should-have. Important but not blocking.    |
+| P2       | Nice-to-have. Defer if time-constrained.    |
+| P3       | Future consideration. Not in current scope. |
+
+## Status Legend
+
+| Status      | Meaning                     |
+| ----------- | --------------------------- |
+| planned     | Not yet started             |
+| in-progress | Currently being implemented |
+| done        | Implemented and verified    |
+| deferred    | Moved to a later version    |
+| cut         | Removed from scope          |

package/workshop/templates/shared-contracts.md

@@ -0,0 +1,89 @@
+# Shared Contracts: [Project Name]
+
+Defines shared data models and API contracts between PRDs. Each model/endpoint has a single owner PRD. Other PRDs consume but do not modify.
+
+---
+
+## Shared Data Models
+
+### [Model Name] (owned by PRD-[NNN], consumed by [list])
+
+| Field      | Type        | Used By    | Description           |
+| ---------- | ----------- | ---------- | --------------------- |
+| id         | uuid        | all        | Primary key           |
+| org_id     | uuid        | all        | Tenant isolation      |
+| [field]    | [type]      | [PRD list] | [description]         |
+| created_at | timestamptz | all        | Creation timestamp    |
+| updated_at | timestamptz | all        | Last update timestamp |
+
+**Rules:**
+
+- Only PRD-[NNN] may add columns or modify the table schema
+- Consumers may read via RLS-protected queries
+- Schema changes require updating this contract and notifying consumers
+
+### [Model Name] (owned by PRD-[NNN], consumed by [list])
+
+| Field   | Type   | Used By    | Description   |
+| ------- | ------ | ---------- | ------------- |
+| id      | uuid   | all        | Primary key   |
+| [field] | [type] | [PRD list] | [description] |
+
+---
+
+## Shared API Contracts
+
+### [HTTP_METHOD] /api/[resource]
+
+- **Owner:** PRD-[NNN]
+- **Consumers:** PRD-[NNN], PRD-[NNN]
+- **Authentication:** Required
+- **Purpose:** [What this endpoint provides]
+
+**Response shape:**
+
+```json
+{
+  "data": {
+    "id": "uuid",
+    "[field]": "[type]"
+  }
+}
+```
+
+**Contract rules:**
+
+- Response shape must not change without updating this document
+- New optional fields may be added (backward compatible)
+- Required fields must not be removed or renamed
+
+### [HTTP_METHOD] /api/[resource]
+
+- **Owner:** PRD-[NNN]
+- **Consumers:** PRD-[NNN]
+- **Purpose:** [What this endpoint provides]
+
+**Response shape:**
+
+```json
+{
+  "data": {}
+}
+```
+
+---
+
+## Shared Events (if using Realtime/Webhooks)
+
+| Event Name   | Producer  | Consumers            | Payload            |
+| ------------ | --------- | -------------------- | ------------------ |
+| [event.name] | PRD-[NNN] | PRD-[NNN], PRD-[NNN] | `{ id, [fields] }` |
+
+---
+
+## Contract Change Process
+
+1. Owner PRD proposes change in this document
+2. All consumer PRDs are listed and reviewed
+3. Breaking changes require version bump or migration plan
+4. Non-breaking additions (new optional fields) can be made directly

package/workshop/templates/vision.md

@@ -0,0 +1,66 @@
+# Project Vision: [Project Name]
+
+## Problem
+
+[2-3 sentences: What problem are we solving? Who is affected?]
+
+## Goal
+
+[1-2 sentences: What does success look like? How will we measure it?]
+
+## Target Users
+
+- **[Persona 1]:** [role, goal, context]
+- **[Persona 2]:** [role, goal, context]
+- **[Persona 3]:** [role, goal, context]
+
+## Tech Stack
+
+- Frontend: [framework, UI library]
+- Backend: [framework/platform]
+- Database: [database]
+- Auth: [provider]
+- Hosting: [platform]
+- Other: [additional services]
+
+## Constraints
+
+- [Timeline constraints]
+- [Budget constraints]
+- [Regulatory/compliance requirements]
+- [Technical constraints]
+
+## PRD Overview
+
+| PRD | Name   | Description         | Dependencies |
+| --- | ------ | ------------------- | ------------ |
+| 001 | [Name] | [Brief description] | None         |
+| 002 | [Name] | [Brief description] | 001          |
+| 003 | [Name] | [Brief description] | 001, 002     |
+| 004 | [Name] | [Brief description] | 001          |
+
+## Dependency Graph
+
+```
+001-[Name] ──► 002-[Name] ──► 003-[Name]
+    │
+    └──────────────────────► 004-[Name]
+```
+
+## Roadmap
+
+| Phase | PRDs     | Milestone                         | Estimated Effort |
+| ----- | -------- | --------------------------------- | ---------------- |
+| 1     | 001      | [What is usable after this phase] | [size]           |
+| 2     | 002, 003 | [What is usable after this phase] | [size]           |
+| 3     | 004      | [What is usable after this phase] | [size]           |
+
+## Non-Goals
+
+- [What we are explicitly NOT building]
+- [What someone might expect but is excluded]
+
+## Open Questions
+
+- [Question 1]
+- [Question 2]