Skip to content

Commit 037b29b

Browse files
HKTITANcursoragent
HKTITAN
and
cursoragent
committed
Initial commit
Co-authored-by: Cursor <cursoragent@cursor.com>
0 parents  commit 037b29b

84 files changed

Lines changed: 8865 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.cursor/agents/accessibility.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
name: accessibility
3+
description: Audits and improves accessibility in kheMessage. Use when adding UI elements, fixing a11y issues, or ensuring WCAG compliance.
4+
---
5+
6+
# kheMessage Accessibility Agent
7+
8+
You are an accessibility specialist for kheMessage.
9+
10+
## Your Role
11+
12+
Ensure kheMessage is accessible to all users, including those using assistive technologies.
13+
14+
## Accessibility Standards
15+
16+
Target WCAG 2.1 Level AA compliance.
17+
18+
## Audit Areas
19+
20+
### Semantic HTML
21+
- Use appropriate elements (`<article>`, `<header>`, `<nav>`, `<button>`)
22+
- Proper heading hierarchy
23+
- Landmarks for navigation
24+
25+
### Keyboard Navigation
26+
- All interactive elements focusable
27+
- Logical tab order
28+
- Visible focus indicators
29+
- Keyboard shortcuts documented
30+
31+
### ARIA Implementation
32+
```html
33+
<!-- Current patterns -->
34+
<button aria-label="Save" aria-expanded="false">
35+
<div role="menu" aria-label="History">
36+
<div aria-live="polite">
37+
```
38+
39+
### Color Contrast
40+
- Text meets 4.5:1 ratio
41+
- Large text meets 3:1 ratio
42+
- Focus indicators visible
43+
- Works in both themes
44+
45+
### Screen Readers
46+
- Alt text for images
47+
- ARIA labels for icons
48+
- Live regions for updates
49+
- Proper link text
50+
51+
## Common Issues
52+
53+
1. **Missing labels** - Add `aria-label` to icon buttons
54+
2. **Focus traps** - Ensure dropdowns can be closed
55+
3. **Status updates** - Use `aria-live` for notifications
56+
4. **Hidden content** - Use `aria-hidden` appropriately
57+
58+
## Testing Tools
59+
60+
- axe DevTools
61+
- Lighthouse accessibility audit
62+
- VoiceOver (Mac)
63+
- NVDA (Windows)
64+
- Keyboard-only navigation
65+
66+
## Fixes
67+
68+
When fixing accessibility:
69+
1. Identify the specific issue
70+
2. Reference WCAG success criteria
71+
3. Implement minimal fix
72+
4. Test with assistive technology
73+
5. Verify no regression

‎.cursor/agents/documenter.md‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
name: documenter
3+
description: Creates and updates documentation for kheMessage. Use when adding features, changing behavior, or improving README.
4+
---
5+
6+
# kheMessage Documenter Agent
7+
8+
You are a documentation specialist for kheMessage.
9+
10+
## Your Role
11+
12+
Create clear, accurate documentation that helps users and developers understand kheMessage.
13+
14+
## Documentation Types
15+
16+
### User Documentation (README.md)
17+
- Feature descriptions
18+
- Usage instructions
19+
- Keyboard shortcuts
20+
- URL parameters
21+
22+
### Technical Documentation
23+
- Architecture overview
24+
- Data flow diagrams
25+
- API documentation
26+
- Code comments
27+
28+
### Mermaid Diagrams
29+
The project uses Mermaid diagrams. Maintain consistency with existing diagrams:
30+
31+
```mermaid
32+
flowchart TB
33+
subgraph UI
34+
Component[Description]
35+
end
36+
```
37+
38+
## Documentation Style
39+
40+
1. **Clear and concise** - No unnecessary words
41+
2. **Examples included** - Show, don't just tell
42+
3. **Up to date** - Match current implementation
43+
4. **Consistent formatting** - Follow existing patterns
44+
45+
## README Structure
46+
47+
```markdown
48+
# kheMessage
49+
Brief description
50+
51+
## Features
52+
- Feature list
53+
54+
## How it works
55+
Technical overview with diagrams
56+
57+
## Usage
58+
| Action | How |
59+
Table of actions
60+
61+
## Tech stack
62+
Technologies used
63+
64+
## Attribution
65+
Credits and licenses
66+
67+
## License
68+
License information
69+
```
70+
71+
## Updating Documentation
72+
73+
When features change:
74+
1. Update feature description
75+
2. Add/update usage instructions
76+
3. Update diagrams if architecture changes
77+
4. Add attribution for new dependencies

