forge-workflow 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/.claude/commands/check.md +8 -0
  2. package/.claude/commands/dev.md +8 -0
  3. package/.claude/commands/plan.md +8 -0
  4. package/.claude/commands/rollback.md +724 -0
  5. package/.claude/settings.json +7 -0
  6. package/.claude/settings.local.json +11 -1
  7. package/.mcp.json.example +12 -0
  8. package/AGENTS.md +87 -9
  9. package/CLAUDE.md +108 -0
  10. package/bin/forge.js +885 -2
  11. package/docs/TOOLCHAIN.md +92 -3
  12. package/docs/WORKFLOW.md +23 -0
  13. package/package.json +4 -2
package/.claude/settings.local.json CHANGED
@@ -15,7 +15,17 @@
15
15
  "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" pkg fix)",
16
16
  "WebFetch(domain:www.aihero.dev)",
17
17
  "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" version minor --no-git-tag-version)",
18
- "WebFetch(domain:ohmyopencode.com)"
18
+ "WebFetch(domain:ohmyopencode.com)",
19
+ "WebFetch(domain:grep.app)",
20
+ "Bash(test:*)",
21
+ "Bash(\"C:\\\\Program Files\\\\nodejs\\\\npm.cmd\" publish)",
22
+ "Bash(node -e:*)",
23
+ "Bash(node test-detection.js:*)",
24
+ "Bash(node:*)",
25
+ "Bash(git checkout:*)",
26
+ "Bash(git push:*)",
27
+ "Bash(gh pr create:*)",
28
+ "Bash(gh pr merge:*)"
19
29
  ]
20
30
  }
21
31
  }
package/.mcp.json.example ADDED
@@ -0,0 +1,12 @@
1
+ {
2
+ "mcpServers": {
3
+ "context7": {
4
+ "command": "npx",
5
+ "args": ["-y", "@upstash/context7-mcp@latest"]
6
+ },
7
+ "grep-app": {
8
+ "command": "npx",
9
+ "args": ["-y", "@ai-tools-all/grep_app_mcp"]
10
+ }
11
+ }
12
+ }
package/AGENTS.md CHANGED
@@ -1,10 +1,11 @@
1
- # AGENTS.md
1
+ # Project Instructions
2
2
 
3
3
  This is a [describe what this project does in one sentence].
4
4
 
5
5
  **Package manager**: npm (or specify: pnpm/yarn/bun)
6
6
 
7
7
  **Build commands**:
8
+
8
9
  ```bash
9
10
  npm install # Install dependencies
10
11
  npm run dev # Start development
@@ -12,23 +13,100 @@ npm run build # Production build
12
13
  npm test # Run tests
13
14
  ```
14
15
 
