#[Feature Name]

#Context

What the source document/requirements describe for this feature. Include:

• User stories or requirements
• Business context
• Expected behavior

---

#Current State

What exists today in the codebase.

Key Files:

• path/to/file1.ts - Description
• path/to/file2.tsx - Description

---

#Gap Analysis

Feature	Required	Current	Gap
Feature 1	Yes	Missing	FAIL
Feature 2	Yes	Partial	FAIL
Feature 3	Yes	Exists	PASS

---

#Challenges

#Challenge X.1: [Challenge Name]

Requirement: Statement of what must be true for this challenge to pass.

Acceptance Criteria:

• Criterion 1
• Criterion 2
• Criterion 3

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.2: [Challenge Name]

Requirement: [Statement]

Acceptance Criteria:

• Criterion 1
• Criterion 2

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.3: [Challenge Name]

Requirement: [Statement]

Acceptance Criteria:

• Criterion 1
• Criterion 2

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.4: [Challenge Name]

Requirement: [Statement]

Acceptance Criteria:

• Criterion 1
• Criterion 2

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.5: [Challenge Name]

Requirement: [Statement]

Acceptance Criteria:

• Criterion 1
• Criterion 2

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.6: [Challenge Name]

Requirement: [Statement]

Acceptance Criteria:

• Criterion 1
• Criterion 2

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Quality Tier Challenges (A+ Grade Requirements)

#Challenge X.7: Accessibility Compliance

Requirement: Feature meets WCAG 2.1 AA accessibility standards.

Acceptance Criteria:

• Keyboard navigation fully functional
• Screen reader announcements for state changes
• Color contrast ratios verified (4.5:1 text, 3:1 UI)
• ARIA labels on all interactive elements

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.8: Motion Performance

Requirement: Animations are performant and respect user preferences.

Acceptance Criteria:

• No layout shift (CLS = 0)
• Animations run at 60fps
• Respects prefers-reduced-motion
• Animation timing uses design tokens

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.9: Test Coverage

Requirement: Feature has comprehensive test coverage.

Acceptance Criteria:

• Unit tests for all functions
• Integration tests for user flows
• Storybook stories for all variants
• Edge cases tested

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Challenge X.10: Design Token Alignment

Requirement: All styling uses design tokens.

Acceptance Criteria:

• All colors use CSS custom properties
• All spacing uses token scale
• All motion uses motion tokens
• Typography follows token rhythm

Evaluation: [ ] PENDING | [ ] PASS | [ ] FAIL

Notes:

---

#Evaluation Summary

#Functional Challenges (X.1-X.6)

Challenge	Result
X.1 [Name]	PENDING
X.2 [Name]	PENDING
X.3 [Name]	PENDING
X.4 [Name]	PENDING
X.5 [Name]	PENDING
X.6 [Name]	PENDING

Functional Score: 0/6 PASS

#Quality Tier Challenges (X.7-X.10)

Challenge	Result
X.7 Accessibility Compliance	PENDING
X.8 Motion Performance	PENDING
X.9 Test Coverage	PENDING
X.10 Design Token Alignment	PENDING

Quality Score: 0/4 PASS

#Overall Status

Total Score: 0/10 PASS

Grade: PENDING

---

#Schema Impact

#New Tables

-- Example table structure
CREATE TABLE example_table (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  user_id UUID NOT NULL REFERENCES profiles(id) ON DELETE CASCADE,
  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

#Existing Tables to Modify

Table	Changes
table_name	Add column X

---

#UI Components

#New Components

Component	Location	Purpose
ComponentName	packages/ui/src/components/	Description

#Existing Components to Modify

Component	Changes
ExistingComponent	Add prop X

---

#API Endpoints

Method	Endpoint	Purpose
GET	/api/resource	List resources
POST	/api/resource	Create resource

---

#Implementation Notes

#Design Decisions

1. Decision 1: Rationale
2. Decision 2: Rationale

#Integration Points

• Integration point 1
• Integration point 2

#Dependencies

• Dependency 1
• Dependency 2

---

#Related Documents