npm - codingwithagent - Versions diffs - 1.0.0 - Mend

codingwithagent 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

package/LICENSE +21 -0
package/README.md +37 -0
package/bin/init.js +257 -0
package/package.json +56 -0
package/templates/accessibility/.cursorrules +342 -0
package/templates/accessibility/README.md +47 -0
package/templates/antigravity/accessibility/.agent/rules/accessibility.md +501 -0
package/templates/antigravity/accessibility/.agent/rules/aria-patterns.md +568 -0
package/templates/antigravity/accessibility/.agent/rules/wcag-standard.md +225 -0
package/templates/antigravity/accessibility/README.md +42 -0
package/templates/antigravity/minimal/.agent/rules/accessibility.md +53 -0
package/templates/antigravity/minimal/.agent/rules/code-quality.md +86 -0
package/templates/antigravity/minimal/.agent/rules/react-components.md +164 -0
package/templates/antigravity/minimal/README.md +34 -0
package/templates/antigravity/standard/.agent/rules/accessibility.md +98 -0
package/templates/antigravity/standard/.agent/rules/code-quality.md +166 -0
package/templates/antigravity/standard/.agent/rules/pull-request-review.md +192 -0
package/templates/antigravity/standard/.agent/rules/react-components.md +204 -0
package/templates/antigravity/standard/.agent/rules/testing.md +197 -0
package/templates/antigravity/standard/README.md +39 -0
package/templates/antigravity/strict/.agent/README.md +46 -0
package/templates/antigravity/strict/.agent/rules/accessibility.md +199 -0
package/templates/antigravity/strict/.agent/rules/code-quality.md +268 -0
package/templates/antigravity/strict/.agent/rules/pull-request-review.md +114 -0
package/templates/antigravity/strict/.agent/rules/react-components.md +423 -0
package/templates/antigravity/strict/.agent/rules/security.md +483 -0
package/templates/antigravity/strict/.agent/rules/testing.md +280 -0
package/templates/minimal/.cursorrules +48 -0
package/templates/minimal/README.md +40 -0
package/templates/standard/.cursorrules +184 -0
package/templates/standard/README.md +43 -0
package/templates/strict/.cursorrules +227 -0
package/templates/strict/README.md +47 -0

package/templates/antigravity/accessibility/.agent/rules/wcag-standard.md ADDED Viewed

