self-evolve-framework 1.1.0 → 1.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 (121) hide show
  1. package/package.json +1 -1
  2. package/template/rules/CodeGraph.mdc +0 -23
  3. package/template/rules/Svelte_5.mdc +0 -167
  4. package/template/rules/Svelte_Flow.mdc +0 -176
  5. package/template/rules/Tailwind_CSS_v4.mdc +0 -187
  6. package/template/rules/Tauri.mdc +0 -145
  7. package/template/rules/app-error-pattern.mdc +0 -65
  8. package/template/rules/invoke-safe-pattern.mdc +0 -53
  9. package/template/rules/js.mdc +0 -10
  10. package/template/rules/powershell.mdc +0 -9
  11. package/template/rules//346/227/245/345/277/227.mdc +0 -15
  12. package/template/rules//350/257/267/346/261/202.mdc +0 -49
  13. package/template/skills/caveman/SKILL.md +0 -49
  14. package/template/skills/check/SKILL.md +0 -393
  15. package/template/skills/check/agents/reviewer-architecture.md +0 -39
  16. package/template/skills/check/agents/reviewer-security.md +0 -39
  17. package/template/skills/check/references/persona-catalog.md +0 -56
  18. package/template/skills/check/references/project-context.md +0 -120
  19. package/template/skills/check/references/public-reply.md +0 -14
  20. package/template/skills/check/scripts/audit_signals.py +0 -666
  21. package/template/skills/check/scripts/run-tests.sh +0 -19
  22. package/template/skills/design/SKILL.md +0 -173
  23. package/template/skills/design/references/design-aesthetic-quality.md +0 -67
  24. package/template/skills/design/references/design-data-viz.md +0 -34
  25. package/template/skills/design/references/design-reference.md +0 -295
  26. package/template/skills/design/references/design-tokens.md +0 -45
  27. package/template/skills/design/references/design-traps.md +0 -43
  28. package/template/skills/design-an-interface/SKILL.md +0 -94
  29. package/template/skills/diagnose/SKILL.md +0 -117
  30. package/template/skills/diagnose/scripts/hitl-loop.template.sh +0 -41
  31. package/template/skills/edit-article/SKILL.md +0 -14
  32. package/template/skills/git-guardrails-claude-code/SKILL.md +0 -95
  33. package/template/skills/git-guardrails-claude-code/scripts/block-dangerous-git.sh +0 -25
  34. package/template/skills/grill-me/SKILL.md +0 -10
  35. package/template/skills/grill-with-docs/ADR-FORMAT.md +0 -47
  36. package/template/skills/grill-with-docs/CONTEXT-FORMAT.md +0 -60
  37. package/template/skills/grill-with-docs/SKILL.md +0 -88
  38. package/template/skills/handoff/SKILL.md +0 -15
  39. package/template/skills/health/SKILL.md +0 -260
  40. package/template/skills/health/agents/inspector-context.md +0 -119
  41. package/template/skills/health/agents/inspector-control.md +0 -84
  42. package/template/skills/health/agents/inspector-maintainability.md +0 -55
  43. package/template/skills/health/scripts/check-agent-context.sh +0 -5
  44. package/template/skills/health/scripts/check-doc-refs.sh +0 -8
  45. package/template/skills/health/scripts/check-maintainability.sh +0 -8
  46. package/template/skills/health/scripts/check-verifier-output.sh +0 -5
  47. package/template/skills/health/scripts/check_agent_context.py +0 -444
  48. package/template/skills/health/scripts/check_doc_refs.py +0 -110
  49. package/template/skills/health/scripts/check_maintainability.py +0 -635
  50. package/template/skills/health/scripts/check_verifier_output.py +0 -116
  51. package/template/skills/health/scripts/collect-data.sh +0 -751
  52. package/template/skills/hunt/SKILL.md +0 -232
  53. package/template/skills/hunt/references/failure-patterns.md +0 -138
  54. package/template/skills/hunt/references/ime-unicode.md +0 -58
  55. package/template/skills/hunt/references/logging-techniques.md +0 -72
  56. package/template/skills/hunt/references/rendering-debug.md +0 -34
  57. package/template/skills/improve-codebase-architecture/DEEPENING.md +0 -37
  58. package/template/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  59. package/template/skills/improve-codebase-architecture/INTERFACE-DESIGN.md +0 -44
  60. package/template/skills/improve-codebase-architecture/LANGUAGE.md +0 -53
  61. package/template/skills/improve-codebase-architecture/SKILL.md +0 -81
  62. package/template/skills/learn/SKILL.md +0 -140
  63. package/template/skills/migrate-to-shoehorn/SKILL.md +0 -118
  64. package/template/skills/obsidian-vault/SKILL.md +0 -59
  65. package/template/skills/prototype/LOGIC.md +0 -79
  66. package/template/skills/prototype/SKILL.md +0 -30
  67. package/template/skills/prototype/UI.md +0 -112
  68. package/template/skills/qa/SKILL.md +0 -130
  69. package/template/skills/read/SKILL.md +0 -141
  70. package/template/skills/read/references/read-methods.md +0 -129
  71. package/template/skills/read/scripts/fetch.sh +0 -106
  72. package/template/skills/read/scripts/fetch_feishu.py +0 -251
  73. package/template/skills/read/scripts/fetch_local.py +0 -218
  74. package/template/skills/read/scripts/fetch_weixin.py +0 -107
  75. package/template/skills/request-refactor-plan/SKILL.md +0 -68
  76. package/template/skills/review/SKILL.md +0 -78
  77. package/template/skills/rust-auto-fix/SKILL.md +0 -94
  78. package/template/skills/scaffold-exercises/SKILL.md +0 -106
  79. package/template/skills/sdd-dev/SKILL.md +0 -114
  80. package/template/skills/setup-matt-pocock-skills/SKILL.md +0 -121
  81. package/template/skills/setup-matt-pocock-skills/domain.md +0 -51
  82. package/template/skills/setup-matt-pocock-skills/issue-tracker-github.md +0 -22
  83. package/template/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md +0 -23
  84. package/template/skills/setup-matt-pocock-skills/issue-tracker-local.md +0 -19
  85. package/template/skills/setup-matt-pocock-skills/triage-labels.md +0 -15
  86. package/template/skills/setup-pre-commit/SKILL.md +0 -91
  87. package/template/skills/svelte-warnings-fix/SKILL.md +0 -94
  88. package/template/skills/tauri-nsis-installer-icon/SKILL.md +0 -92
  89. package/template/skills/tauri-nsis-installer-icon/references/tauri-nsis-schema.md +0 -71
  90. package/template/skills/tb/SKILL.md +0 -62
  91. package/template/skills/tdd/SKILL.md +0 -109
  92. package/template/skills/tdd/deep-modules.md +0 -33
  93. package/template/skills/tdd/interface-design.md +0 -31
  94. package/template/skills/tdd/mocking.md +0 -59
  95. package/template/skills/tdd/refactoring.md +0 -10
  96. package/template/skills/tdd/tests.md +0 -61
  97. package/template/skills/teach/GLOSSARY-FORMAT.md +0 -35
  98. package/template/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  99. package/template/skills/teach/MISSION-FORMAT.md +0 -31
  100. package/template/skills/teach/RESOURCES-FORMAT.md +0 -32
  101. package/template/skills/teach/SKILL.md +0 -91
  102. package/template/skills/think/SKILL.md +0 -184
  103. package/template/skills/to-issues/SKILL.md +0 -83
  104. package/template/skills/to-prd/SKILL.md +0 -74
  105. package/template/skills/triage/AGENT-BRIEF.md +0 -168
  106. package/template/skills/triage/OUT-OF-SCOPE.md +0 -101
  107. package/template/skills/triage/SKILL.md +0 -103
  108. package/template/skills/ubiquitous-language/SKILL.md +0 -93
  109. package/template/skills/ver/SKILL.md +0 -62
  110. package/template/skills/write/SKILL.md +0 -209
  111. package/template/skills/write/references/write-en.md +0 -199
  112. package/template/skills/write/references/write-product-localization.md +0 -43
  113. package/template/skills/write/references/write-zh-bilingual.md +0 -59
  114. package/template/skills/write/references/write-zh-prose.md +0 -50
  115. package/template/skills/write/references/write-zh-release-notes.md +0 -40
  116. package/template/skills/write/references/write-zh.md +0 -721
  117. package/template/skills/write-a-skill/SKILL.md +0 -117
  118. package/template/skills/writing-beats/SKILL.md +0 -52
  119. package/template/skills/writing-fragments/SKILL.md +0 -75
  120. package/template/skills/writing-shape/SKILL.md +0 -64
  121. package/template/skills/zoom-out/SKILL.md +0 -7
