forge-workflow 1.4.3 → 1.4.5

package/.claude/skills/forge-workflow/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: forge-workflow
+description: 9-stage TDD-first workflow for feature development. Use when building features, fixing bugs, or shipping PRs.
+category: Development Workflow
+tags: [tdd, workflow, pr, git, testing]
+tools: [Bash, Read, Write, Edit, Grep, Glob]
+---
+
+# Forge Workflow Skill
+
+A TDD-first workflow for AI coding agents. Ship features with confidence.
+
+## When to Use
+
+Automatically invoke this skill when the user wants to:
+- Build a new feature
+- Fix a bug
+- Create a pull request
+- Run the development workflow
+
+## 9 Stages
+
+| Stage | Command | Description |
+|-------|---------|-------------|
+| 1 | `/status` | Check current context, active work, recent completions |
+| 2 | `/research` | Deep research with web search, document to docs/research/ |
+| 3 | `/plan` | Create implementation plan, branch, OpenSpec if strategic |
+| 4 | `/dev` | TDD development (RED-GREEN-REFACTOR cycles) |
+| 5 | `/check` | Validation (type/lint/security/tests) |
+| 6 | `/ship` | Create PR with full documentation |
+| 7 | `/review` | Address ALL PR feedback |
+| 8 | `/merge` | Update docs, merge PR, cleanup |
+| 9 | `/verify` | Final documentation verification |
+
+## Workflow Flow
+
+```
+/status -> /research -> /plan -> /dev -> /check -> /ship -> /review -> /merge -> /verify
+```
+
+## Core Principles
+
+- **TDD-First**: Write tests BEFORE implementation (RED-GREEN-REFACTOR)
+- **Research-First**: Understand before building, document decisions
+- **Security Built-In**: OWASP Top 10 analysis for every feature
+- **Documentation Progressive**: Update at each stage, verify at end

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# Claude Code - Project Instructions
+# Project Instructions
 
 This is a [describe what this project does in one sentence].
 
@@ -46,31 +46,35 @@ See [docs/WORKFLOW.md](docs/WORKFLOW.md) for complete workflow guide.
 
 ---
 
-## MCP Servers
-
-This project uses MCP servers for enhanced capabilities. Copy [.mcp.json.example](.mcp.json.example) to `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
-    },
-    "grep-app": {
-      "command": "npx",
-      "args": ["-y", "@ai-tools-all/grep_app_mcp"]
-    }
-  }
-}
-```
+## MCP Servers (Enhanced Capabilities)
+
+This project uses MCP (Model Context Protocol) servers for enhanced capabilities. If your AI agent supports MCP, set up these servers:
 
-**Available MCP servers**:
+**Available MCP servers:**
 
 - **Context7**: Up-to-date library documentation and API reference
 - **grep.app**: Search 1M+ GitHub repos for real-world code examples
 
-See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for complete setup instructions.
+**Setup for your agent:**
+
+See [.mcp.json.example](.mcp.json.example) for configuration. Setup varies by agent:
+
+- **Claude Code**: Copy `.mcp.json.example` to `.mcp.json` in project root
+- **Cline**: Add MCP servers in VSCode settings (Extensions > Cline > MCP Servers)
+- **Continue**: Add to `.continue/config.json` under `mcpServers`
+- **Cursor**: Check Cursor Settings > MCP for setup
+- **Your agent**: If MCP-capable, configure using the example file
+
+**Agent instructions:**
+
+```text
+If you support MCP and don't have these servers configured:
+1. Read .mcp.json.example to see the configuration
+2. Set up Context7 and grep.app based on your MCP implementation
+3. Verify by testing: "Search grep.app for React hooks examples"
+```
+
+See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for detailed MCP setup instructions.
 
 ---
 

