@blxzer/cursor-trellis 0.1.0 → 0.1.1

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 (279) hide show
  1. package/README.md +124 -5
  2. package/README.zh-CN.md +170 -0
  3. package/dist/cli/index.d.ts.map +1 -1
  4. package/dist/cli/index.js +1 -33
  5. package/dist/cli/index.js.map +1 -1
  6. package/dist/commands/init.d.ts +0 -13
  7. package/dist/commands/init.d.ts.map +1 -1
  8. package/dist/commands/init.js +7 -14
  9. package/dist/commands/init.js.map +1 -1
  10. package/dist/commands/uninstall.d.ts.map +1 -1
  11. package/dist/commands/uninstall.js +3 -32
  12. package/dist/commands/uninstall.js.map +1 -1
  13. package/dist/commands/update.d.ts.map +1 -1
  14. package/dist/commands/update.js +7 -84
  15. package/dist/commands/update.js.map +1 -1
  16. package/dist/configurators/index.d.ts +7 -8
  17. package/dist/configurators/index.d.ts.map +1 -1
  18. package/dist/configurators/index.js +11 -236
  19. package/dist/configurators/index.js.map +1 -1
  20. package/dist/configurators/workflow.d.ts.map +1 -1
  21. package/dist/configurators/workflow.js +5 -1
  22. package/dist/configurators/workflow.js.map +1 -1
  23. package/dist/templates/common/bundled-skills/smart-search-cli/SKILL.md +3 -3
  24. package/dist/templates/common/bundled-skills/trellis-meta/SKILL.md +4 -2
  25. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-agents.md +8 -15
  26. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-hooks.md +7 -7
  27. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-skills-or-commands.md +18 -21
  28. package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/overview.md +2 -2
  29. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/generated-files.md +10 -7
  30. package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/overview.md +4 -4
  31. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/agents.md +20 -31
  32. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/hooks-and-settings.md +20 -31
  33. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/overview.md +24 -40
  34. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/platform-map.md +28 -59
  35. package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/skills-and-commands.md +12 -28
  36. package/dist/templates/common/bundled-skills/trellis-skill-creator/references/trellis-skill-locations.md +2 -2
  37. package/dist/templates/cursor/hooks.json +6 -0
  38. package/dist/templates/cursor/rules/retrieval-routing.mdc +57 -0
  39. package/dist/templates/extract.d.ts +0 -14
  40. package/dist/templates/extract.d.ts.map +1 -1
  41. package/dist/templates/extract.js +0 -34
  42. package/dist/templates/extract.js.map +1 -1
  43. package/dist/templates/markdown/agents.md +2 -6
  44. package/dist/templates/markdown/index.d.ts +1 -0
  45. package/dist/templates/markdown/index.d.ts.map +1 -1
  46. package/dist/templates/markdown/index.js +1 -0
  47. package/dist/templates/markdown/index.js.map +1 -1
  48. package/dist/templates/markdown/prompts/run-semantic-slice-12.md.txt +41 -0
  49. package/dist/templates/markdown/spec/guides/code-reuse-thinking-guide.md.txt +14 -14
  50. package/dist/templates/markdown/spec/guides/cross-layer-thinking-guide.md.txt +8 -20
  51. package/dist/templates/markdown/spec/guides/cross-platform-thinking-guide.md.txt +15 -14
  52. package/dist/templates/markdown/spec/guides/cursor-context-injection-guide.md.txt +2 -1
  53. package/dist/templates/markdown/spec/guides/cursor-semantic-compliance.md.txt +49 -0
  54. package/dist/templates/markdown/spec/guides/cursor-subagent-policy.md.txt +2 -2
  55. package/dist/templates/markdown/spec/guides/retrieval-daily-guide.md.txt +68 -20
  56. package/dist/templates/shared-hooks/index.d.ts +1 -1
  57. package/dist/templates/shared-hooks/index.d.ts.map +1 -1
  58. package/dist/templates/shared-hooks/index.js +1 -0
  59. package/dist/templates/shared-hooks/index.js.map +1 -1
  60. package/dist/templates/shared-hooks/inject-retrieval-plan.py +163 -0
  61. package/dist/templates/shared-hooks/research-end-retrieval-pack.py +2 -11
  62. package/dist/templates/trellis/index.d.ts +11 -0
  63. package/dist/templates/trellis/index.d.ts.map +1 -1
  64. package/dist/templates/trellis/index.js +22 -0
  65. package/dist/templates/trellis/index.js.map +1 -1
  66. package/dist/templates/trellis/scripts/aggregate_retrieval_telemetry.py +342 -0
  67. package/dist/templates/trellis/scripts/batch_plan_envelope.py +105 -0
  68. package/dist/templates/trellis/scripts/codegraph_session_smoke.py +76 -0
  69. package/dist/templates/trellis/scripts/common/active_task.py +116 -147
  70. package/dist/templates/trellis/scripts/common/cli_adapter.py +34 -710
  71. package/dist/templates/trellis/scripts/common/codebase_retrieval_router.py +49 -106
  72. package/dist/templates/trellis/scripts/common/git_context.py +17 -2
  73. package/dist/templates/trellis/scripts/common/project_file_stats.py +91 -0
  74. package/dist/templates/trellis/scripts/common/retrieval_adapter_metadata.py +9 -11
  75. package/dist/templates/trellis/scripts/common/retrieval_agent_instructions.py +313 -0
  76. package/dist/templates/trellis/scripts/common/retrieval_pack.py +0 -6
  77. package/dist/templates/trellis/scripts/common/retrieval_pack_context.py +0 -4
  78. package/dist/templates/trellis/scripts/common/retrieval_plan_gate.py +76 -0
  79. package/dist/templates/trellis/scripts/common/retrieval_result_ranking.py +253 -0
  80. package/dist/templates/trellis/scripts/common/retrieval_tool_classification.py +157 -0
  81. package/dist/templates/trellis/scripts/common/semantic_plan_gate.py +52 -0
  82. package/dist/templates/trellis/scripts/common/workflow_phase.py +3 -24
  83. package/dist/templates/trellis/scripts/rank_retrieval_candidates.py +80 -0
  84. package/dist/templates/trellis/scripts/route_codebase_retrieval.py +38 -11
  85. package/dist/templates/trellis/scripts/score_evidence.py +112 -0
  86. package/dist/templates/trellis/workflow.md +861 -960
  87. package/dist/types/ai-tools.d.ts +13 -16
  88. package/dist/types/ai-tools.d.ts.map +1 -1
  89. package/dist/types/ai-tools.js +5 -238
  90. package/dist/types/ai-tools.js.map +1 -1
  91. package/dist/utils/codebase-retrieval-router.d.ts +1 -8
  92. package/dist/utils/codebase-retrieval-router.d.ts.map +1 -1
  93. package/dist/utils/codebase-retrieval-router.js +39 -180
  94. package/dist/utils/codebase-retrieval-router.js.map +1 -1
  95. package/dist/utils/project-capabilities.d.ts.map +1 -1
  96. package/dist/utils/project-capabilities.js +10 -24
  97. package/dist/utils/project-capabilities.js.map +1 -1
  98. package/dist/utils/retrieval-agent-instructions.d.ts +14 -0
  99. package/dist/utils/retrieval-agent-instructions.d.ts.map +1 -0
  100. package/dist/utils/retrieval-agent-instructions.js +221 -0
  101. package/dist/utils/retrieval-agent-instructions.js.map +1 -0
  102. package/dist/utils/retrieval-execution-telemetry.d.ts +43 -85
  103. package/dist/utils/retrieval-execution-telemetry.d.ts.map +1 -1
  104. package/dist/utils/retrieval-execution-telemetry.js +289 -22
  105. package/dist/utils/retrieval-execution-telemetry.js.map +1 -1
  106. package/dist/utils/retrieval-result-ranking.js +1 -1
  107. package/dist/utils/retrieval-result-ranking.js.map +1 -1
  108. package/dist/utils/retrieval-tool-classification.d.ts +32 -0
  109. package/dist/utils/retrieval-tool-classification.d.ts.map +1 -0
  110. package/dist/utils/retrieval-tool-classification.js +113 -0
  111. package/dist/utils/retrieval-tool-classification.js.map +1 -0
  112. package/dist/utils/uninstall-scrubbers.d.ts +0 -36
  113. package/dist/utils/uninstall-scrubbers.d.ts.map +1 -1
  114. package/dist/utils/uninstall-scrubbers.js +0 -184
  115. package/dist/utils/uninstall-scrubbers.js.map +1 -1
  116. package/package.json +4 -2
  117. package/dist/commands/mem.d.ts +0 -30
  118. package/dist/commands/mem.d.ts.map +0 -1
  119. package/dist/commands/mem.js +0 -424
  120. package/dist/commands/mem.js.map +0 -1
  121. package/dist/configurators/antigravity.d.ts +0 -7
  122. package/dist/configurators/antigravity.d.ts.map +0 -1
  123. package/dist/configurators/antigravity.js +0 -19
  124. package/dist/configurators/antigravity.js.map +0 -1
  125. package/dist/configurators/claude.d.ts +0 -9
  126. package/dist/configurators/claude.d.ts.map +0 -1
  127. package/dist/configurators/claude.js +0 -72
  128. package/dist/configurators/claude.js.map +0 -1
  129. package/dist/configurators/codebuddy.d.ts +0 -10
  130. package/dist/configurators/codebuddy.d.ts.map +0 -1
  131. package/dist/configurators/codebuddy.js +0 -30
  132. package/dist/configurators/codebuddy.js.map +0 -1
  133. package/dist/configurators/codex.d.ts +0 -8
  134. package/dist/configurators/codex.d.ts.map +0 -1
  135. package/dist/configurators/codex.js +0 -87
  136. package/dist/configurators/codex.js.map +0 -1
  137. package/dist/configurators/copilot.d.ts +0 -10
  138. package/dist/configurators/copilot.d.ts.map +0 -1
  139. package/dist/configurators/copilot.js +0 -51
  140. package/dist/configurators/copilot.js.map +0 -1
  141. package/dist/configurators/droid.d.ts +0 -10
  142. package/dist/configurators/droid.d.ts.map +0 -1
  143. package/dist/configurators/droid.js +0 -30
  144. package/dist/configurators/droid.js.map +0 -1
  145. package/dist/configurators/gemini.d.ts +0 -16
  146. package/dist/configurators/gemini.d.ts.map +0 -1
  147. package/dist/configurators/gemini.js +0 -38
  148. package/dist/configurators/gemini.js.map +0 -1
  149. package/dist/configurators/kilo.d.ts +0 -7
  150. package/dist/configurators/kilo.d.ts.map +0 -1
  151. package/dist/configurators/kilo.js +0 -19
  152. package/dist/configurators/kilo.js.map +0 -1
  153. package/dist/configurators/kiro.d.ts +0 -8
  154. package/dist/configurators/kiro.d.ts.map +0 -1
  155. package/dist/configurators/kiro.js +0 -24
  156. package/dist/configurators/kiro.js.map +0 -1
  157. package/dist/configurators/opencode.d.ts +0 -14
  158. package/dist/configurators/opencode.d.ts.map +0 -1
  159. package/dist/configurators/opencode.js +0 -96
  160. package/dist/configurators/opencode.js.map +0 -1
  161. package/dist/configurators/pi.d.ts +0 -3
  162. package/dist/configurators/pi.d.ts.map +0 -1
  163. package/dist/configurators/pi.js +0 -45
  164. package/dist/configurators/pi.js.map +0 -1
  165. package/dist/configurators/qoder.d.ts +0 -11
  166. package/dist/configurators/qoder.d.ts.map +0 -1
  167. package/dist/configurators/qoder.js +0 -31
  168. package/dist/configurators/qoder.js.map +0 -1
  169. package/dist/configurators/windsurf.d.ts +0 -7
  170. package/dist/configurators/windsurf.d.ts.map +0 -1
  171. package/dist/configurators/windsurf.js +0 -19
  172. package/dist/configurators/windsurf.js.map +0 -1
  173. package/dist/templates/claude/agents/trellis-check.md +0 -124
  174. package/dist/templates/claude/agents/trellis-implement.md +0 -110
  175. package/dist/templates/claude/agents/trellis-research.md +0 -137
  176. package/dist/templates/claude/index.d.ts +0 -22
  177. package/dist/templates/claude/index.d.ts.map +0 -1
  178. package/dist/templates/claude/index.js +0 -46
  179. package/dist/templates/claude/index.js.map +0 -1
  180. package/dist/templates/claude/settings.json +0 -84
  181. package/dist/templates/codebuddy/agents/trellis-check.md +0 -115
  182. package/dist/templates/codebuddy/agents/trellis-implement.md +0 -110
  183. package/dist/templates/codebuddy/agents/trellis-research.md +0 -137
  184. package/dist/templates/codebuddy/index.d.ts +0 -15
  185. package/dist/templates/codebuddy/index.d.ts.map +0 -1
  186. package/dist/templates/codebuddy/index.js +0 -15
  187. package/dist/templates/codebuddy/index.js.map +0 -1
  188. package/dist/templates/codebuddy/settings.json +0 -70
  189. package/dist/templates/codex/agents/trellis-check.toml +0 -67
  190. package/dist/templates/codex/agents/trellis-implement.toml +0 -40
  191. package/dist/templates/codex/agents/trellis-research.toml +0 -73
  192. package/dist/templates/codex/config.toml +0 -28
  193. package/dist/templates/codex/hooks/session-start.py +0 -575
  194. package/dist/templates/codex/hooks.json +0 -15
  195. package/dist/templates/codex/index.d.ts +0 -39
  196. package/dist/templates/codex/index.d.ts.map +0 -1
  197. package/dist/templates/codex/index.js +0 -85
  198. package/dist/templates/codex/index.js.map +0 -1
  199. package/dist/templates/codex/skills/before-dev/SKILL.md +0 -40
  200. package/dist/templates/codex/skills/brainstorm/SKILL.md +0 -112
  201. package/dist/templates/codex/skills/break-loop/SKILL.md +0 -130
  202. package/dist/templates/codex/skills/check/SKILL.md +0 -98
  203. package/dist/templates/codex/skills/check-cross-layer/SKILL.md +0 -158
  204. package/dist/templates/codex/skills/create-command/SKILL.md +0 -101
  205. package/dist/templates/codex/skills/finish-work/SKILL.md +0 -90
  206. package/dist/templates/codex/skills/improve-ut/SKILL.md +0 -69
  207. package/dist/templates/codex/skills/integrate-skill/SKILL.md +0 -221
  208. package/dist/templates/codex/skills/onboard/SKILL.md +0 -363
  209. package/dist/templates/codex/skills/record-session/SKILL.md +0 -67
  210. package/dist/templates/codex/skills/start/SKILL.md +0 -66
  211. package/dist/templates/codex/skills/update-spec/SKILL.md +0 -335
  212. package/dist/templates/copilot/hooks/session-start.py +0 -557
  213. package/dist/templates/copilot/hooks.json +0 -19
  214. package/dist/templates/copilot/index.d.ts +0 -23
  215. package/dist/templates/copilot/index.d.ts.map +0 -1
  216. package/dist/templates/copilot/index.js +0 -54
  217. package/dist/templates/copilot/index.js.map +0 -1
  218. package/dist/templates/copilot/prompts/before-dev.prompt.md +0 -39
  219. package/dist/templates/copilot/prompts/brainstorm.prompt.md +0 -111
  220. package/dist/templates/copilot/prompts/break-loop.prompt.md +0 -129
  221. package/dist/templates/copilot/prompts/check-cross-layer.prompt.md +0 -157
  222. package/dist/templates/copilot/prompts/check.prompt.md +0 -97
  223. package/dist/templates/copilot/prompts/create-command.prompt.md +0 -116
  224. package/dist/templates/copilot/prompts/finish-work.prompt.md +0 -99
  225. package/dist/templates/copilot/prompts/integrate-skill.prompt.md +0 -223
  226. package/dist/templates/copilot/prompts/onboard.prompt.md +0 -362
  227. package/dist/templates/copilot/prompts/parallel.prompt.md +0 -204
  228. package/dist/templates/copilot/prompts/record-session.prompt.md +0 -66
  229. package/dist/templates/copilot/prompts/start.prompt.md +0 -63
  230. package/dist/templates/copilot/prompts/update-spec.prompt.md +0 -358
  231. package/dist/templates/droid/droids/trellis-check.md +0 -107
  232. package/dist/templates/droid/droids/trellis-implement.md +0 -102
  233. package/dist/templates/droid/droids/trellis-research.md +0 -137
  234. package/dist/templates/droid/index.d.ts +0 -15
  235. package/dist/templates/droid/index.d.ts.map +0 -1
  236. package/dist/templates/droid/index.js +0 -15
  237. package/dist/templates/droid/index.js.map +0 -1
  238. package/dist/templates/droid/settings.json +0 -70
  239. package/dist/templates/gemini/agents/trellis-check.md +0 -107
  240. package/dist/templates/gemini/agents/trellis-implement.md +0 -102
  241. package/dist/templates/gemini/agents/trellis-research.md +0 -136
  242. package/dist/templates/gemini/index.d.ts +0 -13
  243. package/dist/templates/gemini/index.d.ts.map +0 -1
  244. package/dist/templates/gemini/index.js +0 -13
  245. package/dist/templates/gemini/index.js.map +0 -1
  246. package/dist/templates/gemini/settings.json +0 -28
  247. package/dist/templates/kiro/agents/trellis-check.json +0 -26
  248. package/dist/templates/kiro/agents/trellis-implement.json +0 -26
  249. package/dist/templates/kiro/agents/trellis-research.json +0 -30
  250. package/dist/templates/kiro/index.d.ts +0 -18
  251. package/dist/templates/kiro/index.d.ts.map +0 -1
  252. package/dist/templates/kiro/index.js +0 -18
  253. package/dist/templates/kiro/index.js.map +0 -1
  254. package/dist/templates/opencode/agents/trellis-check.md +0 -122
  255. package/dist/templates/opencode/agents/trellis-implement.md +0 -118
  256. package/dist/templates/opencode/agents/trellis-research.md +0 -145
  257. package/dist/templates/opencode/lib/session-utils.js +0 -667
  258. package/dist/templates/opencode/lib/trellis-context.js +0 -336
  259. package/dist/templates/opencode/package.json +0 -5
  260. package/dist/templates/opencode/plugins/inject-subagent-context.js +0 -495
  261. package/dist/templates/opencode/plugins/inject-workflow-state.js +0 -159
  262. package/dist/templates/opencode/plugins/session-start.js +0 -101
  263. package/dist/templates/pi/agents/trellis-check.md +0 -37
  264. package/dist/templates/pi/agents/trellis-implement.md +0 -42
  265. package/dist/templates/pi/agents/trellis-research.md +0 -25
  266. package/dist/templates/pi/extensions/trellis/index.ts.txt +0 -1600
  267. package/dist/templates/pi/index.d.ts +0 -5
  268. package/dist/templates/pi/index.d.ts.map +0 -1
  269. package/dist/templates/pi/index.js +0 -12
  270. package/dist/templates/pi/index.js.map +0 -1
  271. package/dist/templates/pi/settings.json +0 -12
  272. package/dist/templates/qoder/agents/trellis-check.md +0 -108
  273. package/dist/templates/qoder/agents/trellis-implement.md +0 -103
  274. package/dist/templates/qoder/agents/trellis-research.md +0 -137
  275. package/dist/templates/qoder/index.d.ts +0 -15
  276. package/dist/templates/qoder/index.d.ts.map +0 -1
  277. package/dist/templates/qoder/index.js +0 -15
  278. package/dist/templates/qoder/index.js.map +0 -1
  279. package/dist/templates/qoder/settings.json +0 -47