@@ -1,145 +0,0 @@
1
- ---
2
- description:
3
- alwaysApply: true
4
- enabled: true
5
- updatedAt: 2026-05-13T04:29:03.207Z
6
- provider:
7
- ---
8
-
9
- Tauri 项目编码规范(严格遵循 Tauri 官方最新规范)
10
- 完全对齐 Tauri 官方文档、官方最佳实践、安全准则、架构设计与 API 约定,无自定义扩展、无野路子写法。
11
- 适用:Tauri v2 + Tauri CLI 官方标准,前端可搭配 Svelte / React / Vue / Vanilla。
12
- 一、核心架构规范(官方强制标准)
13
- Tauri 官方唯一架构:
14
- 前端层:Web 技术(HTML/JS/CSS/ 框架)
15
- 核心层:Rust 后端(src-tauri/)
16
- IPC 通信:唯一官方通信机制(禁止直接跨域 / 原生调用)
17
- 命令式 API:前端只能调用 Rust 注册的命令,不能直接操作系统
18
- 二、项目结构规范(官方固定目录结构)
19
- plaintext
20
- 你的项目/
21
- ├── src/ # 前端源码(官方标准)
22
- ├── src-tauri/ # Tauri 核心目录(官方固定名称,禁止修改)
23
- │ ├── build.rs # 官方构建脚本(禁止删除)
24
- │ ├── Cargo.toml # Rust 配置(严格遵循官方格式)
25
- │ ├── tauri.conf.json # Tauri 主配置(官方 schema 严格校验)
26
- │ └── src/
27
- │ ├── lib.rs # 官方推荐:命令与逻辑入口
28
- │ └── main.rs # 程序主入口(官方固定代码)
29
- └── package.json # 前端依赖 + Tauri 脚本
30
- 三、tauri.conf.json 规范(官方严格 Schema)
31
- 1. 必须遵守的官方字段规则
32
- json
33
- {
34
- "$schema": "./node_modules/@tauri-apps/cli/schema.json",
35
- "productName": "你的应用名",
36
- "version": "0.1.0",
37
- "identifier": "com.你的域名.应用名",
38
- "build": {
39
- "beforeDevCommand": "你的前端启动命令",
40
- "beforeBuildCommand": "你的前端构建命令",
41
- "devPath": "http://你的开发地址",
42
- "distDir": "../dist" // 前端输出目录(官方标准)
43
- },
44
- "bundle": {
45
- "active": true,
46
- "targets": "all",
47
- "icon": [
48
- "icons/32x32.png",
49
- "icons/128x128.png",
50
- "icons/256x256.png",
51
- "icons/512x512.png"
52
- ]
53
- }
54
- }
55
- 2. 官方强制规则
56
- 必须包含 $schema 用于校验
57
- identifier 必须是反向域名格式
58
- icon 必须提供多尺寸,严格按官方要求
59
- 禁止添加非官方字段
60
- 四、Rust 代码规范(官方标准)
61
- 1. main.rs(官方固定模板)
62
- rust
63
- 运行
64
- // 官方唯一标准写法,禁止修改
65
- fn main() {
66
- tauri::Builder::default()
67
- .run(tauri::generate_context!())
68
- .expect("error while running tauri application");
69
- }
70
- 2. 命令注册规范(官方唯一方式)
71
- rust
72
- 运行
73
- // lib.rs(官方推荐)
74
- use tauri::command;
75
-
76
- // 官方标准命令
77
- #[command]
78
- fn greet(name: &str) -> String {
79
- format!("Hello, {}!", name)
80
- }
81
-
82
- // 官方标准初始化
83
- #[tauri::main]
84
- fn main() {
85
- tauri::Builder::default()
86
- .invoke_handler(tauri::generate_handler![greet]) // 命令注册
87
- .run(tauri::generate_context!())
88
- .expect("error while running tauri application");
89
- }
90
- 3. Rust 调用规范
91
- 所有前端可调用功能必须用 #[command] 注册
92
- 禁止无权限、无校验的系统操作
93
- 错误处理必须使用 Result<T, E>
94
- 五、IPC / 前端调用规范(官方安全准则)
95
- 1. 前端调用 Rust 命令(官方唯一 API)
96
- javascript
97
- 运行
98
- import { invoke } from '@tauri-apps/api/core'
99
-
100
- // 官方标准调用方式
101
- const result = await invoke('greet', { name: 'Tauri' })
102
- 2. 官方安全铁律
103
- 禁止前端直接访问文件系统 / 网络 / 原生能力
104
- 所有操作必须走 Rust 命令
105
- 最小权限原则:只声明需要的权限
106
- 六、权限规范(官方 CSP + 权限白名单)
107
- 1. tauri.conf.json 权限声明
108
- json
109
- "permissions": [
110
- "path",
111
- "fs:read",
112
- "window:allow-close"
113
- ]
114
- 只添加业务需要的权限
115
- 禁止使用 * 通配符
116
- 严格遵循官方权限列表
117
- 2. CSP 内容安全策略(官方强制)
118
- json
119
- "csp": "default-src 'self'; img-src 'self' data: asset:;"
120
- 禁止 unsafe-inline、unsafe-eval
121
- 遵循最小信任原则
122
- 七、窗口管理规范(官方 API)
123
- javascript
124
- 运行
125
- import { getCurrentWindow } from '@tauri-apps/api/window'
126
-
127
- // 官方标准用法
128
- const appWindow = getCurrentWindow()
129
- await appWindow.maximize()
130
- await appWindow.setSize({ width: 800, height: 600 })
131
- 禁止直接操作 DOM window 模拟窗口
132
- 只使用官方 @tauri-apps/api/window
133
- 八、插件使用规范(官方)
134
- 只使用 @tauri-apps/plugin-* 官方插件
135
- 禁止引入第三方原生桥接库
136
- 插件必须在 tauri.conf.json 正确配置
137
- 九、开发与构建命令(官方唯一标准)
138
- bash
139
- 运行
140
- # 开发模式
141
- tauri dev
142
-
143
- # 生产构建
144
- tauri build
145
- 禁止使用自定义编译脚本绕过官方 CLI。
@@ -1,65 +0,0 @@
1
- ---
2
- description: 强制使用 AppError 统一错误类型的规则。
3
- alwaysApply: true
4
- ---
5
-
6
- # AppError Rust 错误规范
7
-
8
- > SheetFlow 项目特有规则。所有 `#[command]` 必须返回 `Result<T, AppError>`,
9
- > 使用 `src-tauri/src/error.rs` 中定义的 6 个变体。
10
-
11
- ## 强制规则
12
-
13
- ### 所有 #[command] 必须返回 Result<T, AppError>
14
-
15
- ```rust
16
- use crate::error::AppError;
17
-
18
- // ✅ 正确
19
- #[command]
20
- fn some_command(input: String) -> Result<String, AppError> {
21
- Ok(input.trim().to_string())
22
- }
23
-
24
- // ❌ 禁止 — 返回 Result<T, String>
25
- // ❌ 禁止 — 无错误处理
26
- // ❌ 禁止 — 使用 anyhow::Error
27
- ```
28
-
29
- ### AppError 的 6 个变体
30
-
31
- | 变体 | 用途 | 示例 |
32
- |------|------|------|
33
- | `AppError::FileNotFound` | 文件/路径不存在 | `AppError::FileNotFound(path)` |
34
- | `AppError::Io` | IO 错误 | `AppError::Io(e)` |
35
- | `AppError::Parse` | 解析失败(JSON/CSV) | `AppError::Parse(msg)` |
36
- | `AppError::Validation` | 参数校验失败 | `AppError::Validation(msg)` |
37
- | `AppError::Execution` | 执行时错误 | `AppError::Execution(msg)` |
38
- | `AppError::Generic` | 其他错误 | `AppError::Generic(msg)` |
39
-
40
- ```rust
41
- // ✅ 正确 — 用对应变体
42
- Err(AppError::Validation("参数不能为空".into()))
43
-
44
- // ❌ 禁止 — 全部用 Generic
45
- Err(AppError::Generic("参数不能为空".into()))
46
- ```
47
-
48
- ### 前端接收格式
49
-
50
- `AppError` 使用 `#[serde(tag = "type", content = "message")]`,前端收到:
51
-
52
- ```json
53
- { "type": "Validation", "message": "参数不能为空" }
54
- ```
55
-
56
- ## Validation 错误特殊处理
57
-
58
- Validation 类型的错误会 re-throw(不由 invokeSafe 吞掉),供调用方做表单校验反馈。
59
-
60
- ## 新增命令流程
61
-
62
- 1. 新建 `.rs` 文件 → `src-tauri/src/commands/`
63
- 2. 在 `mod.rs` 注册模块 + `lib.rs` 注册命令
64
- 3. 返回类型用 `Result<T, AppError>`
65
- 4. 错误用对应的变体,不要全部塞 Generic
@@ -1,53 +0,0 @@
1
- ---
2
- description: 强制使用 invokeSafe + INVOKE_ERROR 模式的规则。防止前端 IPC 调用错误处理不一致。
3
- alwaysApply: true
4
- ---
5
-
6
- # invokeSafe 调用规范
7
-
8
- > SheetFlow 项目特有规则。当 Rust `#[command]` 返回 `Result<T, AppError>` 时,`Ok(())` 会被序列化为 JSON `null`,
9
- > 导致 `if (!result)` 错误地认为"结果是空"。必须统一使用 `invokeSafe` + `=== INVOKE_ERROR` 判断。
10
-
11
- ## 强制规则
12
-
13
- ### 所有 IPC 调用必须使用 invokeSafe
14
-
15
- ```typescript
16
- import { invokeSafe, INVOKE_ERROR } from '$lib/utils/invokeSafe'
17
-
18
- // ✅ 正确
19
- const result = await invokeSafe('some_command', { param: value })
20
- if (result === INVOKE_ERROR) return
21
-
22
- // ❌ 禁止 — 直接 invoke
23
- const result = await invoke('some_command', { param: value })
24
-
25
- // ❌ 禁止 — 用 !result 判断错误
26
- if (!result) // Ok(()) 是 null,会被误判
27
-
28
- // ❌ 禁止 — 用 result === null 判断
29
- if (result === null) // 同上
30
- ```
31
-
32
- ### 判断错误的唯一正确方式
33
-
34
- ```typescript
35
- // ✅ 唯一正确
36
- if (result === INVOKE_ERROR) { /* 错误处理 */ }
37
-
38
- // ❌ 禁止的所有写法
39
- if (!result) // Ok(()) 是 null
40
- if (result == null) // 宽松比较也会命中 null
41
- if (result === null) // 明确 null 检查也错
42
- ```
43
-
44
- ## 例外
45
-
46
- 只有不需要返回值的纯 UI 操作(如 `appWindow.close()`)可以不经过 invokeSafe。
47
-
48
- ## 验证
49
-
50
- ```typescript
51
- // commit 前自审:搜索 invoke( 是否被直接使用
52
- // grep -n "invoke(" src/**/*.svelte src/**/*.ts | grep -v "invokeSafe"
53
- ```
@@ -1,10 +0,0 @@
1
- ---
2
- description:
3
- alwaysApply: true
4
- enabled: true
5
- updatedAt: 2026-05-10T07:40:32.184Z
6
- provider:
7
- ---
8
-
9
- 避免发生 TDZ 问题
10
- 避免发生 函数 作用域问题
@@ -1,9 +0,0 @@
1
- ---
2
- description:
3
- alwaysApply: true
4
- enabled: true
5
- updatedAt: 2026-05-09T11:25:21.078Z
6
- provider:
7
- ---
8
-
9
- 1.使用Get-Content命令时,增加-Encoding UTF8 参数
@@ -1,15 +0,0 @@
1
- ---
2
- description:
3
- alwaysApply: true
4
- enabled: true
5
- updatedAt: 2026-05-11T07:40:04.494Z
6
- provider:
7
- ---
8
-
9
- *.rs 文件日志级别使用规范:
10
- use log::{info, error, debug, warn};
11
-
12
- info!():用于记录常规的运行信息,如服务启动、命令调用开始、任务执行成功等
13
- error!():用于记录错误信息,如文件读取失败、数据解析失败、命令执行异常等
14
- debug!():用于记录调试信息,在开发阶段使用,生产环境可关闭,如参数接收、关键变量打印等
15
- warn!():用于记录警告信息,如非关键性问题、文件不存在、配置缺失等
@@ -1,49 +0,0 @@
1
- ---
2
- description:
3
- alwaysApply: true
4
- enabled: true
5
- updatedAt: 2026-05-11T07:37:36.959Z
6
- provider:
7
- ---
8
-
9
- 你是Tauri + Vue3 + TypeScript + Rust项目的专属助手,所有输出必须严格遵守以下规范:
10
-
11
- 一、项目基础架构约定
12
- - 技术栈:Tauri 2 + Vue 3 + TypeScript + Rust
13
- - 前端:Vue 3 单文件组件,统一使用 <script setup lang="ts"> 组合式API
14
- - 后端:Rust 命令,使用 #[tauri::command] 宏定义
15
- - 前后端通信:仅使用 @tauri-apps/api/core 的 invoke 方法调用,禁止使用其他API
16
-
17
- 二、前端调用格式(强制)
18
- 1. 必须从 '@tauri-apps/api/core' 导入 invoke
19
- 2. 必须使用 await 异步调用,入参统一用对象包裹
20
- 3. 必须添加 try/catch 异常捕获
21
- 4. 固定模板:
22
- import { invoke } from '@tauri-apps/api/core'
23
- try {
24
- const result = await invoke('rust_command_name', {
25
- param1: value1,
26
- param2: value2
27
- })
28
- // 成功逻辑
29
- } catch (err) {
30
- console.error('调用失败:', err)
31
- // 错误处理
32
- }
33
-
34
- 三、Rust后端命令规范(强制)
35
- 1. 必须用 #[tauri::command] 标记,函数必须 pub 公开
36
- 2. 函数参数名与前端 invoke 入参的 key 完全对应(蛇形命名)
37
- 3. 返回值统一用 Result<T, String>,成功返回 Ok(数据),失败返回 Err("错误信息")
38
- 4. 命令名与前端 invoke 第一个参数完全一致(蛇形命名)
39
- 5. 所有文件读写、系统操作、耗时逻辑必须放在 Rust 端,前端只做调用与UI渲染
40
-
41
- 四、命名与代码规范
42
- 1. 前端:变量/函数名用小驼峰 camelCase,类型/接口名用 PascalCase
43
- 2. Rust:函数/变量名用蛇形命名 snake_case,类型名用 PascalCase
44
- 3. 代码必须添加必要注释,禁止使用 any 类型
45
- 4. 生成前后端代码时,同时提供:前端调用示例 + Rust 命令实现 + main.rs 注册代码
46
-
47
- 五、输出要求
48
- - 所有生成的代码必须可直接复制运行,无需额外修改格式
49
- - 前后端参数、命名、类型必须完全对齐,避免类型错误
@@ -1,49 +0,0 @@
1
- ---
2
- name: caveman
3
- description: >
4
- Ultra-compressed communication mode. Cuts token usage ~75% by dropping
5
- filler, articles, and pleasantries while keeping full technical accuracy.
6
- Use when user says "caveman mode", "talk like caveman", "use caveman",
7
- "less tokens", "be brief", or invokes /caveman.
8
- ---
9
-
10
- Respond terse like smart caveman. All technical substance stay. Only fluff die.
11
-
12
- ## Persistence
13
-
14
- ACTIVE EVERY RESPONSE once triggered. No revert after many turns. No filler drift. Still active if unsure. Off only when user says "stop caveman" or "normal mode".
15
-
16
- ## Rules
17
-
18
- Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Abbreviate common terms (DB/auth/config/req/res/fn/impl). Strip conjunctions. Use arrows for causality (X -> Y). One word when one word enough.
19
-
20
- Technical terms stay exact. Code blocks unchanged. Errors quoted exact.
21
-
22
- Pattern: `[thing] [action] [reason]. [next step].`
23
-
24
- Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
25
- Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
26
-
27
- ### Examples
28
-
29
- **"Why React component re-render?"**
30
-
31
- > Inline obj prop -> new ref -> re-render. `useMemo`.
32
-
33
- **"Explain database connection pooling."**
34
-
35
- > Pool = reuse DB conn. Skip handshake -> fast under load.
36
-
37
- ## Auto-Clarity Exception
38
-
39
- Drop caveman temporarily for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
40
-
41
- Example -- destructive op:
42
-
43
- > **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
44
- >
45
- > ```sql
46
- > DROP TABLE users;
47
- > ```
48
- >
49
- > Caveman resume. Verify backup exist first.