package/bin/forge.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 
 /**
- * Forge v1.3.0 - Universal AI Agent Workflow
+ * Forge - Universal AI Agent Workflow
  * https://github.com/harshanandak/forge
  *
+ * Version is automatically read from package.json
+ *
  * Usage:
  *   npm install forge-workflow  -> Minimal install (AGENTS.md + docs)
  *   npx forge setup             -> Interactive agent configuration
@@ -35,9 +37,13 @@ const path = require('path');
 const readline = require('readline');
 const { execSync } = require('child_process');
 
-// Get the project root and package directory
-const projectRoot = process.env.INIT_CWD || process.cwd();
+// Get version from package.json (single source of truth)
 const packageDir = path.dirname(__dirname);
+const packageJson = require(path.join(packageDir, 'package.json'));
+const VERSION = packageJson.version;
+
+// Get the project root
+const projectRoot = process.env.INIT_CWD || process.cwd();
 const args = process.argv.slice(2);
 
 // Detected package manager
@@ -1458,13 +1464,49 @@ function showBanner(subtitle = 'Universal AI Agent Workflow') {
   console.log('  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  ');
   console.log('  ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗');
   console.log('  ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝');
-  console.log('  v1.3.0');
+  console.log(`  v${VERSION}`);
   console.log('');
   if (subtitle) {
     console.log(`  ${subtitle}`);
   }
 }
 
+// Setup core documentation and directories
+function setupCoreDocs() {
+  // Create core directories
+  ensureDir('docs/planning');
+  ensureDir('docs/research');
+
+  // Copy WORKFLOW.md
+  const workflowSrc = path.join(packageDir, 'docs/WORKFLOW.md');
+  if (copyFile(workflowSrc, 'docs/WORKFLOW.md')) {
+    console.log('  Created: docs/WORKFLOW.md');
+  }
+
+  // Copy research TEMPLATE.md
+  const templateSrc = path.join(packageDir, 'docs/research/TEMPLATE.md');
+  if (copyFile(templateSrc, 'docs/research/TEMPLATE.md')) {
+    console.log('  Created: docs/research/TEMPLATE.md');
+  }
+
+  // Create PROGRESS.md if not exists
+  const progressPath = path.join(projectRoot, 'docs/planning/PROGRESS.md');
+  if (!fs.existsSync(progressPath)) {
+    writeFile('docs/planning/PROGRESS.md', `# Project Progress
+
+## Current Focus
+<!-- What you're working on -->
+
+## Completed
+<!-- Completed features -->
+
+## Upcoming
+<!-- Next priorities -->
+`);
+    console.log('  Created: docs/planning/PROGRESS.md');
+  }
+}
+
 // Minimal installation (postinstall)
 function minimalInstall() {
   // Check if this looks like a project (has package.json)
@@ -1487,9 +1529,8 @@ function minimalInstall() {
   showBanner();
   console.log('');
 
-  // Create core directories
-  ensureDir('docs/planning');
-  ensureDir('docs/research');
+  // Setup core documentation
+  setupCoreDocs();
 
   // Copy AGENTS.md (only if not exists - preserve user customizations in minimal install)
   const agentsPath = path.join(projectRoot, 'AGENTS.md');
@@ -1509,34 +1550,6 @@ function minimalInstall() {
     }
   }
 
-  // Copy documentation
-  const workflowSrc = path.join(packageDir, 'docs/WORKFLOW.md');
-  if (copyFile(workflowSrc, 'docs/WORKFLOW.md')) {
-    console.log('  Created: docs/WORKFLOW.md');
-  }
-
-  const templateSrc = path.join(packageDir, 'docs/research/TEMPLATE.md');
-  if (copyFile(templateSrc, 'docs/research/TEMPLATE.md')) {
-    console.log('  Created: docs/research/TEMPLATE.md');
-  }
-
-  // Create PROGRESS.md if not exists
-  const progressPath = path.join(projectRoot, 'docs/planning/PROGRESS.md');
-  if (!fs.existsSync(progressPath)) {
-    writeFile('docs/planning/PROGRESS.md', `# Project Progress
-
-## Current Focus
-<!-- What you're working on -->
-
-## Completed
-<!-- Completed features -->
-
-## Upcoming
-<!-- Next priorities -->
-`);
-    console.log('  Created: docs/planning/PROGRESS.md');
-  }
-
   console.log('');
   console.log('Minimal installation complete!');
   console.log('');
@@ -1897,6 +1910,11 @@ async function interactiveSetup() {
       }
     }
   }
+  console.log('');
+
+  // Setup core documentation
+  setupCoreDocs();
+  console.log('');
 
   // Load Claude commands if needed
   let claudeCommands = {};
@@ -1952,7 +1970,7 @@ async function interactiveSetup() {
   // =============================================
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.3.0 Setup Complete!');
+  console.log(`  Forge v${VERSION} Setup Complete!`);
   console.log('==============================================');
   console.log('');
   console.log('What\'s installed:');
@@ -2128,6 +2146,11 @@ async function quickSetup(selectedAgents, skipExternal) {
   if (copyFile(agentsSrc, 'AGENTS.md')) {
     console.log('  Created: AGENTS.md (universal standard)');
   }
+  console.log('');
+
+  // Setup core documentation
+  setupCoreDocs();
+  console.log('');
 
   // Load Claude commands if needed
   let claudeCommands = {};
@@ -2190,7 +2213,7 @@ async function quickSetup(selectedAgents, skipExternal) {
   // Final summary
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.3.0 Quick Setup Complete!');
+  console.log(`  Forge v${VERSION} Quick Setup Complete!`);
   console.log('==============================================');
   console.log('');
   console.log('Next steps:');
@@ -2385,6 +2408,11 @@ async function interactiveSetupWithFlags(flags) {
       }
     }
   }
+  console.log('');
+
+  // Setup core documentation
+  setupCoreDocs();
+  console.log('');
 
   // Load Claude commands if needed
   let claudeCommands = {};
@@ -2445,7 +2473,7 @@ async function interactiveSetupWithFlags(flags) {
   // =============================================
   console.log('');
   console.log('==============================================');
-  console.log('  Forge v1.3.0 Setup Complete!');
+  console.log(`  Forge v${VERSION} Setup Complete!`);
   console.log('==============================================');
   console.log('');
   console.log('What\'s installed:');
@@ -2581,6 +2609,11 @@ async function main() {
       if (copyFile(agentsSrc, 'AGENTS.md')) {
         console.log('  Created: AGENTS.md (universal standard)');
       }
+      console.log('');
+
+      // Setup core documentation
+      setupCoreDocs();
+      console.log('');
 
       // Load Claude commands if needed
       let claudeCommands = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-workflow",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "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"