proagents 1.6.18 → 1.6.20

package/.proagents/KIRO.md

@@ -2,29 +2,44 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## ⚠️ MANDATORY: Every pa: Command Flow
+> **IMPORTANT:** `pa:` commands are **AI directives**, NOT shell/terminal commands.
+> When user types ANY `pa:` command (e.g., `pa:feature`, `pa:fix`, `pa:status`),
+> DO NOT try to run it in terminal. Instead, follow the instructions below.
 
-### BEFORE Any pa: Command (Auto-Sync)
+## Auto-Sync Protocol
 
-**Read these files FIRST before doing anything:**
+### Rule: Sync for commands that WRITE, skip for commands that READ
 
+### Workflow Commands (Auto-Sync Required)
+
+Commands that CREATE or MODIFY code/content need context:
+
+**BEFORE these commands, read:**
 ```bash
 cat .proagents/worklog/_context.md      # Current state
 cat .proagents/changelog/_recent.md     # Recent changes
 tail -10 .proagents/activity.log        # Recent activity
 ```
 
-**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+**Examples:** `pa:feature`, `pa:fix`, `pa:implement`, `pa:analyze`,
+`pa:design`, `pa:plan`, `pa:test`, `pa:review`, `pa:doc`, `pa:deploy`,
+`pa:rnd`, `pa:refactor`, `pa:debug`, `pa:qa`, `pa:changelog`, `pa:release`, `pa:resume`,
+`pa:session-start`, `pa:session-end`
 
-### AFTER Any pa: Command (Auto-Log)
+### Utility Commands (No Sync Required)
 
-**After EVERY file edit, IMMEDIATELY update these files:**
+Commands that only READ, DISPLAY, or CONFIGURE:
+- **Skip BEFORE step** - No context reading needed
+- **Skip AFTER step** - No logging needed
 
-1. `.proagents/changelog/_recent.md` - Prepend change summary
-2. `.proagents/changelog/modules/[module].md` - Based on file path
-3. `.proagents/worklog/_context.md` - Update current state
+**Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
+`pa:ai-*`, `pa:config-*`, `pa:sync`
 
-Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
+### AFTER Workflow Commands (Auto-Log)
+
+**After commands that CHANGE files, update:**
+1. `.proagents/changelog/_recent.md` - Prepend change summary
+2. `.proagents/worklog/_context.md` - Update current state
 
 ## Essential Commands
 
@@ -32,6 +47,8 @@ Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→u
 |---------|--------|
 | `pa:feature "name"` | Start new feature workflow |
 | `pa:fix "bug"` | Quick bug fix mode |
+| `pa:project-setup` | Interactive project setup wizard |
+| `pa:rnd` | Research & Development workflow |
 | `pa:doc` | Documentation options |
 | `pa:qa` | Quality assurance checks |
 | `pa:test` | Run test workflow |

package/.proagents/LOVABLE.md

@@ -2,29 +2,44 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## ⚠️ MANDATORY: Every pa: Command Flow
+> **IMPORTANT:** `pa:` commands are **AI directives**, NOT shell/terminal commands.
+> When user types ANY `pa:` command (e.g., `pa:feature`, `pa:fix`, `pa:status`),
+> DO NOT try to run it in terminal. Instead, follow the instructions below.
 
-### BEFORE Any pa: Command (Auto-Sync)
+## Auto-Sync Protocol
 
-**Read these files FIRST before doing anything:**
+### Rule: Sync for commands that WRITE, skip for commands that READ
 
+### Workflow Commands (Auto-Sync Required)
+
+Commands that CREATE or MODIFY code/content need context:
+
+**BEFORE these commands, read:**
 ```bash
 cat .proagents/worklog/_context.md      # Current state
 cat .proagents/changelog/_recent.md     # Recent changes
 tail -10 .proagents/activity.log        # Recent activity
 ```
 