@@ -0,0 +1,225 @@
+---
+trigger: always_on
+---
+# WCAG 2.1 Standards Quick Reference
+## Level A (Required)
+### 1.1.1 Non-text Content
+All images have alt text (or alt="" if decorative)
+### 1.2.1 Audio/Video-only
+Provide transcripts or text alternatives
+### 1.2.2 Captions (Prerecorded)
+All videos have captions
+### 1.2.3 Audio Description
+Provide audio descriptions for video
+### 1.3.1 Info and Relationships
+Use semantic HTML (headings, lists, tables, labels)
+### 1.3.2 Meaningful Sequence
+Reading order matches visual order
+### 1.3.3 Sensory Characteristics
+Don't rely on shape, size, location, or color alone
+### 1.4.1 Use of Color
+Don't use color alone to convey information
+### 1.4.2 Audio Control
+Provide pause/stop for auto-playing audio
+### 2.1.1 Keyboard
+All functionality available via keyboard
+### 2.1.2 No Keyboard Trap
+Users can navigate away from all components
+### 2.1.4 Character Key Shortcuts
+Single-key shortcuts can be turned off/remapped
+### 2.2.1 Timing Adjustable
+Users can turn off, adjust, or extend time limits
+### 2.2.2 Pause, Stop, Hide
+Control moving, blinking, or scrolling content
+### 2.3.1 Three Flashes
+Nothing flashes more than 3 times per second
+### 2.4.1 Bypass Blocks
+Skip links or landmarks to bypass repeated content
+### 2.4.2 Page Titled
+Pages have descriptive titles
+### 2.4.3 Focus Order
+Focus order is logical
+### 2.4.4 Link Purpose
+Link text describes destination
+### 2.5.1 Pointer Gestures
+Multipoint/path gestures have single-pointer alternative
+### 2.5.2 Pointer Cancellation
+Click functions trigger on up-event
+### 2.5.3 Label in Name
+Visible label matches accessible name
+### 2.5.4 Motion Actuation
+Motion-triggered functions have UI alternative
+### 3.1.1 Language of Page
+`<html lang="en">`
+### 3.2.1 On Focus
+Focus doesn't trigger unexpected changes
+### 3.2.2 On Input
+Input doesn't trigger unexpected changes
+### 3.3.1 Error Identification
+Errors are identified in text
+### 3.3.2 Labels or Instructions
+Form fields have labels
+### 4.1.1 Parsing
+HTML validates (no duplicate IDs, proper nesting)
+### 4.1.2 Name, Role, Value
+All UI components have accessible name, role, value
+### 4.1.3 Status Messages
+Status updates announced to screen readers
+## Level AA (Required)
+### 1.2.4 Captions (Live)
+Live audio has captions
+### 1.2.5 Audio Description
+All videos have audio descriptions
+### 1.3.4 Orientation
+Works in portrait and landscape
+### 1.3.5 Identify Input Purpose
+Input fields have autocomplete attributes
+### 1.4.3 Contrast (Minimum)
+- Text: 4.5:1 contrast
+- Large text: 3:1 contrast
+### 1.4.4 Resize Text
+Text resizes to 200% without loss of content
+### 1.4.5 Images of Text
+Avoid images of text (use real text)
+### 1.4.10 Reflow
+Content reflows at 320px without horizontal scroll
+### 1.4.11 Non-text Contrast
+UI components have 3:1 contrast
+### 1.4.12 Text Spacing
+Adjustable text spacing without loss of content
+### 1.4.13 Content on Hover/Focus
+Hoverable, dismissible, persistent
+### 2.4.5 Multiple Ways
+Multiple ways to find pages (menu, search, sitemap)
+### 2.4.6 Headings and Labels
+Headings and labels are descriptive
+### 2.4.7 Focus Visible
+Keyboard focus indicator is visible
+### 3.1.2 Language of Parts
+Language changes marked with lang attribute
+### 3.2.3 Consistent Navigation
+Navigation is consistent across pages
+### 3.2.4 Consistent Identification
+Components with same function have same labels
+### 3.3.3 Error Suggestion
+Provide suggestions for fixing errors
+### 3.3.4 Error Prevention
+Confirm/undo for legal/financial/data submissions
+## Quick Testing Checklist
+- [ ] All images have alt text
+- [ ] Keyboard navigation works
+- [ ] Focus indicators visible
+- [ ] Color contrast 4.5:1+
+- [ ] Forms have labels
+- [ ] Headings in order (h1→h2→h3)
+- [ ] Screen reader tested
+- [ ] Works at 200% zoom
+- [ ] Touch targets 44x44px
+- [ ] No auto-playing audio/video
+- [ ] Status messages announced
+- [ ] Valid HTML (W3C validator)

package/templates/antigravity/accessibility/README.md ADDED Viewed

@@ -0,0 +1,42 @@
+# Antigravity - Accessibility Profile
+Deep accessibility focus with WCAG 2.1+ priority.
+## What's Included
+3 comprehensive accessibility rule files:
+- `accessibility.md` - POUR principles, testing requirements
+- `wcag-standards.md` - WCAG 2.1 Level A/AA reference
+- `aria-patterns.md` - Common ARIA patterns and best practices
+## Installation
+```bash
+npx codingwithagent init
+# Select tool: 3. Antigravity
+# Select profile: 4. Accessibility
+```
+## Files created
+```
+.agent/rules/
+├── accessibility.md
+├── wcag-standards.md
+└── aria-patterns.md
+```
+## Testing Requirements
+- Screen reader testing mandatory
+- Keyboard navigation required
+- Color contrast verification
+- Lighthouse accessibility: 100
+## Best For
+- Government projects
+- Healthcare applications
+- Educational platforms
+- WCAG compliance required