15
- **Workflow**: See [`docs/WORKFLOW.md`](docs/WORKFLOW.md) for the 9-stage TDD workflow.
16
+ ---
17
+
18
+ ## Forge Workflow
19
+
20
+ This project uses the **Forge 9-stage TDD workflow**:
21
+
22
+ | Stage | Command | Purpose |
23
+ |-------|-------------|----------------------------------------------|
24
+ | 1 | `/status` | Check current context, active work |
25
+ | 2 | `/research` | Research with web search, document findings |
26
+ | 3 | `/plan` | Create implementation plan, branch, OpenSpec |
27
+ | 4 | `/dev` | TDD development (RED-GREEN-REFACTOR) |
28
+ | 5 | `/check` | Validation (type/lint/security/tests) |
29
+ | 6 | `/ship` | Create PR with documentation |
30
+ | 7 | `/review` | Address ALL PR feedback |
31
+ | 8 | `/merge` | Update docs, merge PR, cleanup |
32
+ | 9 | `/verify` | Final documentation verification |
33
+
34
+ **Flow**: `/status` → `/research` → `/plan` → `/dev` → `/check` → `/ship` → `/review` → `/merge` → `/verify`
35
+
36
+ See [docs/WORKFLOW.md](docs/WORKFLOW.md) for complete workflow guide.
37
+
38
+ ---
39
+
40
+ ## Core Principles
41
+
42
+ - **TDD-First**: Write tests BEFORE implementation (RED-GREEN-REFACTOR)
43
+ - **Research-First**: Understand before building, document decisions
44
+ - **Security Built-In**: OWASP Top 10 analysis for every feature
45
+ - **Documentation Progressive**: Update at each stage, verify at end
46
+
47
+ ---
48
+
49
+ ## MCP Servers (Enhanced Capabilities)
50
+
51
+ This project uses MCP (Model Context Protocol) servers for enhanced capabilities. If your AI agent supports MCP, set up these servers:
52
+
53
+ **Available MCP servers:**
54
+
55
+ - **Context7**: Up-to-date library documentation and API reference
56
+ - **grep.app**: Search 1M+ GitHub repos for real-world code examples
57
+
58
+ **Setup for your agent:**
59
+
60
+ See [.mcp.json.example](.mcp.json.example) for configuration. Setup varies by agent:
61
+
62
+ - **Claude Code**: Copy `.mcp.json.example` to `.mcp.json` in project root
63
+ - **Cline**: Add MCP servers in VSCode settings (Extensions > Cline > MCP Servers)
64
+ - **Continue**: Add to `.continue/config.json` under `mcpServers`
65
+ - **Cursor**: Check Cursor Settings > MCP for setup
66
+ - **Your agent**: If MCP-capable, configure using the example file
67
+
68
+ **Agent instructions:**
69
+
70
+ ```text
71
+ If you support MCP and don't have these servers configured:
72
+ 1. Read .mcp.json.example to see the configuration
73
+ 2. Set up Context7 and grep.app based on your MCP implementation
74
+ 3. Verify by testing: "Search grep.app for React hooks examples"
75
+ ```
76
+
77
+ See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for detailed MCP setup instructions.
78
+
79
+ ---
80
+
81
+ ## Quick Start
16
82
 
17
- **Project-specific conventions**: Add them below as you discover patterns.
83
+ 1. `/status` - Check where you are
84
+ 2. `/research <feature-name>` - Research the feature
85
+ 3. `/plan <feature-slug>` - Create formal plan
86
+ 4. `/dev` - Implement with TDD
87
+ 5. `/check` - Validate everything
88
+ 6. `/ship` - Create PR
18
89
 
19
90
  ---
20
91
 
21
- <!-- USER:START - Add learnings here as you work -->
92
+ ## Toolchain
22
93
 
23
- 💡 **Keep this section minimal** - Instruction budget is ~150-200 instructions max.
94
+ - **Beads** (recommended): `npm i -g @beads/bd && bd init` - Git-backed issue tracking
95
+ - **OpenSpec** (optional): `npm i -g @fission-ai/openspec && openspec init` - Spec-driven development
96
+ - **GitHub CLI**: `gh auth login` - PR workflow
97
+
98
+ See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for comprehensive tool reference.
99
+
100
+ ---
101
+
102
+ <!-- USER:START - Add project-specific learnings here as you work -->
103
+
104
+ 💡 **Keep this section focused** - Add patterns you discover while working.
24
105
 
25
106
  As you work, when you give the same instruction twice, add it here:
107
+
26
108
  - Coding style preferences
27
109
  - Architecture decisions
28
110
  - Domain concepts unique to this project
29
111
 
30
112
  <!-- USER:END -->