-**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+**Examples:** `pa:feature`, `pa:fix`, `pa:implement`, `pa:analyze`,
+`pa:design`, `pa:plan`, `pa:test`, `pa:review`, `pa:doc`, `pa:deploy`,
+`pa:rnd`, `pa:refactor`, `pa:debug`, `pa:qa`, `pa:changelog`, `pa:release`, `pa:resume`,
+`pa:session-start`, `pa:session-end`
 
-### AFTER Any pa: Command (Auto-Log)
+### Utility Commands (No Sync Required)
 
-**After EVERY file edit, IMMEDIATELY update these files:**
+Commands that only READ, DISPLAY, or CONFIGURE:
+- **Skip BEFORE step** - No context reading needed
+- **Skip AFTER step** - No logging needed
 
-1. `.proagents/changelog/_recent.md` - Prepend change summary
-2. `.proagents/changelog/modules/[module].md` - Based on file path
-3. `.proagents/worklog/_context.md` - Update current state
+**Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
+`pa:ai-*`, `pa:config-*`, `pa:sync`
 
-Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
+### AFTER Workflow Commands (Auto-Log)
+
+**After commands that CHANGE files, update:**
+1. `.proagents/changelog/_recent.md` - Prepend change summary
+2. `.proagents/worklog/_context.md` - Update current state
 
 ## Essential Commands
 
@@ -32,6 +47,8 @@ Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→u
 |---------|--------|
 | `pa:feature "name"` | Start new feature workflow |
 | `pa:fix "bug"` | Quick bug fix mode |
+| `pa:project-setup` | Interactive project setup wizard |
+| `pa:rnd` | Research & Development workflow |
 | `pa:doc` | Documentation options |
 | `pa:qa` | Quality assurance checks |
 | `pa:test` | Run test workflow |

package/.proagents/PROAGENTS.md

@@ -1,371 +1,126 @@
 # ProAgents Commands
 
-Execute these commands when user types them (prefix: `pa:`):
+Quick reference for all `pa:` commands.
 
 ## Quick Aliases
-`pa:f` → feature | `pa:s` → status | `pa:h` → help | `pa:d` → doc | `pa:t` → test | `pa:q` → qa | `pa:a` → analyze | `pa:r` → requirements | `pa:p` → plan | `pa:i` → implement
-
-> **Multi-AI Note:** Multiple AIs may work on this project. Context loading and logging is AUTOMATIC.
-
----
-
-## ⚠️ MANDATORY: Every pa: Command Flow
-
-### BEFORE Any pa: Command (Auto-Sync)
-
-**AI MUST read these files FIRST before doing anything:**
-
-```bash
-cat .proagents/worklog/_context.md      # Current state
-cat .proagents/changelog/_recent.md     # Recent changes
-tail -10 .proagents/activity.log        # Recent activity
-```
-
-**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
 
