proagents 1.6.20 → 1.6.22

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

@@ -1,348 +0,0 @@
-# VS Code Setup Guide
-
-Complete VS Code configuration for ProAgents development.
-
----
-
-## Required Extensions
-
-### Essential
-
-```bash
-# Install via command line
-code --install-extension dbaeumer.vscode-eslint
-code --install-extension esbenp.prettier-vscode
-code --install-extension bradlc.vscode-tailwindcss
-code --install-extension ms-vscode.vscode-typescript-next
-```
-
-| Extension | Purpose |
-|-----------|---------|
-| ESLint | Linting |
-| Prettier | Formatting |
-| TypeScript Next | Enhanced TS support |
-| Tailwind CSS IntelliSense | Tailwind autocomplete |
-
-### Recommended
-
-```bash
-code --install-extension streetsidesoftware.code-spell-checker
-code --install-extension usernamehw.errorlens
-code --install-extension eamodio.gitlens
-code --install-extension gruntfuggly.todo-tree
-code --install-extension formulahendry.auto-rename-tag
-```
-
-### AI Integration
-
-```bash
-# Choose one:
-code --install-extension GitHub.copilot          # GitHub Copilot
-code --install-extension Continue.continue       # Continue
-code --install-extension Codeium.codeium         # Codeium
-```
-
----
-
-## Workspace Settings
-
-Create `.vscode/settings.json`:
-
-```json
-{
-  // Editor
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit",
-    "source.organizeImports": "explicit"
-  },
-  "editor.tabSize": 2,
-  "editor.detectIndentation": false,
-
-  // TypeScript
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.enablePromptUseWorkspaceTsdk": true,
-  "typescript.preferences.importModuleSpecifier": "relative",
-
-  // Files
-  "files.exclude": {
-    "**/node_modules": true,
-    "**/.next": true,
-    "**/dist": true,
-    "**/.git": true
-  },
-  "files.watcherExclude": {
-    "**/node_modules/**": true,
-    "**/.next/**": true
-  },
-
-  // Search
-  "search.exclude": {
-    "**/node_modules": true,
-    "**/dist": true,
-    "**/.next": true,
-    "**/coverage": true
-  },
-
-  // ESLint
-  "eslint.validate": [
-    "javascript",
-    "javascriptreact",
-    "typescript",
-    "typescriptreact"
-  ],
-
-  // Prettier
-  "[javascript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-
-  // Tailwind
-  "tailwindCSS.experimental.classRegex": [
-    ["clsx\\(([^)]*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"],
-    ["cn\\(([^)]*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"]
-  ],
-
-  // Git
-  "git.enableSmartCommit": true,
-  "git.confirmSync": false,
-
-  // Terminal
-  "terminal.integrated.defaultProfile.osx": "zsh",
-  "terminal.integrated.defaultProfile.windows": "PowerShell"
-}
-```
-
----
-
-## Keyboard Shortcuts
-
-Add to `.vscode/keybindings.json`:
-
-```json
-[
-  // ProAgents shortcuts (example using terminal)
-  {
-    "key": "cmd+shift+p",
-    "command": "workbench.action.tasks.runTask",
-    "args": "proagents: status"
-  },
-
-  // Quick file navigation
-  {
-    "key": "cmd+p",
-    "command": "workbench.action.quickOpen"
-  },
-
-  // Toggle terminal
-  {
-    "key": "cmd+`",
-    "command": "workbench.action.terminal.toggleTerminal"
-  },
-
-  // Quick fix
-  {
-    "key": "cmd+.",
-    "command": "editor.action.quickFix"
-  },
-
-  // Go to definition
-  {
-    "key": "cmd+click",
-    "command": "editor.action.revealDefinition"
-  }
-]
-```
-
----
-
-## Tasks Configuration
-
-Create `.vscode/tasks.json`:
-
-```json
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "dev",
-      "type": "npm",
-      "script": "dev",
-      "problemMatcher": [],
-      "presentation": {
-        "reveal": "always",
-        "panel": "new"
-      }
-    },
-    {
-      "label": "build",
-      "type": "npm",
-      "script": "build",
-      "group": "build",
-      "problemMatcher": ["$tsc"]
-    },
-    {
-      "label": "test",
-      "type": "npm",
-      "script": "test",
-      "group": "test",
-      "problemMatcher": []
-    },
-    {
-      "label": "lint",
-      "type": "npm",
-      "script": "lint",
-      "problemMatcher": ["$eslint-stylish"]
-    },
-    {
-      "label": "proagents: status",
-      "type": "shell",
-      "command": "proagents status",
-      "problemMatcher": []
-    },
-    {
-      "label": "proagents: feature list",
-      "type": "shell",
-      "command": "proagents feature list",
-      "problemMatcher": []
-    }
-  ]
-}
-```
-
----
-
-## Debug Configuration
-
-Create `.vscode/launch.json`:
-
-```json
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Next.js: debug server-side",
-      "type": "node-terminal",
-      "request": "launch",
-      "command": "npm run dev"
-    },
-    {
-      "name": "Next.js: debug client-side",
-      "type": "chrome",
-      "request": "launch",
-      "url": "http://localhost:3000"
-    },
-    {
-      "name": "Debug Tests",
-      "type": "node",
-      "request": "launch",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run", "test", "--", "--runInBand"],
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen"
-    }
-  ]
-}
-```
-
----
-
-## Snippets
-
-Create `.vscode/snippets.code-snippets`:
-
-```json
-{
-  "React Functional Component": {
-    "prefix": "rfc",
-    "body": [
-      "import { FC } from 'react';",
-      "",
-      "interface ${1:Component}Props {",
-      "  $2",
-      "}",
-      "",
-      "export const ${1:Component}: FC<${1:Component}Props> = ({ $3 }) => {",
-      "  return (",
-      "    <div>",
-      "      $0",
-      "    </div>",
-      "  );",
-      "};"
-    ],
-    "description": "React Functional Component with TypeScript"
-  },
-  "useState Hook": {
-    "prefix": "us",
-    "body": "const [${1:state}, set${1/(.*)/${1:/capitalize}/}] = useState<${2:type}>($3);",
-    "description": "useState hook"
-  },
-  "useEffect Hook": {
-    "prefix": "ue",
-    "body": [
-      "useEffect(() => {",
-      "  $1",
-      "  return () => {",
-      "    $2",
-      "  };",
-      "}, [$3]);"
-    ],
-    "description": "useEffect hook with cleanup"
-  },
-  "Console Log": {
-    "prefix": "cl",
-    "body": "console.log('${1:label}:', $2);",
-    "description": "Console log with label"
-  }
-}
-```
-
----
-
-## Extensions Workspace Recommendations
-
-Create `.vscode/extensions.json`:
-
-```json
-{
-  "recommendations": [
-    "dbaeumer.vscode-eslint",
-    "esbenp.prettier-vscode",
-    "bradlc.vscode-tailwindcss",
-    "ms-vscode.vscode-typescript-next",
-    "streetsidesoftware.code-spell-checker",
-    "usernamehw.errorlens",
-    "eamodio.gitlens",
-    "gruntfuggly.todo-tree"
-  ],
-  "unwantedRecommendations": []
-}
-```
-
----
-
-## Troubleshooting
-
-### TypeScript Not Recognizing Types
-1. Run `npm install`
-2. Restart TS Server: `Cmd+Shift+P` → "TypeScript: Restart TS Server"
-
-### ESLint Not Working
-1. Check ESLint output: `Cmd+Shift+U` → Select "ESLint"
-2. Verify `.eslintrc` exists
-3. Run `npm install eslint`
-
-### Formatting Conflicts
-1. Disable other formatters
-2. Set Prettier as default: Settings → Default Formatter
-3. Restart VS Code

package/.proagents/team/onboarding.md

@@ -1,278 +0,0 @@
-# Team Onboarding Guide
-
-Get new team members productive with ProAgents quickly.
-
----
-
-## Overview
-
-This guide helps new developers get up to speed with ProAgents and your project's development workflow. Follow these steps in order for the smoothest onboarding experience.
-
----
-
-## Day 1: Environment Setup
-
-### 1. Clone the Repository
-
-```bash
-git clone [repository-url]
-cd [project-name]
-```
-
-### 2. Install Dependencies
-
-```bash
-# Node.js (use version from .nvmrc)
-nvm use
-
-# Install packages
-npm install
-
-# Install ProAgents CLI (if separate)
-npm install -g proagents-cli
-```
-
-### 3. Environment Variables
-
-```bash
-# Copy environment template
-cp .env.example .env.local
-
-# Edit with your values
-code .env.local
-```
-
-### 4. IDE Setup
-
-Follow the IDE setup guide for your editor:
-- [VS Code](./ide-setup/vscode.md)
-- [Cursor](./ide-setup/cursor.md)
-- [JetBrains](./ide-setup/jetbrains.md)
-
-### 5. Verify Setup
-
-```bash
-# Run health check
-proagents doctor
-
-# Start development server
-npm run dev
-
-# Run tests
-npm test
-```
-
----
-
-## Day 1-2: Understanding the Project
-
-### 1. Read Project Documentation
-
-| Document | Purpose | Time |
-|----------|---------|------|
-| `README.md` | Project overview | 10 min |
-| `proagents/WORKFLOW.md` | Development workflow | 30 min |
-| `proagents/standards/` | Coding standards | 30 min |
-| Architecture docs | System design | 30 min |
-
-### 2. Explore the Codebase
-
-```bash
-# Run codebase analysis
-proagents analyze --depth moderate
-
-# View project structure
-proagents structure
-```
-
-Key directories to explore:
-- `src/` - Main source code
-- `proagents/` - Workflow documentation
-- `tests/` - Test files
-- `docs/` - Additional documentation
-
-### 3. Understand the Tech Stack
-
-Review `package.json` and understand:
-- Framework (React, Next.js, etc.)
-- State management approach
-- Styling solution
-- Testing tools
-- Build tools
-
----
-
-## Week 1: First Contributions
-
-### Day 3-4: First Bug Fix
-
-Start with a small bug fix to learn the workflow:
-
-1. **Find a "good first issue"** in your issue tracker
-2. **Create a branch**:
-   ```bash
-   git checkout -b fix/issue-description
-   ```
-3. **Follow bug fix workflow**:
-   ```bash
-   proagents fix "issue description"
-   ```
-4. **Make the fix** following coding standards
-5. **Run tests**:
-   ```bash
-   npm test
-   ```
-6. **Create PR** and request review
-
-### Day 5: Code Review
-
-1. **Review others' PRs** to learn patterns
-2. **Get feedback** on your PR
-3. **Iterate** based on feedback
-4. **Merge** your first contribution!
-
----
-
-## Week 2: Feature Development
-
-### First Feature
-
-Work on a small feature:
-
-1. **Use full workflow**:
-   ```bash
-   proagents feature start "feature description"
-   ```
-2. **Follow all phases**:
-   - Analysis
-   - Requirements
-   - Design
-   - Implementation
-   - Testing
-   - Review
-
-3. **Use checklists**:
-   ```bash
-   proagents checklist current
-   ```
-
-4. **Document your work** in the changelog
-
----
-
-## Learning Resources
-
-### Internal
-
-| Resource | Description |
-|----------|-------------|
-| `proagents/prompts/` | AI prompts for each phase |
-| `proagents/examples/` | Example implementations |
-| `proagents/checklists/` | Quality checklists |
-| `proagents/standards/` | Coding standards |
-
-### Team Resources
-
-- **Slack/Teams channel**: #dev-help
-- **Wiki/Confluence**: [link]
-- **Tech talks**: [schedule]
-- **Mentor**: [assigned mentor name]
-
-### External
-
-- Framework documentation
-- Style guide references
-- Testing best practices
-
----
-
-## Key Contacts
-
-| Role | Person | Contact |
-|------|--------|---------|
-| Tech Lead | [Name] | [contact] |
-| Onboarding Buddy | [Name] | [contact] |
-| DevOps | [Name] | [contact] |
-| Product Manager | [Name] | [contact] |
-
----
-
-## Common Questions
-
-### How do I...
-
-**Start a new feature?**
-```bash
-proagents feature start "description"
-```
-
-**Run tests?**
-```bash
-npm test                 # All tests
-npm test -- --watch      # Watch mode
-npm test -- path/to/file # Specific file
-```
-
-**Check coding standards?**
-```bash
-npm run lint
-npm run type-check
-```
-
-**Create a PR?**
-1. Push your branch
-2. Open PR in GitHub/GitLab
-3. Fill out template
-4. Request review
-
-**Deploy to staging?**
-```bash
-proagents deploy staging
-```
-
----
-
-## Onboarding Checklist
-
-### Week 1
-
-- [ ] Environment set up and working
-- [ ] Can run the project locally
-- [ ] Read project README
-- [ ] Read ProAgents WORKFLOW.md
-- [ ] Explored codebase with `proagents analyze`
-- [ ] Completed first bug fix
-- [ ] Reviewed at least one PR
-- [ ] Met with mentor
-
-### Week 2
-
-- [ ] Completed first feature (small)
-- [ ] Followed full ProAgents workflow
-- [ ] Used all checklists
-- [ ] Updated documentation
-- [ ] Participated in code review
-- [ ] Asked questions in team channel
-
-### Month 1
-
-- [ ] Completed 2-3 features
-- [ ] Can work independently
-- [ ] Understanding of architecture
-- [ ] Comfortable with workflow
-- [ ] Can review others' code
-- [ ] Contributed to standards (optional)
-
----
-
-## Feedback
-
-Help us improve onboarding!
-
-After your first month, please provide feedback:
-- What worked well?
-- What was confusing?
-- What documentation was missing?
-- Suggestions for improvement
-
-Contact: [onboarding feedback channel]

package/.proagents/time-tracking.json

@@ -1,19 +0,0 @@
-{
-  "current": null,
-  "entries": [],
-  "_comment": "Time tracking data managed by pa:time-start/stop commands",
-  "_format": {
-    "current": {
-      "task": "feature-name",
-      "started": "2024-03-06T15:00:00Z",
-      "status": "running"
-    },
-    "entry": {
-      "task": "feature-name",
-      "started": "2024-03-06T15:00:00Z",
-      "ended": "2024-03-06T17:30:00Z",
-      "duration_minutes": 150,
-      "ai": "Claude:opus-4"
-    }
-  }
-}