@@ -1,5 +0,0 @@
1
- import { type AgentTemplate, type HookTemplate } from "../template-utils.js";
2
- export declare function getAllAgents(): AgentTemplate[];
3
- export declare function getSettingsTemplate(): HookTemplate;
4
- export declare function getExtensionTemplate(): string;
5
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/pi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAM9B,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAE9C;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}
@@ -1,12 +0,0 @@
1
- import { createTemplateReader, } from "../template-utils.js";
2
- const { listMdAgents, getSettings, readTemplate } = createTemplateReader(import.meta.url);
3
- export function getAllAgents() {
4
- return listMdAgents();
5
- }
6
- export function getSettingsTemplate() {
7
- return getSettings();
8
- }
9
- export function getExtensionTemplate() {
10
- return readTemplate("extensions/trellis/index.ts.txt");
11
- }
12
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/pi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,oBAAoB,CACtE,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAC,iCAAiC,CAAC,CAAC;AACzD,CAAC"}
@@ -1,12 +0,0 @@
1
- {
2
- "enableSkillCommands": true,
3
- "extensions": [
4
- "./extensions/trellis/index.ts"
5
- ],
6
- "skills": [
7
- "./skills"
8
- ],
9
- "prompts": [
10
- "./prompts"
11
- ]
12
- }
@@ -1,108 +0,0 @@
1
- ---
2
- name: trellis-check
3
- description: |
4
- Code quality check expert. Reviews code changes against specs and self-fixes issues.
5
- tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
6
- ---
7
- # Check Agent
8
-
9
- You are the Check Agent in the Trellis workflow.
10
-
11
- ## Recursion Guard
12
-
13
- You are already the `trellis-check` sub-agent that the main session dispatched. Do the review and fixes directly.
14
-
15
- - Do NOT spawn another `trellis-check` or `trellis-implement` sub-agent.
16
- - If SessionStart context, workflow-state breadcrumbs, or workflow.md say to dispatch `trellis-implement` / `trellis-check`, treat that as a main-session instruction that is already satisfied by your current role.
17
- - Only the main session may dispatch Trellis implement/check agents. If more implementation work is needed, report that recommendation instead of spawning.
18
-
19
- ## Context
20
-
21
- Before checking, read:
22
- - `.trellis/spec/` - Development guidelines
23
- - Task `prd.md` - Requirements document
24
- - Task `design.md` - Technical design (if exists)
25
- - Task `implement.md` - Execution plan (if exists)
26
- - Pre-commit checklist for quality standards
27
-
28
- ## Core Responsibilities
29
-
30
- 1. **Get code changes** - Use git diff to get uncommitted code
31
- 2. **Review task artifacts** - Check changes against prd.md, design.md if present, and implement.md if present
32
- 3. **Check against specs** - Verify code follows guidelines
33
- 4. **Self-fix** - Fix issues yourself, not just report them
34
- 5. **Run verification** - typecheck and lint
35
-
36
- ## Important
37
-
38
- **Fix issues yourself**, don't just report them.
39
-
40
- You have write and edit tools, you can modify code directly.
41
-
42
- ---
43
-
44
- ## Workflow
45
-
46
- ### Step 1: Get Changes
47
-
48
- ```bash
49
- git diff --name-only # List changed files
50
- git diff # View specific changes
51
- ```
52
-
53
- ### Step 2: Check Against Specs and Task Artifacts
54
-
55
- Read the task's prd.md, design.md if present, and implement.md if present, then read relevant specs in `.trellis/spec/` to check code:
56
-
57
- - Does it satisfy the task requirements
58
- - Does it follow the technical design and implementation plan when present
59
- - Does it follow directory structure conventions
60
- - Does it follow naming conventions
61
- - Does it follow code patterns
62
- - Are there missing types
63
- - Are there potential bugs
64
-
65
- ### Step 3: Self-Fix
66
-
67
- After finding issues:
68
-
69
- 1. Fix the issue directly (use edit tool)
70
- 2. Record what was fixed
71
- 3. Continue checking other issues
72
-
73
- ### Step 4: Run Verification
74
-
75
- Run project's lint and typecheck commands to verify changes.
76
-
77
- If failed, fix issues and re-run.
78
-
79
- ---
80
-
81
- ## Report Format
82
-
83
- ```markdown
84
- ## Self-Check Complete
85
-
86
- ### Files Checked
87
-
88
- - src/components/Feature.tsx
89
- - src/hooks/useFeature.ts
90
-
91
- ### Issues Found and Fixed
92
-
93
- 1. `<file>:<line>` - <what was fixed>
94
- 2. `<file>:<line>` - <what was fixed>
95
-
96
- ### Issues Not Fixed
97
-
98
- (If there are issues that cannot be self-fixed, list them here with reasons)
99
-
100
- ### Verification Results
101
-
102
- - TypeCheck: Passed
103
- - Lint: Passed
104
-
105
- ### Summary
106
-
107
- Checked X files, found Y issues, all fixed.
108
- ```
@@ -1,103 +0,0 @@
1
- ---
2
- name: trellis-implement
3
- description: |
4
- Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
5
- tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
6
- ---
7
- # Implement Agent
8
-
9
- You are the Implement Agent in the Trellis workflow.
10
-
11
- ## Recursion Guard
12
-
13
- You are already the `trellis-implement` sub-agent that the main session dispatched. Do the implementation work directly.
14
-
15
- - Do NOT spawn another `trellis-implement` or `trellis-check` sub-agent.
16
- - If SessionStart context, workflow-state breadcrumbs, or workflow.md say to dispatch `trellis-implement` / `trellis-check`, treat that as a main-session instruction that is already satisfied by your current role.
17
- - Only the main session may dispatch Trellis implement/check agents. If more parallel work is needed, report that recommendation instead of spawning.
18
-
19
- ## Context
20
-
21
- Before implementing, read:
22
- - `.trellis/workflow.md` - Project workflow
23
- - `.trellis/spec/` - Development guidelines
24
- - Task `prd.md` - Requirements document
25
- - Task `design.md` - Technical design (if exists)
26
- - Task `implement.md` - Execution plan (if exists)
27
-
28
- ## Core Responsibilities
29
-
30
- 1. **Understand specs** - Read relevant spec files in `.trellis/spec/`
31
- 2. **Understand task artifacts** - Read prd.md, design.md if present, and implement.md if present
32
- 3. **Implement features** - Write code following specs and task artifacts
33
- 4. **Self-check** - Ensure code quality
34
- 5. **Report results** - Report completion status
35
-
36
- ## Forbidden Operations
37
-
38
- **Do NOT execute these git commands:**
39
-
40
- - `git commit`
41
- - `git push`
42
- - `git merge`
43
-
44
- ---
45
-
46
- ## Workflow
47
-
48
- ### 1. Understand Specs
49
-
50
- Read relevant specs based on task type:
51
-
52
- - Spec layers: `.trellis/spec/<package>/<layer>/`
53
- - Shared guides: `.trellis/spec/guides/`
54
-
55
- ### 2. Understand Requirements
56
-
57
- Read the task's prd.md, design.md if present, and implement.md if present:
58
-
59
- - What are the core requirements
60
- - Key points of technical design
61
- - Implementation order, validation commands, and rollback points
62
-
63
- ### 3. Implement Features
64
-
65
- - Write code following specs and task artifacts
66
- - Follow existing code patterns
67
- - Only do what's required, no over-engineering
68
-
69
- ### 4. Verify
70
-
71
- Run project's lint and typecheck commands to verify changes.
72
-
73
- ---
74
-
75
- ## Report Format
76
-
77
- ```markdown
78
- ## Implementation Complete
79
-
80
- ### Files Modified
81
-
82
- - `src/components/Feature.tsx` - New component
83
- - `src/hooks/useFeature.ts` - New hook
84
-
85
- ### Implementation Summary
86
-
87
- 1. Created Feature component...
88
- 2. Added useFeature hook...
89
-
90
- ### Verification Results
91
-
92
- - Lint: Passed
93
- - TypeCheck: Passed
94
- ```
95
-
96
- ---
97
-
98
- ## Code Standards
99
-
100
- - Follow existing code patterns
101
- - Don't add unnecessary abstractions
102
- - Only do what's required, no over-engineering
103
- - Keep code readable
@@ -1,137 +0,0 @@
1
- ---
2
- name: trellis-research
3
- description: |
4
- Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
5
- tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
6
- ---
7
- # Research Agent
8
-
9
- You are the Research Agent in the Trellis workflow.
10
-
11
- ## Core Principle
12
-
13
- **You do one thing: find, explain, and PERSIST information.**
14
-
15
- Conversations get compacted; files don't. Every research output MUST end up as a file under `{TASK_DIR}/research/`. Returning findings only through the chat reply is a failure — the caller cannot read them next session.
16
-
17
- ---
18
-
19
- ## Core Responsibilities
20
-
21
- 1. **Internal Search** — locate files/components, understand code logic, discover patterns (Glob, Grep, Read)
22
- 2. **External Search** — library docs, API references, best practices (web search)
23
- 3. **Persist** — write each research topic to `{TASK_DIR}/research/<topic>.md`
24
- 4. **Report** — return file paths + one-line summaries to the main agent (not full content)
25
-
26
- ---
27
-
28
- ## Workflow
29
-
30
- ### Step 1: Resolve Current Task
31
-
32
- Run `python3 ./.trellis/scripts/task.py selected --source` -> selected task path. If no task is selected, ask the user where to write output; do NOT guess.
33
-
34
- Ensure `{TASK_DIR}/research/` exists:
35
-
36
- ```bash
37
- mkdir -p <TASK_DIR>/research
38
- ```
39
-
40
- ### Step 2: Understand Search Request
41
-
42
- Classify: internal / external / mixed. Determine scope (global / specific directory) and expected shape (file list / pattern notes / tech comparison).
43
-
44
- ### Step 3: Execute Search
45
-
46
- Run independent searches in parallel (Glob + Grep + web) for efficiency.
47
-
48
- ### Step 4: Persist Each Topic
49
-
50
- For each distinct research topic, Write a markdown file at `{TASK_DIR}/research/<topic-slug>.md`. Use the File Format below.
51
-
52
- ### Step 5: Report to Main Agent
53
-
54
- Reply with ONLY:
55
-
56
- - List of files written (paths relative to repo root)
57
- - One-line summary per file
58
- - Any critical caveats that the main agent needs to know right now
59
-
60
- Do NOT paste full research content into the reply. The files are the contract.
61
-
62
- ---
63
-
64
- ## Scope Limits (Strict)
65
-
66
- ### Write ALLOWED
67
-
68
- - `{TASK_DIR}/research/*.md` — your own output
69
- - Creating `{TASK_DIR}/research/` if it doesn't exist (via `mkdir -p`)
70
-
71
- ### Write FORBIDDEN
72
-
73
- - Code files (`src/`, `lib/`, …)
74
- - Spec files (`.trellis/spec/`) — main agent should use `update-spec` skill instead
75
- - `.trellis/scripts/`, `.trellis/workflow.md`, platform config (`.claude/`, `.cursor/`, etc.)
76
- - Other task directories
77
- - Any git operation (commit / push / branch / merge)
78
-
79
- If the user asks you to edit code, decline and suggest spawning `implement` instead.
80
-
81
- ---
82
-
83
- ## File Format
84
-
85
- Each `{TASK_DIR}/research/<topic>.md` should follow:
86
-
87
- ```markdown
88
- # Research: <topic>
89
-
90
- - **Query**: <original query>
91
- - **Scope**: <internal / external / mixed>
92
- - **Date**: <YYYY-MM-DD>
93
-
94
- ## Findings
95
-
96
- ### Files Found
97
-
98
- | File Path | Description |
99
- |---|---|
100
- | `src/services/xxx.ts` | Main implementation |
101
- | `src/types/xxx.ts` | Type definitions |
102
-
103
- ### Code Patterns
104
-
105
- <describe patterns, cite file:line>
106
-
107
- ### External References
108
-
109
- - [Library X docs](url) — <why relevant, version constraints>
110
-
111
- ### Related Specs
112
-
113
- - `.trellis/spec/xxx.md` — <description>
114
-
115
- ## Caveats / Not Found
116
-
117
- <anything incomplete or uncertain>
118
- ```
119
-
120
- ---
121
-
122
- ## Guidelines
123
-
124
- ### DO
125
-
126
- - Provide specific file paths and line numbers
127
- - Quote actual code snippets
128
- - Persist every topic to its own file
129
- - Return file paths in your reply, not the full content
130
- - Mark "not found" explicitly when searches come up empty
131
-
132
- ### DON'T
133
-
134
- - Don't write code or modify files outside `{TASK_DIR}/research/`
135
- - Don't guess uncertain info
136
- - Don't paste full research text into the reply (files are the deliverable)
137
- - Don't propose improvements or critique implementation (that's not your role)
@@ -1,15 +0,0 @@
1
- /**
2
- * Qoder templates
3
- *
4
- * These are GENERIC templates for user projects.
5
- *
6
- * Directory structure:
7
- * qoder/
8
- * ├── agents/ # Multi-agent pipeline agents
9
- * └── settings.json # Settings configuration
10
- */
11
- import { type AgentTemplate, type HookTemplate } from "../template-utils.js";
12
- export type { AgentTemplate, HookTemplate };
13
- export declare const getAllAgents: () => AgentTemplate[];
14
- export declare const getSettingsTemplate: () => HookTemplate;
15
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/qoder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAI5C,eAAO,MAAM,YAAY,QAAO,aAAa,EAAoB,CAAC;AAClE,eAAO,MAAM,mBAAmB,QAAO,YAA6B,CAAC"}
@@ -1,15 +0,0 @@
1
- /**
2
- * Qoder templates
3
- *
4
- * These are GENERIC templates for user projects.
5
- *
6
- * Directory structure:
7
- * qoder/
8
- * ├── agents/ # Multi-agent pipeline agents
9
- * └── settings.json # Settings configuration
10
- */
11
- import { createTemplateReader, } from "../template-utils.js";
12
- const { listMdAgents, getSettings } = createTemplateReader(import.meta.url);
13
- export const getAllAgents = () => listMdAgents();
14
- export const getSettingsTemplate = () => getSettings();
15
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/qoder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAoB,EAAE,CAAC,YAAY,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAiB,EAAE,CAAC,WAAW,EAAE,CAAC"}
@@ -1,47 +0,0 @@
1
- {
2
- "hooks": {
3
- "SessionStart": [
4
- {
5
- "matcher": "startup",
6
- "hooks": [
7
- {
8
- "type": "command",
9
- "command": "{{PYTHON_CMD}} .qoder/hooks/session-start.py",
10
- "timeout": 30
11
- }
12
- ]
13
- },
14
- {
15
- "matcher": "clear",
16
- "hooks": [
17
- {
18
- "type": "command",
19
- "command": "{{PYTHON_CMD}} .qoder/hooks/session-start.py",
20
- "timeout": 30
21
- }
22
- ]
23
- },
24
- {
25
- "matcher": "compact",
26
- "hooks": [
27
- {
28
- "type": "command",
29
- "command": "{{PYTHON_CMD}} .qoder/hooks/session-start.py",
30
- "timeout": 30
31
- }
32
- ]
33
- }
34
- ],
35
- "UserPromptSubmit": [
36
- {
37
- "hooks": [
38
- {
39
- "type": "command",
40
- "command": "{{PYTHON_CMD}} .qoder/hooks/inject-workflow-state.py",
41
- "timeout": 15
42
- }
43
- ]
44
- }
45
- ]
46
- }
47
- }