-### AFTER Any pa: Command That Changes Files
-
-**AI MUST update these files IMMEDIATELY after any code change:**
-
-```
-1. .proagents/changelog/_recent.md     ← Prepend change summary
-2. .proagents/worklog/_context.md      ← Update Quick Summary
-3. .proagents/changelog/modules/X.md   ← Based on file path
-4. .proagents/activity.log             ← Log the command
-```
-
-### Example: pa:fix "login bug"
-
-```
-STEP 1: Read _context.md, _recent.md, activity.log  ← SYNC FIRST
-STEP 2: Find and fix the bug                        ← DO THE WORK
-STEP 3: Prepend fix to _recent.md                   ← LOG CHANGE
-STEP 4: Update _context.md Quick Summary            ← UPDATE CONTEXT
-STEP 5: Append to activity.log                      ← LOG ACTIVITY
-```
-
-**Module detection:** `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui, `src/services/*`→services
+`pa:f` → feature | `pa:s` → status | `pa:h` → help | `pa:d` → doc | `pa:t` → test | `pa:q` → qa | `pa:a` → analyze | `pa:r` → requirements | `pa:p` → plan | `pa:i` → implement
 
 ---
 
-## Commands
-
-| Command | What to Do |
-|---------|------------|
-| `pa:help` | Comprehensive help with examples, categories, workflows |
-| `pa:feature "name"` | Create `./.proagents/active-features/feature-[name]/`, analyze codebase, implement feature |
-| `pa:fix "description"` | Find bug, fix it, update `./CHANGELOG.md` |
-| `pa:analyze` | Deep codebase analysis → `./.proagents/cache/` |
-| `pa:requirements` | Gather requirements → `./.proagents/active-features/` |
-| `pa:design` | UI/Architecture design phase |
-| `pa:plan` | Create implementation plan |
-| `pa:implement` | Execute implementation phase |
-| `pa:status` | Enhanced status: tasks, time, files, tests, git branch, contributors |
-| `pa:qa` | Quality dashboard: security, lint, coverage, bundle, docs, complexity |
-| `pa:test` | Run tests with coverage visualization, module breakdown, slow tests |
-| `pa:review` | Code review checklist: quality, security, testing, documentation |
-| `pa:fix "desc"` | Bug fix with before/after diff, affected tests, auto-verify |
-| `pa:doc` | Generate documentation |
-| `pa:deploy` | Interactive deployment checklist with real-time status, health checks |
-| `pa:release` | Generate release notes → `./RELEASE_NOTES.md` |
-| `pa:changelog` | Update `./CHANGELOG.md` |
-| `pa:ai-list` | Read config, show installed AI platforms |
-| `pa:ai-add` | Show platform options, create AI instruction files |
-| `pa:ai-remove` | Show installed platforms, remove selected files |
-| `pa:ai-sync` | Sync config with existing files (fix mismatches) |
-| `pa:activity` | Show ALL AI activity with icons, time groups, files changed |
-| `pa:lock` | Show lock status, check if another AI is working |
-| `pa:lock-release` | Release your lock after completing work |
-| `pa:handoff` | Create handoff notes → `./.proagents/handoff.md` |
-| `pa:handoff-read` | Read handoff notes before starting work |
-| `pa:session-end` | Generate session summary → `./.proagents/sessions/` |
-| `pa:decision "title"` | Log architectural decision → `./.proagents/decisions.md` |
-| `pa:error "desc"` | Log error & solution → `./.proagents/errors.md` |
-| `pa:feedback "desc"` | Log feedback for AI learning → `./.proagents/feedback.md` |
-| `pa:standup` | Daily standup: yesterday, today, blockers, team activity, stats |
-| `pa:tech-debt` | Scan for technical debt |
-
-## Navigation & Flow
-
-| Command | What to Do |
-|---------|------------|
-| `pa:next` | Show next step in current workflow |
-| `pa:resume` | Compact resume: last session, what was done, next action, hot files |
-| `pa:skip` | Skip current phase, move to next |
-| `pa:back` | Go back to previous phase |
-| `pa:progress` | Show enhanced progress: tasks, duration, AI, phase timeline |
-
-## Context & History
-
-| Command | What to Do |
-|---------|------------|
-| `pa:context` | View project context |
-| `pa:diff` | Show changes since last session |
-| `pa:history` | Command history with filters: --today, --ai, --command, --stats |
-| `pa:checkpoint` | Create snapshot/restore point |
-| `pa:undo` | Undo last AI action (git revert) |
-| `pa:undo-last` | Undo last AI's entire session (all changes) |
-| `pa:undo-file "path"` | Undo changes to specific file |
-| `pa:conflict-check` | Check if files modified by other AI |
-| `pa:changelog --from-git` | Auto-populate changelog from git commits | |
-
-## Sprint & Estimation
-
-| Command | What to Do |
-|---------|------------|
-| `pa:sprint-start` | Start new sprint → `./.proagents/sprints/` |
-| `pa:sprint-end` | End sprint with summary |
-| `pa:estimate` | Estimate task complexity (S/M/L/XL) |
-| `pa:velocity` | Show velocity metrics |
-
-## Integration
-
-| Command | What to Do |
-|---------|------------|
-| `pa:github` | GitHub commands (issue, PR) |
-| `pa:github-pr` | Create pull request |
-| `pa:jira` | Sync with Jira ticket |
-| `pa:notify` | Send notification (Slack/email) |
-
-## Code Quality
-
-| Command | What to Do |
-|---------|------------|
-| `pa:metrics` | Show code quality metrics |
-| `pa:coverage` | Show test coverage report |
-| `pa:deps` | Analyze dependencies |
-| `pa:deps-outdated` | Find outdated packages |
-| `pa:deps-security` | Security scan dependencies |
+## Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `pa:help` | Show all commands with examples |
+| `pa:feature "name"` | Start new feature workflow |
+| `pa:fix "description"` | Quick bug fix |
+| `pa:status` | Show current progress |
+| `pa:project-setup` | Interactive project setup |
+
+## Workflow Phases
+
+| Command | Description |
+|---------|-------------|
+| `pa:analyze` | Code analysis |
+| `pa:requirements` | Gather requirements |
+| `pa:design` | UI/Architecture design |
+| `pa:plan` | Implementation plan |
+| `pa:implement` | Write code |
+| `pa:test` | Run tests |
+| `pa:review` | Code review |
+| `pa:doc` | Documentation |
+| `pa:deploy` | Deployment checklist |
+
+## AI Platform Management
+
+| Command | Prompt File |
+|---------|-------------|
+| `pa:ai-list` | `./prompts/ai-list.md` |
+| `pa:ai-add` | `./prompts/ai-add.md` |
+| `pa:ai-remove` | `./prompts/ai-remove.md` |
+| `pa:ai-sync` | `./prompts/ai-sync.md` |
+
+## Navigation
+
+| Command | Description |
+|---------|-------------|
+| `pa:next` | Next step in workflow |
+| `pa:resume` | Resume last session |
+| `pa:skip` | Skip current phase |
+| `pa:back` | Go to previous phase |
+| `pa:progress` | Show progress |
+
+## Multi-AI Collaboration
+
+| Command | Description |
+|---------|-------------|
+| `pa:activity` | Show all AI activity |
+| `pa:lock` | Check lock status |
+| `pa:lock-release` | Release lock |
+| `pa:handoff` | Create handoff notes |
+| `pa:session-end` | End session with summary |
+
+## Quality & Testing
+
+| Command | Description |
+|---------|-------------|
+| `pa:qa` | Quality dashboard |
+| `pa:metrics` | Code metrics |
+| `pa:coverage` | Test coverage |
+| `pa:a11y` | Accessibility audit |
+| `pa:perf` | Performance analysis |
 
 ## Code Generation
 
-| Command | What to Do |
-|---------|------------|
-| `pa:generate` | Show generation options |
-| `pa:generate-component "name"` | Generate component from template |
+| Command | Description |
+|---------|-------------|
+| `pa:generate-component "name"` | Generate component |
 | `pa:generate-api "name"` | Generate API endpoint |
 | `pa:generate-test "file"` | Generate test file |
 
 ## Refactoring
 
-| Command | What to Do |
-|---------|------------|
-| `pa:refactor` | Suggest refactoring opportunities |
+| Command | Description |
+|---------|-------------|
+| `pa:refactor` | Suggest refactoring |
 | `pa:rename "old" "new"` | Rename across codebase |
-| `pa:extract "name"` | Extract function/component |
-| `pa:cleanup` | Remove dead code, unused imports |
-
-## Time Tracking
-
-| Command | What to Do |
-|---------|------------|
-| `pa:time-start` | Start tracking → `./.proagents/time-tracking.json` |
-| `pa:time-stop` | Stop tracking, save duration |
-| `pa:time-report` | Show time report by feature |
-
-## Environment & Setup
-
-| Command | What to Do |
-|---------|------------|
-| `pa:env-check` | Verify environment setup |
-| `pa:env-setup` | Setup dev environment |
-| `pa:secrets-scan` | Scan for exposed secrets |
+| `pa:cleanup` | Remove dead code |
 
-## Database
-
-| Command | What to Do |
-|---------|------------|
-| `pa:db-migrate` | Run database migrations |
-| `pa:db-seed` | Seed with test data |
-| `pa:db-reset` | Reset database (caution!) |
-
-## Accessibility & Performance
-
-| Command | What to Do |
-|---------|------------|
-| `pa:a11y` | Run accessibility audit |
-| `pa:lighthouse` | Run Lighthouse audit |
-| `pa:perf` | Performance analysis |
+## Git & Release
 
-## Export & Backup
-
-| Command | What to Do |
-|---------|------------|
-| `pa:export` | Export config/data → JSON file |
-| `pa:import` | Import from export file |
-| `pa:backup` | Backup proagents folder |
-
-## Learning & AI
-
-| Command | What to Do |
-|---------|------------|
-| `pa:learn "pattern"` | Teach AI a pattern → saves to `.proagents/.learning/` |
-| `pa:forget "pattern"` | Remove learned pattern from learning data |
-| `pa:learning` | Show learning report: patterns, corrections, preferences |
-| `pa:suggestions` | Show AI suggestions based on learned patterns |
-
-## API & Documentation
-
-| Command | What to Do |
-|---------|------------|
-| `pa:api-docs` | Generate OpenAPI/Swagger documentation |
-| `pa:storybook` | Generate Storybook stories |
-| `pa:readme` | Auto-generate/update README.md |
-| `pa:types` | Generate TypeScript types/interfaces |
-
-## Git Advanced
-
-| Command | What to Do |
-|---------|------------|
-| `pa:branch` | Branch management (list, create, clean) |
-| `pa:merge` | Smart merge with conflict preview |
-| `pa:conflict` | Resolve merge conflicts with AI |
-| `pa:changelog-gen` | Auto-generate changelog from commits |
-
-## Search & Navigation
-
-| Command | What to Do |
-|---------|------------|
-| `pa:find "pattern"` | Find code patterns/usage |
-| `pa:todo` | Find and list all TODOs in code |
-| `pa:fixme` | Find FIXMEs and critical issues |
-| `pa:unused` | Find unused code/exports |
-| `pa:unused-deps` | Find unused dependencies |
-
-## Code Analysis
-
-| Command | What to Do |
-|---------|------------|
-| `pa:complexity` | Cyclomatic complexity analysis |
-| `pa:duplication` | Find duplicate code blocks |
-| `pa:hotspots` | Find frequently changed files |
-
-## Testing Advanced
-
-| Command | What to Do |
-|---------|------------|
-| `pa:test-e2e` | Create/run E2E tests |
-| `pa:test-unit` | Generate unit tests |
-| `pa:mock` | Generate mocks/stubs |
-| `pa:snapshot` | Snapshot testing management |
-
-## DevOps & Infrastructure
-
-| Command | What to Do |
-|---------|------------|
-| `pa:docker` | Docker commands (build, compose) |
-| `pa:ci` | CI/CD pipeline status/management |
-| `pa:deploy-preview` | Deploy to preview environment |
-
-## Release Management
-
-| Command | What to Do |
-|---------|------------|
+| Command | Description |
+|---------|-------------|
+| `pa:changelog` | Update CHANGELOG.md |
+| `pa:release` | Generate release notes |
 | `pa:version` | Show/bump version |
-| `pa:tag` | Create git tag for release |
-| `pa:publish` | Publish package to registry |
-
-## Code Review & PR
-
-| Command | What to Do |
-|---------|------------|
-| `pa:review-request` | Request code review from team |
-| `pa:review-comments` | Show PR review comments |
-| `pa:review-approve` | Approve current PR |
-
-## Architecture
-
-| Command | What to Do |
-|---------|------------|
-| `pa:architecture` | Show architecture overview |
-| `pa:architecture-diagram` | Generate architecture diagram (Mermaid) |
-| `pa:architecture-export` | Export diagram (SVG/PNG) |
-
-## API Testing
-
-| Command | What to Do |
-|---------|------------|
-| `pa:api-test` | Test API endpoints |
-| `pa:curl` | Generate curl commands for endpoints |
-| `pa:postman` | Generate Postman collection |
+| `pa:github-pr` | Create pull request |
 
-## Health & Monitoring
+## Research & Development
 
-| Command | What to Do |
-|---------|------------|
-| `pa:health` | Project health check |
-| `pa:monitor` | Show monitoring status |
-| `pa:uptime` | Service uptime check |
+| Command | Description |
+|---------|-------------|
+| `pa:rnd` | R&D workflow |
+| `pa:rnd-compare` | Compare solutions |
+| `pa:rnd-poc` | Build prototype |
 
-## Quick Actions
+## Learning & Feedback
 
-| Command | What to Do |
-|---------|------------|
-| `pa:quick` | Show quick actions menu |
-| `pa:alias` | Manage command aliases |
-| `pa:alias-add` | Add custom alias |
-| `pa:alias-remove` | Remove custom alias |
+| Command | Description |
+|---------|-------------|
+| `pa:learn "pattern"` | Teach AI a pattern |
+| `pa:feedback "desc"` | Log feedback |
+| `pa:decision "title"` | Log decision |
+| `pa:error "desc"` | Log error & solution |
 
-## Mobile Test Suite (React Native)
+---
 
-| Command | What to Do |
-|---------|------------|
-| `pa:test-mobile` | Run full mobile test suite (unit, component, E2E, visual) |
-| `pa:test-mobile "feature"` | Test specific feature only |
-| `pa:test-visual` | Visual/design comparison testing |
-| `pa:test-auto-fix` | Auto-fix failing tests |
-| `pa:test-loop` | Test → Fix → Retest loop until all pass |
-| `pa:compare-figma` | Compare UI against Figma design |
-| `pa:compare-image "path"` | Compare UI against image/sketch |
-| `pa:screenshot` | Take app screenshots for comparison |
+## Full Documentation
 
-## Key Files to Read
+For complete instructions, auto-sync protocol, and workflows:
 
 | File | Purpose |
 |------|---------|
-| `./.proagents/context.md` | Persistent project context (READ FIRST!) |
-| `./.proagents/feedback.md` | Past corrections - don't repeat mistakes |
-| `./.proagents/watchlist.yaml` | Files requiring confirmation before changes |
-| `./.proagents/errors.md` | Past errors and solutions |
-| `./.proagents/decisions.md` | Architectural decisions and reasoning |
-
-## Feature Workflow
-
-`pa:feature` runs all phases, or run individually:
-
-| Phase | Command | Action |
-|-------|---------|--------|
-| 1. Init | `pa:feature "name"` | Create tracking files |
-| 2. Analysis | `pa:analyze` | Understand existing code |
-| 3. Requirements | `pa:requirements` | Define what to build |
-| 4. Design | `pa:design` | Plan UI/architecture |
-| 5. Planning | `pa:plan` | Create implementation plan |
-| 6. Implementation | `pa:implement` | Write code |
-| 7. Testing | `pa:test` | Create/run tests |
-| 8. Review | `pa:review` | Quality check |
-| 9. Documentation | `pa:doc` | Update docs |
-| 10. Deployment | `pa:deploy` | Interactive deployment checklist |
-
-## Save Locations
-
-| Document | Location |
-|----------|----------|
-| Changelog | `./CHANGELOG.md` |
-| Release Notes | `./RELEASE_NOTES.md` |
-| Feature Status | `./.proagents/active-features/` |
-
-## Examples
-
-```
-User: pa:feature "add user login"
-→ Create feature, analyze codebase, guide implementation
-
-User: pa:fix "submit button not working"
-→ Find issue, fix it, update changelog
-
-User: pa:status
-→ Show active features and progress
-
-User: pa:help
-→ Show all available commands
-```
+| `.proagents/AI_INSTRUCTIONS.md` | Complete AI instructions |
+| `.proagents/WORKFLOW.md` | Full 10-phase workflow |
+| `.proagents/prompts/` | Phase-specific prompts |

package/.proagents/REPLIT.md

@@ -2,29 +2,44 @@
 
 This project uses ProAgents - an AI-agnostic development workflow framework.
 
-## ⚠️ MANDATORY: Every pa: Command Flow
+> **IMPORTANT:** `pa:` commands are **AI directives**, NOT shell/terminal commands.
+> When user types ANY `pa:` command (e.g., `pa:feature`, `pa:fix`, `pa:status`),
+> DO NOT try to run it in terminal. Instead, follow the instructions below.
 
-### BEFORE Any pa: Command (Auto-Sync)
+## Auto-Sync Protocol
 
-**Read these files FIRST before doing anything:**
+### Rule: Sync for commands that WRITE, skip for commands that READ
 
+### Workflow Commands (Auto-Sync Required)
+
+Commands that CREATE or MODIFY code/content need context:
+
+**BEFORE these commands, read:**
 ```bash
 cat .proagents/worklog/_context.md      # Current state
 cat .proagents/changelog/_recent.md     # Recent changes
 tail -10 .proagents/activity.log        # Recent activity
 ```
 
-**This applies to EVERY command:** `pa:fix`, `pa:feature`, `pa:test`, `pa:doc`, etc.
+**Examples:** `pa:feature`, `pa:fix`, `pa:implement`, `pa:analyze`,
+`pa:design`, `pa:plan`, `pa:test`, `pa:review`, `pa:doc`, `pa:deploy`,
+`pa:rnd`, `pa:refactor`, `pa:debug`, `pa:qa`, `pa:changelog`, `pa:release`, `pa:resume`,
+`pa:session-start`, `pa:session-end`
 
-### AFTER Any pa: Command (Auto-Log)
+### Utility Commands (No Sync Required)
 
-**After EVERY file edit, IMMEDIATELY update these files:**
+Commands that only READ, DISPLAY, or CONFIGURE:
+- **Skip BEFORE step** - No context reading needed
+- **Skip AFTER step** - No logging needed
 
-1. `.proagents/changelog/_recent.md` - Prepend change summary
-2. `.proagents/changelog/modules/[module].md` - Based on file path
-3. `.proagents/worklog/_context.md` - Update current state
+**Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
+`pa:ai-*`, `pa:config-*`, `pa:sync`
 
-Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→ui
+### AFTER Workflow Commands (Auto-Log)
+
+**After commands that CHANGE files, update:**
+1. `.proagents/changelog/_recent.md` - Prepend change summary
+2. `.proagents/worklog/_context.md` - Update current state
 
 ## Essential Commands
 
@@ -32,6 +47,8 @@ Module detection: `src/api/*`→api, `src/auth/*`→auth, `src/components/*`→u
 |---------|--------|
 | `pa:feature "name"` | Start new feature workflow |
 | `pa:fix "bug"` | Quick bug fix mode |
+| `pa:project-setup` | Interactive project setup wizard |
+| `pa:rnd` | Research & Development workflow |
 | `pa:doc` | Documentation options |
 | `pa:qa` | Quality assurance checks |
 | `pa:test` | Run test workflow |

package/.proagents/activity.log

@@ -9,3 +9,4 @@
 #
 # --- Activity Log Start ---
 
+