forge-workflow 1.3.0 → 1.4.0

package/docs/TOOLCHAIN.md

@@ -393,9 +393,10 @@ The system SHALL support optional 2FA
 
 Context7 provides current documentation that may be more recent than the AI's training data.
 
-**Installation (Claude Code)**:
+**Installation**:
+
+**Claude Code**: Add to `.mcp.json` in your project root:
 
-Add to `.mcp.json` in your project root:
 
 ```json
 {
@@ -420,6 +421,28 @@ Add to `.mcp.json` in your project root:
 }
 ```
 
+**Cline (VSCode)**:
+1. Open VSCode Settings
+2. Search for "Cline MCP"
+3. Add Context7 server configuration
+
+**Continue**: Add to `.continue/config.json`:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    }
+  }
+}
+```
+
+**Cursor**: Check Cursor Settings → MCP Servers for configuration options
+
+**Other agents**: If your agent supports MCP, configure using the JSON format above
+
 **Usage**:
 ```
 # The AI will automatically use Context7 when you ask about libraries
@@ -434,6 +457,72 @@ Add to `.mcp.json` in your project root:
 - To verify API signatures and patterns
 - For current best practices
 
+### grep.app - Code Search
+
+**Package**: `@ai-tools-all/grep_app_mcp` (recommended) or `@galprz/grep-mcp`
+**Website**: [grep.app](https://grep.app)
+**Purpose**: Search across 1M+ public GitHub repositories for real-world code examples
+**Used in**: `/research` stage, finding implementation patterns
+
+grep.app provides code search across public GitHub repositories to find real-world examples and patterns.
+
+**Installation (Claude Code)**:
+
+Add to `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "grep-app": {
+      "command": "npx",
+      "args": ["-y", "@ai-tools-all/grep_app_mcp"]
+    }
+  }
+}
+```
+
+**Or with bunx**:
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "bunx",
+      "args": ["--bun", "@upstash/context7-mcp@latest"]
+    },
+    "grep-app": {
+      "command": "bunx",
+      "args": ["--bun", "@ai-tools-all/grep_app_mcp"]
+    }
+  }
+}
+```
+
+**Usage**:
+```
+# The AI will use grep.app when you need real-world examples
+"Find examples of React useEffect cleanup patterns"
+"Show me how others implement JWT authentication in Express"
+"Search for rate limiting implementations in Node.js"
+```
+
+**When to use grep.app**:
+
+- Finding real-world implementation examples
+- Discovering coding patterns in production code
+- Validating implementation approaches
+- Learning from open source projects
+
+**Context7 vs grep.app**:
+
+| Tool           | Purpose                        | Use When                                  |
+|----------------|--------------------------------|-------------------------------------------|
+| **Context7**   | Official library documentation | You need API reference, official patterns |
+| **grep.app**   | Real code in the wild          | You want to see how others solve problems |
+
 ---
 
 ## External Services
@@ -658,7 +747,7 @@ gh issue create --title "..." --body "..."
 | Stage | Tools Used |
 |-------|------------|
 | `/status` | `bd ready`, `bd list`, `git status`, `openspec list` |
-| `/research` | Parallel AI, codebase exploration |
+| `/research` | Parallel AI, Context7, grep.app, codebase exploration |
 | `/plan` | `bd create`, `openspec` (if strategic), `git checkout -b` |
 | `/dev` | Tests, code, `bd update`, `/tasks save` |
 | `/check` | Type check, lint, tests, SonarCloud |

package/docs/WORKFLOW.md

@@ -237,6 +237,29 @@ bd sync && git push
 
 ---
 
+## Recovery: Rollback
+
+If something goes wrong, use rollback to safely revert changes:
+
+```bash
+npx forge rollback
+```
+
+**Rollback methods**:
+
+- **Last commit**: Quick undo of most recent change
+- **Specific commit**: Target any commit by hash
+- **Merged PR**: Revert an entire PR merge
+- **Specific files**: Restore only certain files
+- **Branch range**: Revert multiple commits
+- **Dry run**: Preview changes without executing
+
+All USER sections and custom commands are preserved during rollback.
+
+See [.claude/commands/rollback.md](../.claude/commands/rollback.md) for complete documentation.
+
+---
+
 ## Tips & Best Practices
 
 1. **Always TDD**: Write tests BEFORE implementation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-workflow",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "9-stage TDD workflow for ALL AI coding agents (Claude, Cursor, Windsurf, Kilo, OpenCode, Copilot, Cline, Roo, Aider, Continue, Antigravity)",
   "bin": {
     "forge": "bin/forge.js"
@@ -44,6 +44,8 @@
     ".claude/",
     "docs/",
     "install.sh",
-    "AGENTS.md"
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".mcp.json.example"
   ]
 }