proagents 1.0.0

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

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

@@ -0,0 +1,278 @@
+# 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/templates/README.md

@@ -0,0 +1,57 @@
+# Document Templates
+
+Output templates for each workflow phase.
+
+---
+
+## Overview
+
+Standardized templates for all workflow outputs ensuring consistency.
+
+## Available Templates
+
+| Template | Phase | Description |
+|----------|-------|-------------|
+| [Codebase Analysis Report](./codebase-analysis-report.md) | Analysis | Project structure and patterns |
+| [Feature Requirements](./feature-requirements.md) | Requirements | User stories, acceptance criteria |
+| [UI Specification](./ui-specification.md) | Design | Component specs from designs |
+| [Implementation Plan](./implementation-plan.md) | Planning | Task breakdown, architecture |
+| [Test Plan](./test-plan.md) | Testing | Test strategy and coverage |
+| [Code Review Report](./code-review-report.md) | Review | Review findings, suggestions |
+| [Feature Status](./feature-status.md) | Tracking | Progress and status updates |
+| [Deployment Checklist](./deployment-checklist.md) | Deployment | Pre-deploy verification |
+| [Rollback Plan](./rollback-plan.md) | Rollback | Recovery procedures |
+
+## Usage
+
+Templates are automatically used by the workflow, or generate manually:
+
+```bash
+# Generate specific template
+proagents template generate test-plan
+
+# Export filled template
+proagents template export implementation-plan --output plan.md
+```
+
+## Customization
+
+Override templates in your project:
+
+```
+your-project/
+└── .proagents/
+    └── templates/
+        └── feature-requirements.md  # Your custom version
+```
+
+## Template Variables
+
+Templates support variables:
+
+```markdown
+# Feature: {{feature.name}}
+
+**Status:** {{feature.status}}
+**Started:** {{feature.start_date}}
+```