@mengde1231/rudder 0.5.22 → 0.5.30
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.
- package/README.md +59 -42
- package/dist/configurators/claude.d.ts.map +1 -1
- package/dist/configurators/claude.js +1 -3
- package/dist/configurators/claude.js.map +1 -1
- package/dist/configurators/workflow.d.ts +3 -0
- package/dist/configurators/workflow.d.ts.map +1 -1
- package/dist/configurators/workflow.js +13 -1
- package/dist/configurators/workflow.js.map +1 -1
- package/dist/templates/claude/agents/rudder-check.md +37 -3
- package/dist/templates/codebuddy/agents/rudder-check.md +37 -3
- package/dist/templates/codex/agents/rudder-check.toml +10 -3
- package/dist/templates/cursor/agents/rudder-check.md +37 -3
- package/dist/templates/cursor/hooks.json +0 -6
- package/dist/templates/droid/droids/rudder-check.md +37 -3
- package/dist/templates/gemini/agents/rudder-check.md +37 -3
- package/dist/templates/kiro/agents/rudder-check.json +1 -1
- package/dist/templates/opencode/agents/rudder-check.md +37 -3
- package/dist/templates/pi/agents/rudder-check.md +68 -1
- package/dist/templates/qoder/agents/rudder-check.md +37 -3
- package/dist/templates/rudder/config.yaml +16 -3
- package/dist/templates/rudder/config_local.yml +17 -0
- package/dist/templates/rudder/gitignore.txt +1 -1
- package/dist/templates/rudder/index.d.ts +1 -0
- package/dist/templates/rudder/index.d.ts.map +1 -1
- package/dist/templates/rudder/index.js +1 -0
- package/dist/templates/rudder/index.js.map +1 -1
- package/dist/templates/rudder/scripts/common/config.py +42 -12
- package/dist/templates/rudder/scripts/common/rudder_config.py +26 -4
- package/dist/templates/rudder/workflow.md +6 -2
- package/dist/templates/shared-hooks/index.d.ts.map +1 -1
- package/dist/templates/shared-hooks/index.js +0 -1
- package/dist/templates/shared-hooks/index.js.map +1 -1
- package/dist/templates/shared-hooks/session-start.py +25 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,22 +1,18 @@
|
|
|
1
1
|
<p align="center">
|
|
2
2
|
<picture>
|
|
3
|
-
<source srcset="assets/rudder.png" media="(prefers-color-scheme: dark)">
|
|
4
|
-
<source srcset="assets/rudder.png" media="(prefers-color-scheme: light)">
|
|
5
|
-
<img src="assets/rudder.png" alt="Rudder Logo
|
|
3
|
+
<source srcset="assets/rudder-logo.png" media="(prefers-color-scheme: dark)">
|
|
4
|
+
<source srcset="assets/rudder-logo.png" media="(prefers-color-scheme: light)">
|
|
5
|
+
<img src="assets/rudder-logo.png" alt="Rudder Logo" width="500" style="image-rendering: -webkit-optimize-contrast; image-rendering: crisp-edges;">
|
|
6
6
|
</picture>
|
|
7
|
-
<br/><em>Logo and official website are still in progress — design contributions welcome!</em>
|
|
8
7
|
</p>
|
|
9
8
|
|
|
10
9
|
<p align="center">
|
|
11
|
-
<strong>
|
|
12
|
-
<sub>Start a feature in Gemini, continue in Claude Code,
|
|
10
|
+
<strong>Your AI coding assistant keeps forgetting your project? This fixes that.</strong><br/>
|
|
11
|
+
<sub>Start a feature in Gemini, continue in Claude Code, hand it off to a teammate — no one needs to re-explain everything. Context, specs, and standards live in your repo and get injected automatically.</sub>
|
|
13
12
|
</p>
|
|
14
13
|
|
|
15
14
|
<p align="center">
|
|
16
|
-
<a href="./README_CN.md">简体中文</a>
|
|
17
|
-
<a href="https://docs.tryrudder.app/">Docs</a> •
|
|
18
|
-
<a href="https://docs.tryrudder.app/start/install-and-first-task">Quick Start</a> •
|
|
19
|
-
<a href="https://docs.tryrudder.app/advanced/multi-platform">Supported Platforms</a>
|
|
15
|
+
<a href="./README_CN.md">简体中文</a>
|
|
20
16
|
</p>
|
|
21
17
|
|
|
22
18
|
<p align="center">
|
|
@@ -24,24 +20,44 @@
|
|
|
24
20
|
<a href="https://www.npmjs.com/package/@mengde1231/rudder"><img src="https://img.shields.io/npm/dw/@mengde1231/rudder?style=flat-square&color=cb3837&label=downloads" alt="npm downloads" /></a>
|
|
25
21
|
<a href="https://github.com/MengDe1231/Rudder/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-16a34a.svg?style=flat-square" alt="license" /></a>
|
|
26
22
|
<a href="https://github.com/MengDe1231/Rudder/stargazers"><img src="https://img.shields.io/github/stars/MengDe1231/Rudder?style=flat-square&color=eab308" alt="stars" /></a>
|
|
27
|
-
<a href="https://docs.tryrudder.app/"><img src="https://img.shields.io/badge/docs-tryrudder.app-0f766e?style=flat-square" alt="docs" /></a>
|
|
28
23
|
</p>
|
|
29
24
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
25
|
+
## What problem does this solve?
|
|
26
|
+
|
|
27
|
+
If you've used AI for coding, you know the drill: every new session the assistant has no idea about your project. You explain the same things over and over.
|
|
33
28
|
|
|
34
|
-
|
|
29
|
+
Rudder fixes that. **Your specs, memory, and task state all live in the repo. Every session gets exactly the context it needs — automatically.**
|
|
35
30
|
|
|
36
31
|
| Capability | What it changes |
|
|
37
32
|
| --- | --- |
|
|
38
|
-
| **Auto-injected specs** | Write conventions once in `.rudder/spec/`,
|
|
39
|
-
| **Task-centered
|
|
40
|
-
| **Project memory** |
|
|
41
|
-
| **Team-shared standards** | Specs
|
|
42
|
-
| **
|
|
33
|
+
| **Auto-injected specs** | Write your conventions once in `.rudder/spec/`, Rudder injects the right files into each session. No more copy-pasting rules every time. |
|
|
34
|
+
| **Task-centered flow** | PRDs, implementation records, and review context all live in `.rudder/tasks/`. AI work stays structured, not scattered across chat history. |
|
|
35
|
+
| **Project memory** | `.rudder/workspace/` journals carry forward what happened last time. New session? It knows where you left off. |
|
|
36
|
+
| **Team-shared standards** | Specs version-control with your code. One person figures out a good pattern, everyone gets it for free. |
|
|
37
|
+
| **14 platforms, one setup** | Same Rudder structure everywhere. Switch tools, keep your workflow. |
|
|
43
38
|
|
|
44
|
-
##
|
|
39
|
+
## Supported Platforms
|
|
40
|
+
|
|
41
|
+
14 AI coding platforms, one setup. Pick what you use:
|
|
42
|
+
|
|
43
|
+
| Agent | IDE / Platform |
|
|
44
|
+
| --- | --- |
|
|
45
|
+
| Claude Code | CLI, VS Code, JetBrains, Web |
|
|
46
|
+
| Gemini | Gemini CLI |
|
|
47
|
+
| Cursor | Cursor IDE |
|
|
48
|
+
| Codex | VS Code |
|
|
49
|
+
| OpenCode | OpenCode IDE |
|
|
50
|
+
| CodeBuddy | CodeBuddy IDE |
|
|
51
|
+
| Qoder | Qoder IDE |
|
|
52
|
+
| Kiro | Kiro IDE |
|
|
53
|
+
| Pi | Pi CLI |
|
|
54
|
+
| Windsurf | Windsurf IDE |
|
|
55
|
+
| Copilot | VS Code, JetBrains |
|
|
56
|
+
| Antigravity | Antigravity CLI |
|
|
57
|
+
| Kilo | Kilo CLI |
|
|
58
|
+
| Droid | Factory IDE |
|
|
59
|
+
|
|
60
|
+
## What you need
|
|
45
61
|
|
|
46
62
|
- **Node.js** >= 18
|
|
47
63
|
- **Python** >= 3.9
|
|
@@ -49,70 +65,71 @@
|
|
|
49
65
|
## Quick Start
|
|
50
66
|
|
|
51
67
|
```bash
|
|
52
|
-
# 1. Install
|
|
68
|
+
# 1. Install
|
|
53
69
|
npm install -g @mengde1231/rudder@latest
|
|
54
70
|
|
|
55
|
-
# 2. Initialize
|
|
71
|
+
# 2. Initialize (all platforms)
|
|
56
72
|
rudder init -u your-name
|
|
57
73
|
|
|
58
|
-
# 3. Or
|
|
74
|
+
# 3. Or just the ones you actually use (cleaner)
|
|
59
75
|
rudder init --cursor --opencode --codex -u your-name
|
|
60
76
|
```
|
|
61
77
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
## How It Works
|
|
78
|
+
## How it works
|
|
65
79
|
|
|
66
|
-
Rudder runs a 4-phase loop
|
|
80
|
+
Rudder runs a 4-phase loop every session:
|
|
67
81
|
|
|
68
|
-
1. **Plan** — `rudder-brainstorm` walks through requirements
|
|
69
|
-
2. **Implement** —
|
|
70
|
-
3. **Verify** —
|
|
71
|
-
4. **Finish** —
|
|
82
|
+
1. **Plan** — `rudder-brainstorm` walks through requirements and writes `prd.md`. Research-heavy stuff goes to a `rudder-research` sub-agent. Output: curated specs + research files, wired up via `implement.jsonl` / `check.jsonl`.
|
|
83
|
+
2. **Implement** — `rudder-implement` writes code from the PRD with context already injected. No git commit here — that's intentional.
|
|
84
|
+
3. **Verify** — `rudder-check` reviews the diff against specs, runs lint, type-check, compile, and tests. Fixes what it can, reports what it can't.
|
|
85
|
+
4. **Finish** — `rudder-update-spec` promotes new learnings back into `.rudder/spec/` so the next session starts smarter.
|
|
72
86
|
|
|
73
87
|
## FAQ
|
|
74
88
|
|
|
75
89
|
<details>
|
|
76
|
-
<summary><strong>How is
|
|
90
|
+
<summary><strong>How is this different from <code>CLAUDE.md</code>, <code>AGENTS.md</code>, or <code>.cursorrules</code>?</strong></summary>
|
|
77
91
|
|
|
78
|
-
Those
|
|
92
|
+
Those are useful entry points — until they become 3,000-line monoliths nobody reads. Rudder layers things: scoped specs, per-task PRDs, workflow gates, cross-platform adapters. <strong>One simple rule: don't cram everything into one file.</strong>
|
|
79
93
|
|
|
80
94
|
</details>
|
|
81
95
|
|
|
82
96
|
<details>
|
|
83
97
|
<summary><strong>Is Rudder only for Claude Code?</strong></summary>
|
|
84
98
|
|
|
85
|
-
|
|
99
|
+
Nope. Rudder is a project-layer thing. Works across 14 coding agents and IDEs. Use Gemini for frontend today, Claude Code for backend tomorrow, Codex for review the day after.
|
|
86
100
|
|
|
87
101
|
</details>
|
|
88
102
|
|
|
89
103
|
<details>
|
|
90
|
-
<summary><strong>
|
|
104
|
+
<summary><strong>Solo dev or team?</strong></summary>
|
|
91
105
|
|
|
92
|
-
Both. Solo
|
|
106
|
+
Both. Solo devs get project memory and repeatable workflow. Teams get the bigger win: shared standards, clear task boundaries, reviewable context, and platform portability.
|
|
93
107
|
|
|
94
108
|
</details>
|
|
95
109
|
|
|
96
110
|
<details>
|
|
97
|
-
<summary><strong>Do I have to write every spec file
|
|
111
|
+
<summary><strong>Do I have to write every spec file by hand?</strong></summary>
|
|
98
112
|
|
|
99
|
-
|
|
113
|
+
Nope. Most teams let AI draft specs from existing code first, then tighten the important stuff by hand. Rudder works best when the high-signal rules are explicit and versioned — the rest AI can figure out.
|
|
100
114
|
|
|
101
115
|
</details>
|
|
102
116
|
|
|
103
117
|
<details>
|
|
104
|
-
<summary><strong>
|
|
118
|
+
<summary><strong>Will this cause merge conflicts in a team?</strong></summary>
|
|
105
119
|
|
|
106
|
-
|
|
120
|
+
Nah. Personal workspace journals are per-developer. Shared specs and tasks go through git like any other artifact — merge conflicts are just merge conflicts, nothing new.
|
|
107
121
|
|
|
108
122
|
</details>
|
|
109
123
|
|
|
124
|
+
## Acknowledgments
|
|
125
|
+
|
|
126
|
+
Rudder wouldn't exist without the open-source coding agent community. We studied how many projects solve the same problems — context injection, workflow gates, multi-platform support — and built the version we wished we had.
|
|
127
|
+
|
|
110
128
|
## Star History
|
|
111
129
|
|
|
112
130
|
[](https://star-history.com/#MengDe1231/Rudder&Date)
|
|
113
131
|
|
|
114
132
|
<p align="center">
|
|
115
|
-
<a href="https://docs.tryrudder.app/">Docs</a> •
|
|
116
133
|
<a href="https://github.com/MengDe1231/Rudder">GitHub</a> •
|
|
117
134
|
<a href="https://discord.com/invite/tWcCZ3aRHc">Discord</a> •
|
|
118
135
|
<a href="https://github.com/MengDe1231/Rudder/blob/main/LICENSE">AGPL-3.0 License</a>
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"AA8DA;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhE"}
|
|
@@ -19,9 +19,7 @@ function shouldExclude(filename) {
|
|
|
19
19
|
}
|
|
20
20
|
return false;
|
|
21
21
|
}
|
|
22
|
-
/**
|
|
23
|
-
* Recursively copy directory, excluding build artifacts and the commands/ dir
|
|
24
|
-
* (commands are now written from common templates).
|
|
22
|
+
/** from common templates).
|
|
25
23
|
*/
|
|
26
24
|
async function copyDirFiltered(src, dest, skipDirs = []) {
|
|
27
25
|
ensureDir(dest);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,MAAM,gBAAgB,GAAG;IACvB,OAAO;IACP,WAAW;IACX,KAAK;IACL,SAAS;IACT,aAAa;CACd,CAAC;AAEF,SAAS,aAAa,CAAC,QAAgB;IACrC,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED
|
|
1
|
+
{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,6 +9,9 @@ export interface WorkflowOptions {
|
|
|
9
9
|
skipSpecTemplates?: boolean;
|
|
10
10
|
/** Skip overwriting config.yaml (preserve user customizations during migration) */
|
|
11
11
|
skipConfig?: boolean;
|
|
12
|
+
/** Skip writing config_local.yml — used during platform configure to avoid
|
|
13
|
+
* polluting test filesystems with workflow files that aren't platform templates. */
|
|
14
|
+
skipLocalConfig?: boolean;
|
|
12
15
|
/** Detected monorepo packages (enables monorepo spec creation) */
|
|
13
16
|
packages?: DetectedPackage[];
|
|
14
17
|
/** Package names that use remote templates (skip blank spec for these) */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"AAuCA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;wFACoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAmEf"}
|
|
@@ -2,7 +2,7 @@ import path from "node:path";
|
|
|
2
2
|
import { DIR_NAMES, PATHS } from "../constants/paths.js";
|
|
3
3
|
import { copyRudderDir } from "../templates/extract.js";
|
|
4
4
|
// Import rudder templates (generic, not project-specific)
|
|
5
|
-
import { workflowMdTemplate, configYamlTemplate, gitignoreTemplate, } from "../templates/rudder/index.js";
|
|
5
|
+
import { workflowMdTemplate, configYamlTemplate, configLocalYmlTemplate, gitignoreTemplate, } from "../templates/rudder/index.js";
|
|
6
6
|
// Import markdown templates
|
|
7
7
|
import { agentProgressIndexContent,
|
|
8
8
|
// Backend structure (multi-doc)
|
|
@@ -31,6 +31,7 @@ export async function createWorkflowStructure(cwd, options) {
|
|
|
31
31
|
const projectType = options?.projectType ?? "fullstack";
|
|
32
32
|
const skipSpecTemplates = options?.skipSpecTemplates ?? false;
|
|
33
33
|
const skipConfig = options?.skipConfig ?? false;
|
|
34
|
+
const skipLocalConfig = options?.skipLocalConfig ?? false;
|
|
34
35
|
const packages = options?.packages;
|
|
35
36
|
const remoteSpecPackages = options?.remoteSpecPackages;
|
|
36
37
|
// Create base .rudder directory
|
|
@@ -47,6 +48,17 @@ export async function createWorkflowStructure(cwd, options) {
|
|
|
47
48
|
if (!skipConfig) {
|
|
48
49
|
await writeFile(path.join(cwd, DIR_NAMES.WORKFLOW, "config.yaml"), configYamlTemplate);
|
|
49
50
|
}
|
|
51
|
+
// Copy config_local.yml (personal tool path overrides, gitignored)
|
|
52
|
+
// Only create if not already present — never overwrite user's local config.
|
|
53
|
+
// Skipped during platform configure (skipLocalConfig=true) so test assertions
|
|
54
|
+
// comparing collectPlatformTemplates vs actual files stay in sync.
|
|
55
|
+
const localConfigPath = path.join(cwd, DIR_NAMES.WORKFLOW, "config_local.yml");
|
|
56
|
+
if (!skipConfig && !skipLocalConfig) {
|
|
57
|
+
const { existsSync } = await import("node:fs");
|
|
58
|
+
if (!existsSync(localConfigPath)) {
|
|
59
|
+
await writeFile(localConfigPath, configLocalYmlTemplate);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
50
62
|
// Create workspace/ with index.md
|
|
51
63
|
ensureDir(path.join(cwd, PATHS.WORKSPACE));
|
|
52
64
|
await writeFile(path.join(cwd, PATHS.WORKSPACE, "index.md"), replacePythonCommandLiterals(agentProgressIndexContent));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,0DAA0D;AAC1D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAEtC,4BAA4B;AAC5B,OAAO,EACL,yBAAyB;AACzB,gCAAgC;AAChC,mBAAmB,EACnB,gCAAgC,EAChC,gCAAgC,EAChC,+BAA+B,EAC/B,+BAA+B,EAC/B,2BAA2B;AAC3B,iCAAiC;AACjC,oBAAoB,EACpB,iCAAiC,EACjC,yBAAyB,EACzB,6BAA6B,EAC7B,kCAAkC,EAClC,gCAAgC,EAChC,8BAA8B;AAC9B,mBAAmB;AACnB,kBAAkB,EAClB,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,eAAe,GAGhB,MAAM,8BAA8B,CAAC;
|
|
1
|
+
{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"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"}
|
|
@@ -73,9 +73,38 @@ After finding issues:
|
|
|
73
73
|
|
|
74
74
|
### Step 4: Run Verification
|
|
75
75
|
|
|
76
|
+
#### Step 4a: Static Checks
|
|
77
|
+
|
|
76
78
|
Run project's lint and typecheck commands to verify changes.
|
|
77
79
|
|
|
78
|
-
|
|
80
|
+
#### Step 4b: Compile/Build Verification
|
|
81
|
+
|
|
82
|
+
Detect the project type and run the appropriate compile command:
|
|
83
|
+
|
|
84
|
+
| Project type | Detect by | Compile command |
|
|
85
|
+
|-------------|-----------|-----------------|
|
|
86
|
+
| Java (Maven) | `pom.xml` | `mvn compile -q` |
|
|
87
|
+
| Java (Gradle) | `build.gradle` or `build.gradle.kts` | `./gradlew compileJava -q` |
|
|
88
|
+
| Go | `go.mod` | `go build ./...` |
|
|
89
|
+
| Rust | `Cargo.toml` | `cargo check --all-targets` |
|
|
90
|
+
| Kotlin (Gradle) | `build.gradle.kts` | `./gradlew compileKotlin -q` |
|
|
91
|
+
| TypeScript | `tsconfig.json` | `npx tsc --noEmit` |
|
|
92
|
+
| Node.js (JS only) | `package.json` (no tsconfig) | `npx eslint . --no-error-on-unmatched-pattern` |
|
|
93
|
+
|
|
94
|
+
**Tool path resolution**: Use the paths from the `<tool-paths>` block injected at session-start (e.g., `<tool-paths> - java: /path/to/java </tool-paths>`). If a tool's absolute path is listed there, use it; otherwise fall back to the system PATH.
|
|
95
|
+
|
|
96
|
+
**Tool path discovery**: If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
97
|
+
|
|
98
|
+
#### Step 4c: Compile-Fix Retry Loop
|
|
99
|
+
|
|
100
|
+
If compilation fails, enter a fix loop (max 3 rounds):
|
|
101
|
+
|
|
102
|
+
1. Parse compiler error output — identify file, line, and error message
|
|
103
|
+
2. Fix the source code that caused the error
|
|
104
|
+
3. Re-run the compile command
|
|
105
|
+
4. If still failing after 3 rounds, stop and report remaining errors
|
|
106
|
+
|
|
107
|
+
If failed (static checks), fix issues and re-run before entering Step 4b.
|
|
79
108
|
|
|
80
109
|
---
|
|
81
110
|
|
|
@@ -100,8 +129,13 @@ If failed, fix issues and re-run.
|
|
|
100
129
|
|
|
101
130
|
### Verification Results
|
|
102
131
|
|
|
103
|
-
-
|
|
104
|
-
-
|
|
132
|
+
- Lint: PASS / FAIL
|
|
133
|
+
- TypeCheck: PASS / FAIL
|
|
134
|
+
- Compile: PASS / FAIL (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
135
|
+
|
|
136
|
+
### Compile Errors (if any)
|
|
137
|
+
|
|
138
|
+
(List unresolved compiler errors if max retry reached)
|
|
105
139
|
|
|
106
140
|
### Summary
|
|
107
141
|
|
|
@@ -73,9 +73,38 @@ After finding issues:
|
|
|
73
73
|
|
|
74
74
|
### Step 4: Run Verification
|
|
75
75
|
|
|
76
|
+
#### Step 4a: Static Checks
|
|
77
|
+
|
|
76
78
|
Run project's lint and typecheck commands to verify changes.
|
|
77
79
|
|
|
78
|
-
|
|
80
|
+
#### Step 4b: Compile/Build Verification
|
|
81
|
+
|
|
82
|
+
Detect the project type and run the appropriate compile command:
|
|
83
|
+
|
|
84
|
+
| Project type | Detect by | Compile command |
|
|
85
|
+
|-------------|-----------|-----------------|
|
|
86
|
+
| Java (Maven) | `pom.xml` | `mvn compile -q` |
|
|
87
|
+
| Java (Gradle) | `build.gradle` or `build.gradle.kts` | `./gradlew compileJava -q` |
|
|
88
|
+
| Go | `go.mod` | `go build ./...` |
|
|
89
|
+
| Rust | `Cargo.toml` | `cargo check --all-targets` |
|
|
90
|
+
| Kotlin (Gradle) | `build.gradle.kts` | `./gradlew compileKotlin -q` |
|
|
91
|
+
| TypeScript | `tsconfig.json` | `npx tsc --noEmit` |
|
|
92
|
+
| Node.js (JS only) | `package.json` (no tsconfig) | `npx eslint . --no-error-on-unmatched-pattern` |
|
|
93
|
+
|
|
94
|
+
**Tool path resolution**: Use the paths from the `<tool-paths>` block injected at session-start (e.g., `<tool-paths> - java: /path/to/java </tool-paths>`). If a tool's absolute path is listed there, use it; otherwise fall back to the system PATH.
|
|
95
|
+
|
|
96
|
+
**Tool path discovery**: If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
97
|
+
|
|
98
|
+
#### Step 4c: Compile-Fix Retry Loop
|
|
99
|
+
|
|
100
|
+
If compilation fails, enter a fix loop (max 3 rounds):
|
|
101
|
+
|
|
102
|
+
1. Parse compiler error output — identify file, line, and error message
|
|
103
|
+
2. Fix the source code that caused the error
|
|
104
|
+
3. Re-run the compile command
|
|
105
|
+
4. If still failing after 3 rounds, stop and report remaining errors
|
|
106
|
+
|
|
107
|
+
If Step 4a failed (static checks), fix issues and re-run before entering Step 4b.
|
|
79
108
|
|
|
80
109
|
---
|
|
81
110
|
|
|
@@ -100,8 +129,13 @@ If failed, fix issues and re-run.
|
|
|
100
129
|
|
|
101
130
|
### Verification Results
|
|
102
131
|
|
|
103
|
-
-
|
|
104
|
-
-
|
|
132
|
+
- Lint: PASS / FAIL
|
|
133
|
+
- TypeCheck: PASS / FAIL
|
|
134
|
+
- Compile: PASS / FAIL (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
135
|
+
|
|
136
|
+
### Compile Errors (if any)
|
|
137
|
+
|
|
138
|
+
(List unresolved compiler errors if max retry reached)
|
|
105
139
|
|
|
106
140
|
### Summary
|
|
107
141
|
|
|
@@ -47,11 +47,15 @@ Review checklist:
|
|
|
47
47
|
- Check whether tests should be added or updated.
|
|
48
48
|
- Check whether `.rudder/spec/` docs need sync after implementation.
|
|
49
49
|
- Run lint and type-check; fix any failures.
|
|
50
|
+
- Detect project type and run compile: Maven (`mvn compile -q`), Gradle (`./gradlew compileJava -q`), Go (`go build ./...`), Rust (`cargo check --all-targets`), TypeScript (`npx tsc --noEmit`), or Node.js (`npx eslint . --no-error-on-unmatched-pattern`).
|
|
51
|
+
- If compilation fails, fix and retry up to 3 rounds. Parse error output, fix source code, re-run compile. Stop and report remaining errors after 3 rounds.
|
|
52
|
+
- Use tool paths from the `<tool-paths>` block injected at session-start if available; otherwise fall back to system PATH.
|
|
53
|
+
- If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
50
54
|
- Prefer concrete findings over speculative warnings.
|
|
51
55
|
|
|
52
56
|
When you find an issue:
|
|
53
57
|
1. Fix it directly using edit/write tools.
|
|
54
|
-
2. Re-run lint
|
|
58
|
+
2. Re-run lint, type-check, and compile until green.
|
|
55
59
|
3. Record what you changed and why.
|
|
56
60
|
|
|
57
61
|
Output format:
|
|
@@ -66,9 +70,12 @@ Only list issues you could not self-fix (e.g. missing product decision, out-of-s
|
|
|
66
70
|
## Verification
|
|
67
71
|
- Lint: pass/fail
|
|
68
72
|
- TypeCheck: pass/fail
|
|
69
|
-
-
|
|
73
|
+
- Compile: pass/fail (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
70
74
|
|
|
71
|
-
|
|
75
|
+
## Compile Errors (if any)
|
|
76
|
+
(List unresolved compiler errors if max retry reached)
|
|
77
|
+
|
|
78
|
+
If no issues are found, say so explicitly after verifying lint/type-check/compile pass.
|
|
72
79
|
"""
|
|
73
80
|
|
|
74
81
|
# Disable Codex collab tools entirely for this sub-agent. With both
|
|
@@ -72,9 +72,38 @@ After finding issues:
|
|
|
72
72
|
|
|
73
73
|
### Step 4: Run Verification
|
|
74
74
|
|
|
75
|
+
#### Step 4a: Static Checks
|
|
76
|
+
|
|
75
77
|
Run project's lint and typecheck commands to verify changes.
|
|
76
78
|
|
|
77
|
-
|
|
79
|
+
#### Step 4b: Compile/Build Verification
|
|
80
|
+
|
|
81
|
+
Detect the project type and run the appropriate compile command:
|
|
82
|
+
|
|
83
|
+
| Project type | Detect by | Compile command |
|
|
84
|
+
|-------------|-----------|-----------------|
|
|
85
|
+
| Java (Maven) | `pom.xml` | `mvn compile -q` |
|
|
86
|
+
| Java (Gradle) | `build.gradle` or `build.gradle.kts` | `./gradlew compileJava -q` |
|
|
87
|
+
| Go | `go.mod` | `go build ./...` |
|
|
88
|
+
| Rust | `Cargo.toml` | `cargo check --all-targets` |
|
|
89
|
+
| Kotlin (Gradle) | `build.gradle.kts` | `./gradlew compileKotlin -q` |
|
|
90
|
+
| TypeScript | `tsconfig.json` | `npx tsc --noEmit` |
|
|
91
|
+
| Node.js (JS only) | `package.json` (no tsconfig) | `npx eslint . --no-error-on-unmatched-pattern` |
|
|
92
|
+
|
|
93
|
+
**Tool path resolution**: Use the paths from the `<tool-paths>` block injected at session-start (e.g., `<tool-paths> - java: /path/to/java </tool-paths>`). If a tool's absolute path is listed there, use it; otherwise fall back to the system PATH.
|
|
94
|
+
|
|
95
|
+
**Tool path discovery**: If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
96
|
+
|
|
97
|
+
#### Step 4c: Compile-Fix Retry Loop
|
|
98
|
+
|
|
99
|
+
If compilation fails, enter a fix loop (max 3 rounds):
|
|
100
|
+
|
|
101
|
+
1. Parse compiler error output — identify file, line, and error message
|
|
102
|
+
2. Fix the source code that caused the error
|
|
103
|
+
3. Re-run the compile command
|
|
104
|
+
4. If still failing after 3 rounds, stop and report remaining errors
|
|
105
|
+
|
|
106
|
+
If Step 4a failed (static checks), fix issues and re-run before entering Step 4b.
|
|
78
107
|
|
|
79
108
|
---
|
|
80
109
|
|
|
@@ -99,8 +128,13 @@ If failed, fix issues and re-run.
|
|
|
99
128
|
|
|
100
129
|
### Verification Results
|
|
101
130
|
|
|
102
|
-
-
|
|
103
|
-
-
|
|
131
|
+
- Lint: PASS / FAIL
|
|
132
|
+
- TypeCheck: PASS / FAIL
|
|
133
|
+
- Compile: PASS / FAIL (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
134
|
+
|
|
135
|
+
### Compile Errors (if any)
|
|
136
|
+
|
|
137
|
+
(List unresolved compiler errors if max retry reached)
|
|
104
138
|
|
|
105
139
|
### Summary
|
|
106
140
|
|
|
@@ -14,12 +14,6 @@
|
|
|
14
14
|
"timeout": 30
|
|
15
15
|
}
|
|
16
16
|
],
|
|
17
|
-
"beforeSubmitPrompt": [
|
|
18
|
-
{
|
|
19
|
-
"command": "{{PYTHON_CMD}} .cursor/hooks/inject-workflow-state.py",
|
|
20
|
-
"timeout": 15
|
|
21
|
-
}
|
|
22
|
-
],
|
|
23
17
|
"beforeShellExecution": [
|
|
24
18
|
{
|
|
25
19
|
"command": "{{PYTHON_CMD}} .cursor/hooks/inject-shell-session-context.py",
|
|
@@ -65,9 +65,38 @@ After finding issues:
|
|
|
65
65
|
|
|
66
66
|
### Step 4: Run Verification
|
|
67
67
|
|
|
68
|
+
#### Step 4a: Static Checks
|
|
69
|
+
|
|
68
70
|
Run project's lint and typecheck commands to verify changes.
|
|
69
71
|
|
|
70
|
-
|
|
72
|
+
#### Step 4b: Compile/Build Verification
|
|
73
|
+
|
|
74
|
+
Detect the project type and run the appropriate compile command:
|
|
75
|
+
|
|
76
|
+
| Project type | Detect by | Compile command |
|
|
77
|
+
|-------------|-----------|-----------------|
|
|
78
|
+
| Java (Maven) | `pom.xml` | `mvn compile -q` |
|
|
79
|
+
| Java (Gradle) | `build.gradle` or `build.gradle.kts` | `./gradlew compileJava -q` |
|
|
80
|
+
| Go | `go.mod` | `go build ./...` |
|
|
81
|
+
| Rust | `Cargo.toml` | `cargo check --all-targets` |
|
|
82
|
+
| Kotlin (Gradle) | `build.gradle.kts` | `./gradlew compileKotlin -q` |
|
|
83
|
+
| TypeScript | `tsconfig.json` | `npx tsc --noEmit` |
|
|
84
|
+
| Node.js (JS only) | `package.json` (no tsconfig) | `npx eslint . --no-error-on-unmatched-pattern` |
|
|
85
|
+
|
|
86
|
+
**Tool path resolution**: Use the paths from the `<tool-paths>` block injected at session-start (e.g., `<tool-paths> - java: /path/to/java </tool-paths>`). If a tool's absolute path is listed there, use it; otherwise fall back to the system PATH.
|
|
87
|
+
|
|
88
|
+
**Tool path discovery**: If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
89
|
+
|
|
90
|
+
#### Step 4c: Compile-Fix Retry Loop
|
|
91
|
+
|
|
92
|
+
If compilation fails, enter a fix loop (max 3 rounds):
|
|
93
|
+
|
|
94
|
+
1. Parse compiler error output — identify file, line, and error message
|
|
95
|
+
2. Fix the source code that caused the error
|
|
96
|
+
3. Re-run the compile command
|
|
97
|
+
4. If still failing after 3 rounds, stop and report remaining errors
|
|
98
|
+
|
|
99
|
+
If Step 4a failed (static checks), fix issues and re-run before entering Step 4b.
|
|
71
100
|
|
|
72
101
|
---
|
|
73
102
|
|
|
@@ -92,8 +121,13 @@ If failed, fix issues and re-run.
|
|
|
92
121
|
|
|
93
122
|
### Verification Results
|
|
94
123
|
|
|
95
|
-
-
|
|
96
|
-
-
|
|
124
|
+
- Lint: PASS / FAIL
|
|
125
|
+
- TypeCheck: PASS / FAIL
|
|
126
|
+
- Compile: PASS / FAIL (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
127
|
+
|
|
128
|
+
### Compile Errors (if any)
|
|
129
|
+
|
|
130
|
+
(List unresolved compiler errors if max retry reached)
|
|
97
131
|
|
|
98
132
|
### Summary
|
|
99
133
|
|
|
@@ -65,9 +65,38 @@ After finding issues:
|
|
|
65
65
|
|
|
66
66
|
### Step 4: Run Verification
|
|
67
67
|
|
|
68
|
+
#### Step 4a: Static Checks
|
|
69
|
+
|
|
68
70
|
Run project's lint and typecheck commands to verify changes.
|
|
69
71
|
|
|
70
|
-
|
|
72
|
+
#### Step 4b: Compile/Build Verification
|
|
73
|
+
|
|
74
|
+
Detect the project type and run the appropriate compile command:
|
|
75
|
+
|
|
76
|
+
| Project type | Detect by | Compile command |
|
|
77
|
+
|-------------|-----------|-----------------|
|
|
78
|
+
| Java (Maven) | `pom.xml` | `mvn compile -q` |
|
|
79
|
+
| Java (Gradle) | `build.gradle` or `build.gradle.kts` | `./gradlew compileJava -q` |
|
|
80
|
+
| Go | `go.mod` | `go build ./...` |
|
|
81
|
+
| Rust | `Cargo.toml` | `cargo check --all-targets` |
|
|
82
|
+
| Kotlin (Gradle) | `build.gradle.kts` | `./gradlew compileKotlin -q` |
|
|
83
|
+
| TypeScript | `tsconfig.json` | `npx tsc --noEmit` |
|
|
84
|
+
| Node.js (JS only) | `package.json` (no tsconfig) | `npx eslint . --no-error-on-unmatched-pattern` |
|
|
85
|
+
|
|
86
|
+
**Tool path resolution**: Use the paths from the `<tool-paths>` block injected at session-start (e.g., `<tool-paths> - java: /path/to/java </tool-paths>`). If a tool's absolute path is listed there, use it; otherwise fall back to the system PATH.
|
|
87
|
+
|
|
88
|
+
**Tool path discovery**: If a required tool is not found or the path is wrong, locate the correct path (e.g., `which mvn`, `where java`) and update `.rudder/config_local.yml` so future sessions can use it directly.
|
|
89
|
+
|
|
90
|
+
#### Step 4c: Compile-Fix Retry Loop
|
|
91
|
+
|
|
92
|
+
If compilation fails, enter a fix loop (max 3 rounds):
|
|
93
|
+
|
|
94
|
+
1. Parse compiler error output — identify file, line, and error message
|
|
95
|
+
2. Fix the source code that caused the error
|
|
96
|
+
3. Re-run the compile command
|
|
97
|
+
4. If still failing after 3 rounds, stop and report remaining errors
|
|
98
|
+
|
|
99
|
+
If Step 4a failed (static checks), fix issues and re-run before entering Step 4b.
|
|
71
100
|
|
|
72
101
|
---
|
|
73
102
|
|
|
@@ -92,8 +121,13 @@ If failed, fix issues and re-run.
|
|
|
92
121
|
|
|
93
122
|
### Verification Results
|
|
94
123
|
|
|
95
|
-
-
|
|
96
|
-
-
|
|
124
|
+
- Lint: PASS / FAIL
|
|
125
|
+
- TypeCheck: PASS / FAIL
|
|
126
|
+
- Compile: PASS / FAIL (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
|
|
127
|
+
|
|
128
|
+
### Compile Errors (if any)
|
|
129
|
+
|
|
130
|
+
(List unresolved compiler errors if max retry reached)
|
|
97
131
|
|
|
98
132
|
### Summary
|
|
99
133
|
|