proagents 1.0.0

package/proagents/team/ide-setup/cursor.md

@@ -0,0 +1,276 @@
+# Cursor IDE Setup Guide
+
+Configure Cursor for optimal ProAgents development with AI-first workflow.
+
+---
+
+## Overview
+
+Cursor is built for AI-assisted development, making it ideal for ProAgents workflows. This guide covers configuration for maximum productivity.
+
+---
+
+## Initial Setup
+
+### 1. Install Cursor
+
+Download from [cursor.sh](https://cursor.sh)
+
+### 2. Import VS Code Settings
+
+Cursor can import your VS Code configuration:
+- `Cmd+Shift+P` → "Cursor: Import VS Code Settings"
+
+### 3. Configure AI Model
+
+Settings → AI → Model:
+- **Claude**: Recommended for complex tasks
+- **GPT-4**: Alternative option
+- **Local models**: For privacy-sensitive work
+
+---
+
+## Cursor-Specific Settings
+
+Access via `Cmd+,` or Settings:
+
+```json
+{
+  // AI Settings
+  "cursor.ai.enableAutoComplete": true,
+  "cursor.ai.autoCompleteModel": "claude-3-sonnet",
+  "cursor.ai.chatModel": "claude-3-opus",
+
+  // Code Actions
+  "cursor.ai.enableInlineEdits": true,
+  "cursor.ai.showInlineSuggestions": true,
+
+  // Context
+  "cursor.ai.includeProjectContext": true,
+  "cursor.ai.maxContextFiles": 10,
+
+  // Privacy
+  "cursor.ai.codebaseIndexing": true,
+  "cursor.ai.sendCodeToCloud": true  // Set false for sensitive projects
+}
+```
+
+---
+
+## ProAgents Integration
+
+### Using ProAgents Commands in Cursor
+
+Cursor's AI chat integrates well with ProAgents:
+
+```
+# In Cursor Chat (Cmd+L)
+
+"Run /feature start 'Add user authentication'"
+
+"Check the ProAgents workflow status"
+
+"Apply the coding standards from proagents/standards/"
+```
+
+### Codebase Context
+
+Cursor indexes your codebase for context. Ensure ProAgents files are indexed:
+
+```json
+{
+  "cursor.ai.includePaths": [
+    "src/**",
+    "proagents/**"
+  ],
+  "cursor.ai.excludePaths": [
+    "node_modules/**",
+    "dist/**",
+    ".next/**"
+  ]
+}
+```
+
+---
+
+## Keyboard Shortcuts
+
+### AI Features
+
+| Shortcut | Action |
+|----------|--------|
+| `Cmd+L` | Open AI Chat |
+| `Cmd+K` | Inline Edit |
+| `Cmd+Shift+K` | Edit Selection |
+| `Tab` | Accept Suggestion |
+| `Esc` | Dismiss Suggestion |
+| `Cmd+Shift+L` | Add to Chat Context |
+
+### Standard Editing
+
+| Shortcut | Action |
+|----------|--------|
+| `Cmd+P` | Quick Open File |
+| `Cmd+Shift+P` | Command Palette |
+| `Cmd+B` | Toggle Sidebar |
+| `Cmd+J` | Toggle Terminal |
+| `Cmd+/` | Toggle Comment |
+
+---
+
+## Cursor Rules (.cursorrules)
+
+Create `.cursorrules` in project root:
+
+```
+# Project Context
+This is a [project type] project using [technologies].
+
+# Coding Standards
+- Use TypeScript with strict mode
+- Follow functional programming patterns
+- Use Tailwind CSS for styling
+- Follow the patterns in proagents/standards/
+
+# Testing
+- Write tests using Vitest
+- Aim for 80% coverage
+- Use React Testing Library for components
+
+# Conventions
+- Components in src/components/
+- Hooks in src/hooks/
+- Types in src/types/
+
+# ProAgents
+- Follow the workflow in proagents/WORKFLOW.md
+- Check proagents/standards/ for coding guidelines
+- Use proagents/checklists/ before completing phases
+```
+
+---
+
+## AI Chat Prompts for ProAgents
+
+### Starting Features
+
+```
+I'm starting a new feature: [description]
+
+Please help me:
+1. Analyze the codebase for related code
+2. Suggest an implementation approach
+3. Identify files that need changes
+4. Create the implementation plan
+
+Reference: proagents/prompts/04-planning.md
+```
+
+### Code Review
+
+```
+Review this code following ProAgents standards:
+
+[paste code]
+
+Check against:
+- proagents/standards/coding-standards.md
+- proagents/checklists/code-review.md
+
+Provide specific feedback and suggestions.
+```
+
+### Debugging
+
+```
+I'm encountering this error:
+
+[error message]
+
+Help me debug following proagents/prompts/debugging/systematic.md
+
+1. Analyze the error
+2. Identify potential causes
+3. Suggest debugging steps
+4. Provide fix if possible
+```
+
+---
+
+## Composer Mode
+
+Cursor's Composer mode is powerful for multi-file changes:
+
+### Using Composer for Features
+
+1. `Cmd+I` to open Composer
+2. Describe the feature
+3. Reference ProAgents docs:
+   ```
+   Implement [feature] following:
+   - proagents/standards/react-nextjs.md for code style
+   - proagents/prompts/05-implementation.md for approach
+   ```
+4. Review proposed changes
+5. Apply changes
+
+### Best Practices
+
+- Start with clear, specific prompts
+- Reference ProAgents standards in prompts
+- Review AI suggestions before applying
+- Use `@file` to include specific files as context
+
+---
+
+## Workspace Configuration
+
+Create `.cursor/settings.json`:
+
+```json
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+
+  "cursor.ai.contextFiles": [
+    "proagents/standards/*.md",
+    "proagents/prompts/*.md",
+    "README.md",
+    "package.json"
+  ],
+
+  "cursor.composer.includePaths": [
+    "src/**/*.{ts,tsx}",
+    "proagents/**/*.md"
+  ]
+}
+```
+
+---
+
+## Tips for AI-Assisted Development
+
+1. **Be Specific**: Clear prompts get better results
+2. **Provide Context**: Reference relevant ProAgents docs
+3. **Iterate**: Refine AI suggestions with follow-up prompts
+4. **Review**: Always review AI-generated code
+5. **Learn**: Use AI explanations to understand code
+
+---
+
+## Troubleshooting
+
+### AI Not Responding
+- Check internet connection
+- Verify API key in settings
+- Try different model
+
+### Context Too Large
+- Exclude unnecessary files
+- Use specific file references
+- Split large requests
+
+### Suggestions Not Relevant
+- Improve `.cursorrules`
+- Add more context in prompts
+- Reference specific ProAgents docs

package/proagents/team/ide-setup/jetbrains.md

@@ -0,0 +1,330 @@
+# JetBrains IDE Setup Guide
+
+Configure WebStorm, IntelliJ IDEA, or other JetBrains IDEs for ProAgents development.
+
+---
+
+## Supported IDEs
+
+- **WebStorm** - JavaScript/TypeScript development
+- **IntelliJ IDEA** - Full-stack development
+- **PhpStorm** - PHP with JS/TS
+- **PyCharm** - Python with JS/TS frontend
+
+---
+
+## Essential Plugins
+
+### Install via Settings → Plugins
+
+| Plugin | Purpose |
+|--------|---------|
+| Prettier | Code formatting |
+| ESLint | Linting |
+| Tailwind CSS | Tailwind IntelliSense |
+| GitToolBox | Enhanced Git features |
+| String Manipulation | Text utilities |
+| Rainbow Brackets | Bracket colorization |
+
+### AI Plugins (Choose One)
+
+| Plugin | Description |
+|--------|-------------|
+| GitHub Copilot | GitHub's AI assistant |
+| JetBrains AI | Built-in AI features |
+| Codeium | Free AI completion |
+| Tabnine | AI code completion |
+
+---
+
+## Project Configuration
+
+### 1. Node.js Setup
+
+Settings → Languages & Frameworks → Node.js:
+- Set Node interpreter from `.nvmrc`
+- Enable coding assistance for Node.js
+
+### 2. TypeScript Setup
+
+Settings → Languages & Frameworks → TypeScript:
+- TypeScript: Use project's `node_modules/typescript`
+- Enable TypeScript service
+- Recompile on changes: ✓
+
+### 3. ESLint Setup
+
+Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint:
+- Automatic ESLint configuration: ✓
+- Run for files: `**/*.{js,jsx,ts,tsx}`
+- Run eslint --fix on save: ✓
+
+### 4. Prettier Setup
+
+Settings → Languages & Frameworks → JavaScript → Prettier:
+- Prettier package: `node_modules/prettier`
+- Run for files: `**/*.{js,jsx,ts,tsx,json,css,md}`
+- On save: ✓
+- On reformat: ✓
+
+---
+
+## Editor Settings
+
+Settings → Editor:
+
+### Code Style
+
+```
+General:
+- Hard wrap at: 100
+- Visual guides: 80, 100
+
+JavaScript/TypeScript:
+- Tabs and Indents:
+  - Tab size: 2
+  - Indent: 2
+  - Continuation indent: 2
+  - Use tab character: No
+
+- Spaces:
+  - Before parentheses: function declaration ✓
+
+- Imports:
+  - Sort imports: ✓
+  - Use paths relative to project: ✓
+```
+
+### Inspections
+
+Settings → Editor → Inspections:
+- JavaScript and TypeScript → Code quality tools → ESLint: ✓
+- JavaScript and TypeScript → Imports and dependencies: ✓
+
+---
+
+## File Templates
+
+Settings → Editor → File and Code Templates:
+
+### React Component
+
+```tsx
+import { FC } from 'react';
+
+interface ${NAME}Props {
+  #[[// TODO: Define props]]#
+}
+
+export const ${NAME}: FC<${NAME}Props> = ({}) => {
+  return (
+    <div>
+      ${NAME}
+    </div>
+  );
+};
+```
+
+### Custom Hook
+
+```typescript
+import { useState, useEffect } from 'react';
+
+export function use${NAME}() {
+  #[[// TODO: Implement hook]]#
+
+  return {};
+}
+```
+
+---
+
+## Live Templates
+
+Settings → Editor → Live Templates → JavaScript/TypeScript:
+
+### React Component (rfc)
+
+```
+import { FC } from 'react';
+
+interface $NAME$Props {
+  $PROPS$
+}
+
+export const $NAME$: FC<$NAME$Props> = ({ $DESTRUCTURED$ }) => {
+  return (
+    <div>
+      $END$
+    </div>
+  );
+};
+```
+
+### useState (us)
+
+```
+const [$STATE$, set$STATE_CAPITALIZED$] = useState<$TYPE$>($DEFAULT$);
+```
+
+### useEffect (ue)
+
+```
+useEffect(() => {
+  $BODY$
+  return () => {
+    $CLEANUP$
+  };
+}, [$DEPS$]);
+```
+
+### Console Log (cl)
+
+```
+console.log('$LABEL$:', $VALUE$);
+```
+
+---
+
+## Run Configurations
+
+### Development Server
+
+1. Run → Edit Configurations → Add → npm
+2. Settings:
+   - Name: "dev"
+   - Scripts: "dev"
+   - Node interpreter: Project
+3. Save
+
+### Tests
+
+1. Run → Edit Configurations → Add → npm
+2. Settings:
+   - Name: "test"
+   - Scripts: "test"
+3. For watch mode, add arguments: `-- --watch`
+
+### Debugging
+
+1. Run → Edit Configurations → Add → JavaScript Debug
+2. Settings:
+   - Name: "Debug: Chrome"
+   - URL: `http://localhost:3000`
+   - Browser: Chrome
+
+---
+
+## Keyboard Shortcuts
+
+### Essential Shortcuts (macOS / Windows)
+
+| Action | macOS | Windows |
+|--------|-------|---------|
+| Search Everywhere | `Double Shift` | `Double Shift` |
+| Find File | `Cmd+Shift+O` | `Ctrl+Shift+N` |
+| Find in Files | `Cmd+Shift+F` | `Ctrl+Shift+F` |
+| Go to Definition | `Cmd+B` | `Ctrl+B` |
+| Find Usages | `Alt+F7` | `Alt+F7` |
+| Refactor | `Ctrl+T` | `Ctrl+Alt+Shift+T` |
+| Reformat Code | `Cmd+Alt+L` | `Ctrl+Alt+L` |
+| Run | `Ctrl+R` | `Shift+F10` |
+| Debug | `Ctrl+D` | `Shift+F9` |
+| Terminal | `Alt+F12` | `Alt+F12` |
+
+### Custom ProAgents Shortcuts
+
+Add via Settings → Keymap → External Tools:
+
+1. Add External Tool for ProAgents commands
+2. Assign keyboard shortcuts
+
+---
+
+## Project View Settings
+
+View → Tool Windows → Project:
+- Show Excluded Files: Off
+- Show Members: Off
+- Flatten Packages: Off
+- Compact Middle Packages: On
+
+Right-click node_modules → Mark Directory as → Excluded
+
+---
+
+## Performance Optimization
+
+### Exclude from Indexing
+
+Settings → Project Structure → Excluded:
+- `node_modules`
+- `.next`
+- `dist`
+- `build`
+- `coverage`
+
+### Memory Settings
+
+Help → Edit Custom VM Options:
+```
+-Xms1024m
+-Xmx4096m
+-XX:ReservedCodeCacheSize=512m
+```
+
+### Disable Unnecessary Inspections
+
+Settings → Editor → Inspections:
+- Disable inspections you don't use
+- Set inspection severity appropriately
+
+---
+
+## Version Control
+
+### Git Settings
+
+Settings → Version Control → Git:
+- Enable: ✓
+- Commit: Use non-modal commit interface ✓
+- Push: Update method: Rebase
+
+### Commit Template
+
+Settings → Version Control → Commit:
+- Commit message template:
+```
+<type>(<scope>): <description>
+
+<body>
+
+<footer>
+```
+
+### Pre-commit Checks
+
+Settings → Version Control → Commit → Before Commit:
+- Reformat code: ✓
+- Analyze code: ✓
+- Check TODO: ✓
+
+---
+
+## Troubleshooting
+
+### TypeScript Errors Not Showing
+1. File → Invalidate Caches / Restart
+2. Check TypeScript version in settings
+3. Run `npm install`
+
+### ESLint Not Working
+1. Check ESLint is enabled in settings
+2. Verify `.eslintrc` exists
+3. Check ESLint plugin is installed
+
+### Slow Performance
+1. Increase memory in VM options
+2. Exclude large directories
+3. Disable unused plugins
+4. Check "Power Save Mode" is off