package/templates/antigravity/minimal/.agent/rules/accessibility.md ADDED Viewed

@@ -0,0 +1,53 @@
+---
+trigger: always_on
+---
+# Accessibility Basics
+## Core Requirements
+- All interactive elements must be keyboard accessible (Tab, Enter, Space)
+- Provide alt text for images that convey information
+- Use semantic HTML elements (button, nav, main, header, footer)
+- Minimum color contrast: 4.5:1 for normal text
+## Keyboard Navigation
+- Support Tab key for navigation
+- Support Enter/Space for activation
+- Visible focus indicators required
+- Never use `tabIndex > 0`
+## Screen Readers
+- Use semantic HTML first (button instead of div with onClick)
+- Provide alt text for meaningful images
+- Use alt="" for decorative images
+- Form fields must have associated labels
+## Color and Contrast
+- Text must have 4.5:1 contrast ratio minimum
+- Don't use color alone to convey information
+- Add icons or text labels in addition to color
+## Forms
+- All inputs must have labels
+- Indicate required fields clearly
+- Provide helpful error messages
+- Support keyboard navigation
+## Testing
+- Test with keyboard only (no mouse)
+- Use browser accessibility tools (Axe, Lighthouse)
+- Check color contrast with analyzer tool
+## Quick Checklist
+- [ ] Can I navigate with keyboard only?
+- [ ] Do all images have alt text?
+- [ ] Are buttons actually button elements?
+- [ ] Do form fields have labels?
+- [ ] Is color contrast sufficient?

package/templates/antigravity/minimal/.agent/rules/code-quality.md ADDED Viewed