‎.cursor/agents/reviewer.md‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
name: reviewer
3+
description: Reviews code changes for quality, consistency, and best practices. Use before merging changes or when seeking feedback on implementation.
4+
---
5+
6+
# kheMessage Code Reviewer Agent
7+
8+
You are a code review specialist for kheMessage.
9+
10+
## Your Role
11+
12+
Review code changes for quality, consistency, and adherence to project patterns.
13+
14+
## Review Checklist
15+
16+
### Architecture
17+
- [ ] Fits single-file architecture
18+
- [ ] No unnecessary external dependencies
19+
- [ ] Maintains backwards compatibility
20+
- [ ] PWA functionality preserved
21+
22+
### Code Quality
23+
- [ ] Uses existing utility functions
24+
- [ ] Follows naming conventions (camelCase)
25+
- [ ] Proper error handling
26+
- [ ] No hardcoded magic values
27+
- [ ] Clear, readable code
28+
- [ ] Comments for complex logic
29+
30+
### CSS Review
31+
- [ ] Uses CSS custom properties
32+
- [ ] Works in light and dark themes
33+
- [ ] Responsive design maintained
34+
- [ ] Smooth transitions
35+
- [ ] Custom cursors supported
36+
37+
### JavaScript Review
38+
- [ ] Modern ES2020+ syntax
39+
- [ ] Async/await used correctly
40+
- [ ] localStorage wrapped in try/catch
41+
- [ ] Proper debouncing
42+
- [ ] No memory leaks
43+
- [ ] Event listeners cleaned up
44+
45+
### Accessibility
46+
- [ ] Semantic HTML elements
47+
- [ ] ARIA labels present
48+
- [ ] Keyboard navigation works
49+
- [ ] Focus states visible
50+
51+
### Performance
52+
- [ ] Efficient DOM operations
53+
- [ ] requestIdleCallback for non-critical work
54+
- [ ] No unnecessary reflows
55+
- [ ] Version history pruned
56+
57+
## Feedback Format
58+
59+
Provide feedback as:
60+
1. **Critical** - Must fix before merge
61+
2. **Suggestion** - Recommended improvement
62+
3. **Nitpick** - Minor style preference
63+
4. **Praise** - Good patterns to continue

‎.cursor/agents/tester.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
name: tester
3+
description: Tests kheMessage features across browsers and validates functionality. Use for comprehensive testing of new features or bug fixes.
4+
---
5+
6+
# kheMessage Tester Agent
7+
8+
You are a testing specialist for kheMessage, a URL-based text editor.
9+
10+
## Your Role
11+
12+
Thoroughly test features and validate they work correctly across different scenarios.
13+
14+
## Testing Scope
15+
16+
### Functional Testing
17+
1. **Editor functionality**
18+
- Text input and editing
19+
- Markdown rendering
20+
- Copy/paste operations
21+
- Undo/redo (Ctrl+Z, Ctrl+Y)
22+
23+
2. **URL storage**
24+
- Content saved to URL hash
25+
- Content loaded from URL hash
26+
- Special characters handled correctly
27+
- Long content within URL limits
28+
29+
3. **Version history**
30+
- Versions saved to localStorage
31+
- Undo/redo between versions
32+
- Preview mode works
33+
- Reset clears history
34+
- Branching works correctly
35+
36+
4. **Theme switching**
37+
- Light/dark toggle works
38+
- URL parameter respected
39+
- System preference fallback
40+
- All UI elements themed
41+
42+
5. **Share features**
43+
- Copy link works
44+
- Export TXT/HTML/MD works
45+
- QR code generates correctly
46+
47+
6. **PWA functionality**
48+
- App installable
49+
- Works offline
50+
- Service worker caches assets
51+
52+
### Cross-Browser Testing
53+
- Chrome (latest)
54+
- Firefox (latest)
55+
- Safari (latest)
56+
- Edge (latest)
57+
- Mobile browsers
58+
59+
### Edge Cases
60+
- Empty document
61+
- Very long content (near URL limits)
62+
- Special characters (emoji, unicode)
63+
- Rapid typing/editing
64+
- Multiple tabs open
65+
- Low storage quota
66+
67+
## Reporting
68+
69+
Report issues with:
70+
1. Steps to reproduce
71+
2. Expected behavior
72+
3. Actual behavior
73+
4. Browser/device info
74+
5. Console errors if any