31
-
32
- ---
33
-
34
- See [`docs/TOOLCHAIN.md`](docs/TOOLCHAIN.md) for comprehensive tool reference.
package/CLAUDE.md ADDED
@@ -0,0 +1,108 @@
1
+ # Claude Code - Project Instructions
2
+
3
+ This is a [describe what this project does in one sentence].
4
+
5
+ **Package manager**: npm (or specify: pnpm/yarn/bun)
6
+
7
+ **Build commands**:
8
+
9
+ ```bash
10
+ npm install # Install dependencies
11
+ npm run dev # Start development
12
+ npm run build # Production build
13
+ npm test # Run tests
14
+ ```
15
+
16
+ ---
17
+
18
+ ## Forge Workflow
19
+
20
+ This project uses the **Forge 9-stage TDD workflow**:
21
+
22
+ | Stage | Command | Purpose |
23
+ |-------|-------------|----------------------------------------------|
24
+ | 1 | `/status` | Check current context, active work |
25
+ | 2 | `/research` | Research with web search, document findings |
26
+ | 3 | `/plan` | Create implementation plan, branch, OpenSpec |
27
+ | 4 | `/dev` | TDD development (RED-GREEN-REFACTOR) |
28
+ | 5 | `/check` | Validation (type/lint/security/tests) |
29
+ | 6 | `/ship` | Create PR with documentation |
30
+ | 7 | `/review` | Address ALL PR feedback |
31
+ | 8 | `/merge` | Update docs, merge PR, cleanup |
32
+ | 9 | `/verify` | Final documentation verification |
33
+
34
+ **Flow**: `/status` → `/research` → `/plan` → `/dev` → `/check` → `/ship` → `/review` → `/merge` → `/verify`
35
+
36
+ See [docs/WORKFLOW.md](docs/WORKFLOW.md) for complete workflow guide.
37
+
38
+ ---
39
+
40
+ ## Core Principles
41
+
42
+ - **TDD-First**: Write tests BEFORE implementation (RED-GREEN-REFACTOR)
43
+ - **Research-First**: Understand before building, document decisions
44
+ - **Security Built-In**: OWASP Top 10 analysis for every feature
45
+ - **Documentation Progressive**: Update at each stage, verify at end
46
+
47
+ ---
48
+
49
+ ## MCP Servers
50
+
51
+ This project uses MCP servers for enhanced capabilities. Copy [.mcp.json.example](.mcp.json.example) to `.mcp.json`:
52
+
53
+ ```json
54
+ {
55
+ "mcpServers": {
56
+ "context7": {
57
+ "command": "npx",
58
+ "args": ["-y", "@upstash/context7-mcp@latest"]
59
+ },
60
+ "grep-app": {
61
+ "command": "npx",
62
+ "args": ["-y", "@ai-tools-all/grep_app_mcp"]
63
+ }
64
+ }
65
+ }
66
+ ```
67
+
68
+ **Available MCP servers**:
69
+
70
+ - **Context7**: Up-to-date library documentation and API reference
71
+ - **grep.app**: Search 1M+ GitHub repos for real-world code examples
72
+
73
+ See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for complete setup instructions.
74
+
75
+ ---
76
+
77
+ ## Quick Start
78
+
79
+ 1. `/status` - Check where you are
80
+ 2. `/research <feature-name>` - Research the feature
81
+ 3. `/plan <feature-slug>` - Create formal plan
82
+ 4. `/dev` - Implement with TDD
83
+ 5. `/check` - Validate everything
84
+ 6. `/ship` - Create PR
85
+
86
+ ---
87
+
88
+ ## Toolchain
89
+
90
+ - **Beads** (recommended): `npm i -g @beads/bd && bd init` - Git-backed issue tracking
91
+ - **OpenSpec** (optional): `npm i -g @fission-ai/openspec && openspec init` - Spec-driven development
92
+ - **GitHub CLI**: `gh auth login` - PR workflow
93
+
94
+ See [docs/TOOLCHAIN.md](docs/TOOLCHAIN.md) for comprehensive tool reference.
95
+
96
+ ---
97
+
98
+ <!-- USER:START - Add project-specific learnings here as you work -->
99
+
100
+ 💡 **Keep this section focused** - Add patterns you discover while working.
101
+
102
+ As you work, when you give the same instruction twice, add it here:
103
+
104
+ - Coding style preferences
105
+ - Architecture decisions
106
+ - Domain concepts unique to this project
107
+
108
+ <!-- USER:END -->