@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.
Files changed (34) hide show
  1. package/README.md +59 -42
  2. package/dist/configurators/claude.d.ts.map +1 -1
  3. package/dist/configurators/claude.js +1 -3
  4. package/dist/configurators/claude.js.map +1 -1
  5. package/dist/configurators/workflow.d.ts +3 -0
  6. package/dist/configurators/workflow.d.ts.map +1 -1
  7. package/dist/configurators/workflow.js +13 -1
  8. package/dist/configurators/workflow.js.map +1 -1
  9. package/dist/templates/claude/agents/rudder-check.md +37 -3
  10. package/dist/templates/codebuddy/agents/rudder-check.md +37 -3
  11. package/dist/templates/codex/agents/rudder-check.toml +10 -3
  12. package/dist/templates/cursor/agents/rudder-check.md +37 -3
  13. package/dist/templates/cursor/hooks.json +0 -6
  14. package/dist/templates/droid/droids/rudder-check.md +37 -3
  15. package/dist/templates/gemini/agents/rudder-check.md +37 -3
  16. package/dist/templates/kiro/agents/rudder-check.json +1 -1
  17. package/dist/templates/opencode/agents/rudder-check.md +37 -3
  18. package/dist/templates/pi/agents/rudder-check.md +68 -1
  19. package/dist/templates/qoder/agents/rudder-check.md +37 -3
  20. package/dist/templates/rudder/config.yaml +16 -3
  21. package/dist/templates/rudder/config_local.yml +17 -0
  22. package/dist/templates/rudder/gitignore.txt +1 -1
  23. package/dist/templates/rudder/index.d.ts +1 -0
  24. package/dist/templates/rudder/index.d.ts.map +1 -1
  25. package/dist/templates/rudder/index.js +1 -0
  26. package/dist/templates/rudder/index.js.map +1 -1
  27. package/dist/templates/rudder/scripts/common/config.py +42 -12
  28. package/dist/templates/rudder/scripts/common/rudder_config.py +26 -4
  29. package/dist/templates/rudder/workflow.md +6 -2
  30. package/dist/templates/shared-hooks/index.d.ts.map +1 -1
  31. package/dist/templates/shared-hooks/index.js +0 -1
  32. package/dist/templates/shared-hooks/index.js.map +1 -1
  33. package/dist/templates/shared-hooks/session-start.py +25 -8
  34. 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 (placeholder)" width="500" style="image-rendering: -webkit-optimize-contrast; image-rendering: crisp-edges;">
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>The harness that makes coding agents production-ready</strong><br/>
12
- <sub>Start a feature in Gemini, continue in Claude Code, ship it with Codex — or hand it off to a teammate at any step. Context, specs, and standards are shared across every agent and every teammate.</sub>
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
- <p align="center">
31
- <img src="assets/rudder-demo.gif" alt="Rudder workflow demo" width="100%">
32
- </p>
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
- ## Why Rudder?
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/`, then let Rudder inject the relevant context into each session instead of repeating yourself. |
39
- | **Task-centered workflow** | Keep PRDs, implementation context, review context, and task status in `.rudder/tasks/` so AI work stays structured. |
40
- | **Project memory** | Journals in `.rudder/workspace/` preserve what happened last time, so each new session starts with real context. |
41
- | **Team-shared standards** | Specs live in the repo, so one person's hard-won workflow or rule can benefit the whole team. |
42
- | **Multi-platform setup** | Bring the same Rudder structure to 14 AI coding platforms instead of rebuilding your workflow per tool. |
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
- ## Prerequisites
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 Rudder
68
+ # 1. Install
53
69
  npm install -g @mengde1231/rudder@latest
54
70
 
55
- # 2. Initialize in your repo
71
+ # 2. Initialize (all platforms)
56
72
  rudder init -u your-name
57
73
 
58
- # 3. Or initialize with the platforms you actually use
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
- See the [Quick Start](https://docs.tryrudder.app/start/install-and-first-task) and [Supported Platforms](https://docs.tryrudder.app/advanced/multi-platform) guides for setup details.
63
-
64
- ## How It Works
78
+ ## How it works
65
79
 
66
- Rudder runs a 4-phase loop with auto-invoked skills and sub-agents:
80
+ Rudder runs a 4-phase loop every session:
67
81
 
68
- 1. **Plan** — `rudder-brainstorm` walks through requirements one question at a time and writes `prd.md`. Research-heavy items go to a `rudder-research` sub-agent. The result is curated specs + research files referenced from `implement.jsonl` / `check.jsonl`.
69
- 2. **Implement** — a `rudder-implement` sub-agent writes code from the PRD with the curated context auto-injected, no git commit.
70
- 3. **Verify** — a `rudder-check` sub-agent reviews the diff against specs and runs lint, type-check, and tests, self-fixing where it can.
71
- 4. **Finish** — a final check runs, then `rudder-update-spec` promotes new learnings back into `.rudder/spec/` so the next session starts smarter.
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 Rudder different from <code>CLAUDE.md</code>, <code>AGENTS.md</code>, or <code>.cursorrules</code>?</strong></summary>
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 files are useful entry points, but they tend to become monolithic. Rudder adds scoped specs, task PRDs, workflow gates, workspace memory, and platform-aware generated files around them.
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
- No. Rudder is a project layer that works across multiple coding agents and IDEs.
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>Is Rudder for solo developers or teams?</strong></summary>
104
+ <summary><strong>Solo dev or team?</strong></summary>
91
105
 
92
- Both. Solo developers use it for memory and repeatable workflow. Teams get the larger benefit: shared standards, task boundaries, reviewable context, and platform portability.
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 manually?</strong></summary>
111
+ <summary><strong>Do I have to write every spec file by hand?</strong></summary>
98
112
 
99
- No. Many teams start by letting AI draft specs from existing code and then tighten the important parts by hand. Rudder works best when you keep the high-signal rules explicit and versioned.
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>Can teams use this without constant conflicts?</strong></summary>
118
+ <summary><strong>Will this cause merge conflicts in a team?</strong></summary>
105
119
 
106
- Yes. Personal workspace journals stay separate per developer, while shared specs and tasks stay in the repo where they can be reviewed and improved like any other project artifact.
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
  [![Star History Chart](https://api.star-history.com/svg?repos=MengDe1231/Rudder&type=Date)](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":"AAgEA;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhE"}
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":"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"}
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":"AAsCA,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,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,CAsDf"}
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":"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"}
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
- If failed, fix issues and re-run.
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
- - TypeCheck: Passed
104
- - Lint: Passed
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
- If failed, fix issues and re-run.
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
- - TypeCheck: Passed
104
- - Lint: Passed
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 and type-check until green.
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
- - Tests: pass/fail (if applicable)
73
+ - Compile: pass/fail (project: Maven/Gradle/Go/Rust/TS/JS, rounds: N)
70
74
 
71
- If no issues are found, say so explicitly after verifying lint/type-check pass.
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
- If failed, fix issues and re-run.
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
- - TypeCheck: Passed
103
- - Lint: Passed
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
- If failed, fix issues and re-run.
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
- - TypeCheck: Passed
96
- - Lint: Passed
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
- If failed, fix issues and re-run.
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
- - TypeCheck: Passed
96
- - Lint: Passed
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