@@ -0,0 +1,86 @@
+---
+trigger: always_on
+---
+# Code Quality Essentials
+## Naming Conventions
+- Variables & functions: `camelCase` (getUserData, isValid)
+- Components: `PascalCase` (UserProfile, Button)
+- Constants: `UPPER_SNAKE_CASE` (MAX_RETRIES, API_URL)
+- Be descriptive: `isUserAuthenticated` not `isAuth`
+## JavaScript Basics
+- Use `const` by default, `let` only when reassigning
+- Never use `var`
+- Use arrow functions for callbacks
+- Remove `console.log` before committing
+- Use template literals: \`Hello ${name}\` not "Hello " + name
+## Functions
+- Keep functions small (under 50 lines)
+- Functions should do one thing
+- Use descriptive names that explain what they do
+- Avoid deeply nested code (max 3 levels)
+## Code Organization
+- One component per file
+- Group related files in folders
+- Import order: React, libraries, local files
+- Remove unused imports and code
+## Common Patterns
+### Good Practices
+```javascript
+// Destructure props
+const Button = ({ onClick, label }) => (
+  <button onClick={onClick}>{label}</button>
+);
+// Use early returns
+const getStatus = (user) => {
+  if (!user) return "guest";
+  if (user.isPremium) return "premium";
+  return "standard";
+};
+// Named functions for handlers
+const handleClick = () => {
+  console.log("clicked");
+};
+```
+### Avoid
+```javascript
+// Don't access props directly
+const Button = (props) => (
+  <button onClick={props.onClick}>{props.label}</button>
+);
+// Don't use anonymous functions in JSX
+<button onClick={() => handleClick()}>Click</button>;
+// Don't nest too deeply
+if (condition1) {
+  if (condition2) {
+    if (condition3) {
+      // too deep!
+    }
+  }
+}
+```
+## Quick Checklist
+- [] Descriptive variable name?
+- [] Functions under 50 lines?
+- [] No console.log statements?
+- [] Imports organized?
+- [] Dead code removed?

package/templates/antigravity/minimal/.agent/rules/react-components.md ADDED Viewed

@@ -0,0 +1,164 @@
+---
+trigger: always_on
+---
+# React Component Basics
+## Component Structure
+- Use functional components with hooks (not class components)
+- Destructure props at function signature
+- Keep components under 200 lines
+- One component per file
+## Props
+````javascript
+// Good: Destructure props
+const UserCard = ({name, email, onEdit}) => (
+  <div>
+    <h2>{name}</h2>
+    <p>{email}</p>
+    <button onClick={onEdit}>Edit</button>
+  </div>
+);
+// Bad: Using props object
+const UserCard = (props) => (
+  <div>
+    <h2>{props.name}</h2>
+    <p>{props.email}</p>
+    <button onClick={props.onEdit}>Edit</button>
+  </div>
+);
+## Hooks Basic
+### useState
+Use for local UI state only (modals, toggles, input values)
+```javascript
+const [isOpen, setIsOpen] = useState(false);
+const [count, setCount] = useState(0);
+````
+### useEffect
+Use for side effects (API calls, subscriptions, timers)
+```javascript
+useEffect(() => {
+  // Do something
+  fetchData();
+  // Cleanup (optional)
+  return () => cleanup();
+}, [dependencies]); // Don't forget dependencies!
+```
+### useCallback
+Prevent function recreation on every render
+```javascript
+const handleClick = useCallback(() => {
+  doSomething();
+}, [dependencies]);
+```
+## JSX Best Practices
+- Use semantic HTML (button, nav, header, footer)
+- No anonymous functions in JSX: onClick={handleClick} not onClick={() => handleClick()}
+- Keys must be from data, not array index: key={item.id} not key={index}
+- Use fragments <></> instead of unnecessary divs
+- Conditional rendering: use boolean values only
+## Common Patterns
+### Event Handlers
+```javascript
+// Good: Named function
+const handleSubmit = (e) => {
+  e.preventDefault();
+  submitForm();
+};
+<form onSubmit={handleSubmit}>
+// Bad: Anonymous function
+<form onSubmit={(e) => {
+  e.preventDefault();
+  submitForm();
+}}>
+```
+### Conditional Rendering
+```javascript
+// Good: Boolean condition
+{
+  isLoggedIn && <Dashboard />;
+}
+// Good: Ternary for two states
+{
+  isLoading ? <Spinner /> : <Content />;
+}
+// Bad: Can accidentally render "0"
+{
+  count && <Display />;
+}
+```
+### Lists
+```javascript
+// Good: Key from data
+{
+  users.map((user) => <UserCard key={user.id} {...user} />);
+}
+// Bad: Index as key
+{
+  users.map((user, index) => <UserCard key={index} {...user} />);
+}
+```
+### Component Organization
+```javascript
+const MyComponent = ({ prop1, prop2 }) => {
+  // 1. Hooks
+  const [state, setState] = useState();
+  // 2. Event handlers
+  const handleClick = () => {
+    // handle click
+  };
+  // 3. Early returns
+  if (!prop1) return null;
+  // 4. Render
+  return <div>{/* JSX here */}</div>;
+};
+```
+## Avoid
+- Class components (use functional components)
+- Direct DOM manipulation (use refs sparingly)
+- Inline styles (use CSS/styled-components)
+- Prop drilling beyond 3 levels (use context or Redux)
+- Components over 200 lines (break them down)
+## Quick Checklist
+- [] Using functional components?
+- [] Props destructured?
+- [] Event handlers named?
+- [] Keys from data, not index?
+- [] Component under 200 lines?
+- [] useEffect has dependencies?

package/templates/antigravity/minimal/README.md ADDED Viewed

@@ -0,0 +1,34 @@
+# Antigravity - Minimal Profile
+Essential rules for Antigravity AI agent in modular format.
+## What's Included
+3 focused rule files:
+- `accessibility.md` - Basic a11y requirements
+- `code-quality.md` - Essential patterns
+- `react-components.md` - Component basics
+## Installation
+```bash
+npx codingwithagent init
+# Select tool: 3. Antigravity
+# Select profile: 1. Minimal
+```
+## Files created
+```
+.agent/rules/
+├── accessibility.md
+├── code-quality.md
+└── react-components.md
+```
+## Best for
+- Getting started with Antigravity
+- Small projects
+- Learning the basics

