proagents 1.6.20 → 1.6.21

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

@@ -1,276 +0,0 @@
-# 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 pa:feature '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

@@ -1,330 +0,0 @@
-# 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