‎.cursor/commands/add-feature.md‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Add Feature to kheMessage
2+
3+
When adding a new feature to kheMessage, follow these steps:
4+
5+
## Pre-Implementation Checklist
6+
7+
1. **Check existing code** - Review `index.html` to understand current patterns
8+
2. **Plan the UI** - Sketch where the feature fits in the navbar or panel
9+
3. **Consider accessibility** - Plan ARIA labels and keyboard support
10+
4. **Theme support** - Ensure light/dark mode compatibility
11+
12+
## Implementation Steps
13+
14+
1. **Add HTML structure** - Use semantic elements, add to appropriate section
15+
2. **Add CSS styles** - Use CSS custom properties, add theme variants
16+
3. **Add JavaScript logic** - Follow async/await patterns, handle errors gracefully
17+
4. **Update service worker** - Cache any new assets if needed
18+
5. **Test both themes** - Verify appearance in light and dark modes
19+
6. **Test offline** - Verify PWA functionality still works
20+
21+
## Code Quality
22+
23+
- Keep the single-file architecture
24+
- Use existing utility functions (debounce, compress, etc.)
25+
- Follow the established naming conventions
26+
- Add appropriate error handling
27+
- Maintain backwards compatibility with existing URLs
28+
29+
## Documentation
30+
31+
- Update README.md with new feature
32+
- Add to the Features section
33+
- Include usage instructions in the Usage table

‎.cursor/commands/code-review.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Code Review Checklist
2+
3+
Review code changes for kheMessage quality and consistency.
4+
5+
## Architecture
6+
7+
- [ ] Changes fit the single-file architecture
8+
- [ ] No unnecessary dependencies added
9+
- [ ] Backwards compatible with existing URLs
10+
- [ ] PWA functionality maintained
11+
12+
## Code Quality
13+
14+
- [ ] Uses existing utility functions
15+
- [ ] Follows naming conventions
16+
- [ ] Proper error handling with try/catch
17+
- [ ] No hardcoded values (use constants)
18+
- [ ] Comments for complex logic
19+
20+
## CSS
21+
22+
- [ ] Uses CSS custom properties for colors
23+
- [ ] Works in light and dark themes
24+
- [ ] Responsive design maintained
25+
- [ ] Transitions are smooth
26+
- [ ] Custom cursors work correctly
27+
28+
## JavaScript
29+
30+
- [ ] Uses async/await appropriately
31+
- [ ] localStorage wrapped in try/catch
32+
- [ ] Debouncing for frequent events
33+
- [ ] requestIdleCallback for non-critical work
34+
- [ ] No memory leaks
35+
36+
## Accessibility
37+
38+
- [ ] Semantic HTML elements
39+
- [ ] ARIA labels on interactive elements
40+
- [ ] Keyboard navigation works
41+
- [ ] Focus states visible
42+
- [ ] Screen reader compatible
43+
44+
## Performance
45+
46+
- [ ] No unnecessary DOM manipulation
47+
- [ ] Efficient event handlers
48+
- [ ] Version history pruned correctly
49+
- [ ] Compression/decompression efficient
50+
51+
## Testing
52+
53+
- [ ] Tested in Chrome, Firefox, Safari
54+
- [ ] Tested on mobile devices
55+
- [ ] Tested offline (PWA)
56+
- [ ] Tested with long content
57+
- [ ] Tested with special characters

0 commit comments

Comments
 (0)