package/templates/antigravity/standard/.agent/rules/accessibility.md ADDED Viewed

@@ -0,0 +1,98 @@
+---
+trigger: always_on
+---
+# Accessibility Standards (A11y)
+## Compliance Requirements
+- Follow WCAG 2.1 Level AA standards (striving for 2.2)
+- All functionality must be keyboard accessible
+- Support screen readers (NVDA, JAWS, VoiceOver, TalkBack)
+- Comply with DOT regulations for airline digital accessibility
+## POUR Principles
+- **Perceivable**: Everyone can "see" this (alt text, captions, sufficient contrast)
+- **Operable**: Everyone can operate this (keyboard navigation, no time limits)
+- **Understandable**: Everyone can understand this (readable text, predictable behavior)
+- **Robust**: All devices can use this (compatible with assistive technologies)
+## Implementation Requirements
+### Screen Reader Support
+- Use semantic HTML (header, nav, main, footer) for proper structure
+- All interactive elements must have accessible names
+- Use aria-label ONLY when text differs from visible content
+- Do NOT overuse role attributes, especially role="alert" (breaks semantic order)
+- Announce states properly: "selected", "expanded", "collapsed", "disabled"
+### Semantic Order and Focus Management
+- Maintain logical reading order matching visual layout
+- Use proper heading hierarchy (h1 > h2 > h3, no skipping levels)
+- Group related sections with proper ARIA landmarks
+- Focus order must follow logical tab sequence
+- TabIndex must NEVER be > 0
+### Form Accessibility
+- All form fields must have associated labels
+- Use validateOn: 'change' instead of 'blur' (better for autofill)
+- Provide clear error messages
+- Indicate required fields
+- Support keyboard navigation throughout forms
+### Color and Contrast
+- Minimum contrast ratio: 4.5:1 for normal text, 3:1 for large text/icons
+- Never use color alone to convey information
+- Add additional visual indicators: shapes, icons, text, spacing
+- Use Color Contrast Analyzer (CCA) during design
+### Images and Media
+- Provide meaningful alt text for all informative images
+- Use alt="" for decorative images
+- Avoid image-based text when possible
+- Provide captions and transcripts for video/audio
+- Never rely solely on visual cues
+### Interactive Elements
+- Buttons minimum touch target: 24x24 CSS pixels
+- Links must have descriptive text (avoid "click here", "learn more")
+- External links should indicate new window with extDisclaimer
+- All custom actions must be accessible via screen readers
+### Mobile Accessibility
+- iOS: Use UIAccessibilityCustomAction for custom gestures
+- iOS: Announce "double tap to select" for form field buttons
+- Android: Use contentDescription for ImageView, ImageButton, CheckBox
+- Android: Hint speech already announces custom actions (built-in)
+- Test with both VoiceOver (iOS) and TalkBack (Android)
+## Testing Requirements
+- Perform desk checks with accessibility tools before PR
+- Test with keyboard navigation only (no mouse)
+- Test with screen readers (VoiceOver, NVDA, JAWS, TalkBack)
+- Use automated tools: Axe DevTools, Axe Basic, Lighthouse
+- Conduct manual testing with assistive technologies
+- Include accessibility acceptance criteria in all user stories
+## Prohibited Practices
+- Do NOT use flashing/blinking content
+- Do NOT disable pinch-to-zoom
+- Do NOT use inaccessible PDFs without proper tagging
+- Do NOT create complex multi-column layouts
+- Do NOT use eslint-disable-line for a11y rules without approval
+- Do NOT mock screen reader implementations with aria-label
+## Resources
+- W3C WCAG Guidelines: https://www.w3.org/WAI/standards-guidelines/wcag/
+- MagentaA11y Checklist: https://www.magentaa11y.com/web/