ctx-cc 2.1.0 → 2.3.0

package/templates/DESIGN_BRIEF.md

@@ -0,0 +1,163 @@
+# Design Brief - {{component_name}}
+
+## Component: {{component_name}}
+**Story:** {{story_id}}
+**Created:** {{timestamp}}
+**Approved:** {{approval_date}}
+**WCAG Level:** 2.2 AA
+**EAA 2025:** {{eaa_compliant}}
+
+---
+
+## Visual Direction
+
+### Brand Reference
+- Brand Kit: BRAND_KIT.md v{{brand_version}}
+- Mood board: .ctx/phases/{{story_id}}/MOOD_BOARD.md
+- Selected: Option {{selected_option}} {{modifications}}
+
+### Design Constraints
+| Constraint | Value |
+|------------|-------|
+| Primary Colors | {{color_palette}} |
+| Typography | {{typography}} |
+| Spacing | {{spacing_tokens}} |
+| Border Radius | {{radius_tokens}} |
+
+---
+
+## Design Decisions
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| Layout | {{layout_choice}} | {{layout_why}} |
+| Colors | {{color_choice}} | {{color_why}} |
+| Typography | {{type_choice}} | {{type_why}} |
+| Spacing | {{spacing_choice}} | {{spacing_why}} |
+| Motion | {{motion_choice}} | {{motion_why}} |
+
+---
+
+## Component States
+
+| State | Description | Visual Treatment |
+|-------|-------------|------------------|
+| Default | Normal state | {{default_treatment}} |
+| Hover | Mouse over | {{hover_treatment}} |
+| Focus | Keyboard focus | {{focus_treatment}} |
+| Active | Being pressed | {{active_treatment}} |
+| Disabled | Not interactive | {{disabled_treatment}} |
+| Loading | Async operation | {{loading_treatment}} |
+| Error | Invalid state | {{error_treatment}} |
+
+---
+
+## Responsive Behavior
+
+| Breakpoint | Width | Behavior |
+|------------|-------|----------|
+| Mobile | < 768px | {{mobile_behavior}} |
+| Tablet | 768-1024px | {{tablet_behavior}} |
+| Desktop | > 1024px | {{desktop_behavior}} |
+
+---
+
+## Accessibility Implementation
+
+### WCAG 2.2 Compliance
+
+| Criterion | Requirement | Implementation |
+|-----------|-------------|----------------|
+| 2.4.7 Focus Visible | Focus indicator visible | {{focus_impl}} |
+| 2.4.11 Focus Not Obscured | Focused element visible | {{obscured_impl}} |
+| 2.5.7 Dragging | Click alternative | {{drag_impl}} |
+| 2.5.8 Target Size | 24x24px minimum | {{target_impl}} |
+| 3.3.8 Authentication | No cognitive tests | {{auth_impl}} |
+
+### Keyboard Navigation
+
+| Key | Action |
+|-----|--------|
+| Tab | {{tab_action}} |
+| Enter | {{enter_action}} |
+| Space | {{space_action}} |
+| Escape | {{escape_action}} |
+| Arrow Keys | {{arrow_action}} |
+
+### Screen Reader
+
+| Element | ARIA | Announcement |
+|---------|------|--------------|
+| {{element_1}} | {{aria_1}} | {{announce_1}} |
+| {{element_2}} | {{aria_2}} | {{announce_2}} |
+
+---
+
+## Approval History
+
+| Stage | Date | Approved | Notes |
+|-------|------|----------|-------|
+| Mood board | {{mood_date}} | {{mood_approved}} | {{mood_notes}} |
+| Direction (A/B/C) | {{dir_date}} | Option {{dir_choice}} | {{dir_notes}} |
+| Prototype | {{proto_date}} | {{proto_approved}} | {{proto_notes}} |
+| Final | {{final_date}} | {{final_approved}} | {{final_notes}} |
+
+---
+
+## Implementation Files
+
+| Artifact | Path |
+|----------|------|
+| Component | {{component_path}} |
+| Styles | {{styles_path}} |
+| Story | {{story_path}} |
+| Tests | {{tests_path}} |
+
+---
+
+## Figma Reference
+
+{{#if figma_link}}
+- File: {{figma_link}}
+- Node: {{figma_node}}
+{{else}}
+No Figma file linked.
+{{/if}}
+
+---
+
+## Screenshots
+
+| Viewport | Screenshot |
+|----------|------------|
+| Mobile | .ctx/phases/{{story_id}}/mobile.png |
+| Tablet | .ctx/phases/{{story_id}}/tablet.png |
+| Desktop | .ctx/phases/{{story_id}}/desktop.png |
+
+---
+
+## Verification Checklist
+
+### Visual
+- [ ] Matches approved prototype
+- [ ] All states implemented
+- [ ] Responsive at all breakpoints
+- [ ] Uses brand tokens (no hardcoded values)
+
+### Accessibility
+- [ ] Focus visible (2px ring, 3:1 contrast)
+- [ ] Target size >= 24x24px
+- [ ] Keyboard navigable
+- [ ] Screen reader tested
+- [ ] No color-only information
+
+### Technical
+- [ ] No console errors
+- [ ] Tests pass
+- [ ] Storybook story created
+- [ ] No TODO comments
+
+---
+
+**This brief documents all design decisions for {{component_name}}.**
+**Any deviations require approval update.**

package/templates/PRD.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://ctx.dev/schemas/prd.json",
+  "version": "2.1",
+  "project": {
+    "name": "{{project_name}}",
+    "description": "{{project_description}}",
+    "stack": "{{tech_stack}}",
+    "created": "{{timestamp}}"
+  },
+  "context": {
+    "problem": "{{what_problem_are_we_solving}}",
+    "targetUser": "{{who_is_this_for}}",
+    "successLooksLike": "{{how_will_we_know_its_done}}",
+    "outOfScope": [
+      "{{what_we_are_NOT_building}}"
+    ],
+    "assumptions": [
+      "{{assumption_1}}",
+      "{{assumption_2}}"
+    ],
+    "risks": [
+      "{{risk_1}}"
+    ]
+  },
+  "brand": {
+    "hasBrandKit": false,
+    "personality": [],
+    "visualMood": "",
+    "inspirations": [],
+    "antiInspirations": [],
+    "existingAssets": [],
+    "darkModeRequired": false,
+    "euMarket": false
+  },
+  "design": {
+    "wcagLevel": "AA",
+    "eaaCompliance": false,
+    "tokenFormat": "w3c",
+    "figmaFileKey": null,
+    "designSystem": null,
+    "breakpoints": {
+      "mobile": 375,
+      "tablet": 768,
+      "desktop": 1440
+    }
+  },
+  "constitution": {
+    "principles": [
+      "Code quality over speed",
+      "Test before ship",
+      "No secrets in code"
+    ],
+    "always": [
+      "Run tests before committing",
+      "Use TypeScript strict mode",
+      "Handle errors explicitly"
+    ],
+    "never": [
+      "Commit secrets or credentials",
+      "Skip error handling",
+      "Leave TODO comments in production"
+    ],
+    "askFirst": [
+      "Database schema changes",
+      "New dependencies",
+      "API contract changes"
+    ]
+  },
+  "testing": {
+    "requiresBrowser": false,
+    "requiresLogin": false,
+    "requiresAdmin": false,
+    "requiresAPI": false,
+    "notes": "{{testing_notes}}"
+  },
+  "storyTypes": {
+    "feature": "Standard implementation story",
+    "brand": "Brand kit establishment (BRAND_KIT.md + tokens)",
+    "design": "UI component/page design with approval gates",
+    "fix": "Bug fix or correction",
+    "refactor": "Code improvement without behavior change"
+  },
+  "stories": [
+    {
+      "id": "S001",
+      "type": "feature",
+      "title": "{{story_title}}",
+      "description": "{{story_description}}",
+      "acceptanceCriteria": [
+        "{{criterion_1}}",
+        "{{criterion_2}}",
+        "{{criterion_3}}"
+      ],
+      "priority": 1,
+      "phase": 1,
+      "passes": false,
+      "verifiedAt": null,
+      "notes": "",
+      "design": null
+    }
+  ],
+  "metadata": {
+    "totalStories": 0,
+    "passedStories": 0,
+    "currentStory": null,
+    "lastUpdated": "{{timestamp}}"
+  }
+}

package/templates/STATE.md

@@ -8,11 +8,21 @@
 - **Stack**: {{tech_stack}}
 - **Status**: {{status}} <!-- initializing | planning | executing | debugging | verifying | paused -->
 
+## PRD Progress
+- **Stories**: {{passed_stories}}/{{total_stories}} ({{percent}}%)
+- **Current Story**: {{story_id}} - {{story_title}}
+
 ## Current Phase
-- **ID**: {{phase_id}}
-- **Goal**: {{phase_goal}}
+- **ID**: {{phase_id}} (maps to story {{story_id}})
+- **Goal**: {{story_title}}
 - **Progress**: {{completed_tasks}}/{{total_tasks}} tasks
 
+## Acceptance Criteria (from PRD)
+<!-- Current story's acceptance criteria -->
+- [ ] {{criterion_1}}
+- [ ] {{criterion_2}}
+- [ ] {{criterion_3}}
+
 ## Active Task
 - **Task**: {{current_task}}
 - **Status**: {{task_status}} <!-- pending | in_progress | blocked | debugging | done -->

package/templates/ctx.gitignore

@@ -0,0 +1,19 @@
+# CTX Secrets - NEVER COMMIT
+.env
+*.env
+.env.*
+!.env.example
+
+# Credential files
+credentials.json
+secrets.json
+*.secrets
+*.pem
+*.key
+
+# Debug screenshots may contain sensitive data
+debug/*.png
+debug/*.jpg
+
+# Checkpoint data may contain state
+checkpoints/*.json

package/templates/env.template

@@ -0,0 +1,61 @@
+# CTX Test Credentials
+# Generated by /ctx init
+# WARNING: DO NOT COMMIT THIS FILE
+
+# ===========================================
+# APP CONFIGURATION
+# ===========================================
+
+# Local development URL
+APP_URL=http://localhost:3000
+
+# Staging/preview URL (optional)
+STAGING_URL=
+
+# Production URL (optional - for smoke tests)
+PRODUCTION_URL=
+
+# ===========================================
+# TEST USER CREDENTIALS
+# ===========================================
+
+# Primary test user (for normal user flows)
+TEST_USER_EMAIL=
+TEST_USER_PASSWORD=
+
+# Admin user (for admin features)
+ADMIN_EMAIL=
+ADMIN_PASSWORD=
+
+# Secondary test user (for multi-user tests)
+TEST_USER_2_EMAIL=
+TEST_USER_2_PASSWORD=
+
+# ===========================================
+# API KEYS & TOKENS
+# ===========================================
+
+# Primary API key (if applicable)
+API_KEY=
+
+# OAuth tokens (if applicable)
+OAUTH_CLIENT_ID=
+OAUTH_CLIENT_SECRET=
+
+# Third-party service keys
+# STRIPE_TEST_KEY=
+# SENDGRID_API_KEY=
+# AWS_ACCESS_KEY_ID=
+# AWS_SECRET_ACCESS_KEY=
+
+# ===========================================
+# DATABASE (if direct DB testing needed)
+# ===========================================
+
+DATABASE_URL=
+
+# ===========================================
+# CUSTOM SECRETS
+# Add project-specific secrets below
+# ===========================================
+