proagents 1.6.18 → 1.6.19

package/.proagents/workflow-modes/entry-modes.md

@@ -55,6 +55,30 @@ The complete 10-phase development workflow for new features.
 └─────────────────────────────────────────────────────────────┘
 ```
 
+### Flow Context Check
+
+Before starting, check `.proagents/worklog/_context.md` for Flow Context:
+
+```
+📋 Checking for prior context...
+
+If Flow Context exists:
+┌─────────────────────────────────────────────────────────┐
+│ 📋 Continuing from previous workflow                    │
+│                                                         │
+│ Last Command: pa:rnd-compare                            │
+│ Decision: Zustand for state management                  │
+│ Context: E-commerce cart state                          │
+│ Research: docs/research/comparisons/state-mgmt.md       │
+│                                                         │
+│ Use this context? (yes/no/modify)                       │
+└─────────────────────────────────────────────────────────┘
+
+If "yes": Pre-populate feature with context data
+If "no": Start fresh, clear Flow Context
+If "modify": Allow user to adjust context
+```
+
 ### Starting Full Workflow
 
 ```bash
@@ -63,6 +87,9 @@ pa:feature start "User Profile Management"
 
 # With options
 pa:feature start "User Profile" --skip-ui --checkpoint=critical
+
+# Continue from RND (auto-reads Flow Context)
+pa:feature start "Cart State" --from-rnd
 ```
 
 ### Checkpoints

package/.proagents/worklog/_context.template.md

@@ -72,6 +72,53 @@ Failing: [Test names or "None"]
 | Open Issues | [N] |
 ```
 
+---
+
+## Flow Context
+<!-- Tracks command chain for seamless transitions between pa: commands -->
+```
+Current Flow: [command chain, e.g., "rnd → feature → plan"]
+Last Command: [last pa: command run]
+Decision: [key decision made, if any]
+Context: [relevant context to carry forward]
+Next Suggested: [suggested next command]
+Data: [JSON data to pass to next command]
+```
+
+### Flow Context Rules
+
+1. **Write after completion** - Each command writes its output to Flow Context
+2. **Read on start** - Commands check Flow Context for relevant prior decisions
+3. **Offer continuation** - If Flow Context has Next Suggested, offer to run it
+4. **Clear on explicit start** - When user starts fresh workflow, clear Flow Context
+5. **Preserve data** - JSON data carries structured info (tech stack, decisions, etc.)
+
+### Example Flow
+
+```markdown
+## Flow Context
+```
+Current Flow: rnd → feature
+Last Command: pa:rnd-compare
+Decision: Zustand for state management
+Context: E-commerce cart with complex state
+Next Suggested: pa:feature "cart state management"
+Data: {"tech": "zustand", "use_case": "cart", "research_doc": "docs/research/comparisons/state-management-2024-03-17.md"}
+```
+```
+
+When pa:feature starts, it reads this and says:
+```
+📋 Continuing from R&D...
+
+You recently decided on Zustand for cart state management.
+Research: docs/research/comparisons/state-management-2024-03-17.md
+
+Start feature with this context? (yes/no/different)
+```
+
+---
+
 ## Auto-Update Rules
 
 1. **Update `Last Updated`** with current timestamp

package/COMMANDS.md

@@ -212,6 +212,65 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.)
 
 ---
 
+## Project Setup
+
+| Command | Description |
+|---------|-------------|
+| `pa:project-setup` | Interactive setup wizard (new or existing projects) |
+| `pa:setup` | Alias for pa:project-setup |
+| `pa:setup --preset [name]` | Use quick preset (mobile-mvp, saas, etc.) |
+| `pa:setup --analyze` | Analyze existing project only |
+| `pa:setup --resume` | Resume interrupted setup |
+| `pa:setup --clear-progress` | Clear saved progress and start fresh |
+
+**Features:**
+- Quick Presets - Instant setup for common stacks (Mobile MVP, SaaS, E-commerce, etc.)
+- Idea-First Mode - Describe your idea, AI suggests tech stack with comparison table
+- Full Automation - Installs packages, creates folders, generates docs
+- Resume Support - Auto-saves progress, resume if interrupted
+- Merge Strategy - Updates existing docs without overwriting custom content
+- Works for both new projects and existing codebases
+
+---
+
+## Research & Development
+
+| Command | Description |
+|---------|-------------|
+| `pa:rnd` | Interactive R&D workflow (compare, prototype, explore) |
+| `pa:research` | Alias for pa:rnd |
+| `pa:rnd-compare` | Direct to comparison mode |
+| `pa:rnd-poc` | Direct to prototype mode |
+| `pa:rnd-explore` | Direct to exploration mode |
+| `pa:rnd --quick` | Quick 5-minute research |
+| `pa:rnd --resume` | Resume interrupted session |
+| `pa:rnd --clear` | Clear saved progress |
+
+**Features:**
+- Compare Options - Side-by-side library/framework comparisons with weighted scoring
+- Build POC - Quick proof-of-concept in isolated `./poc/` folder
+- Explore Solutions - Research and document findings
+- Web Search - Verify latest package stats (stars, downloads, releases)
+- Cost Estimator - Monthly costs at different user scales
+- Deprecation Alerts - Warn about deprecated/insecure packages
+- Comparison Tables - Visual side-by-side with recommendations
+- Past Decision Recall - Surface previous decisions on similar topics
+- Scope Guard - Alert when research drifts off-topic
+- Resume Support - Auto-saves progress
+- Tags & Categories - Organize research by topic
+- Archive System - Auto-archive old research after 6 months
+- Review Reminders - Set reminder to revisit decisions
+- Next Phase Integration - After RND, trigger pa:feature or pa:plan
+
+**Outputs:**
+- Comparison docs: `docs/research/comparisons/`
+- Research findings: `docs/research/findings/`
+- Research index: `docs/research/INDEX.md`
+- Bookmarks: `docs/research/BOOKMARKS.md`
+- POC code: `./poc/[name]/`
+
+---
+
 ## Workflow Phase Commands
 
 | Command | Phase | Description |

package/README.md

@@ -164,6 +164,8 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 |---------|-------------|
 | `pa:feature "name"` | Start new feature workflow (all phases) |
 | `pa:fix "description"` | Quick bug fix mode |
+| `pa:project-setup` | Interactive project setup wizard |
+| `pa:rnd` | Research & Development workflow |
 | `pa:status` | Show current progress |
 | `pa:sync` | Load project context (usually auto) |
 | `pa:test` | Run tests |
@@ -173,7 +175,7 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 | `pa:undo-last` | Revert last AI's changes |
 | `pa:handoff` | Create notes for another AI |
 
-**Quick aliases:** `pa:f` (feature), `pa:s` (status), `pa:t` (test), `pa:h` (help)
+**Quick aliases:** `pa:f` (feature), `pa:s` (status), `pa:t` (test), `pa:h` (help), `pa:setup` (project-setup), `pa:research` (rnd)
 
 📖 **Want more?** See [COMMANDS.md](COMMANDS.md) for 100+ AI commands (debugging, testing, refactoring, code generation, sprints...)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.6.18",
+  "version": "1.6.19",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",