bobo-ai-cli 3.0.4 → 3.0.5
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/LICENSE +21 -21
- package/README.md +259 -259
- package/bundled-skills/CORE_SKILLS.txt +18 -18
- package/bundled-skills/backend-expert/SKILL.md +97 -97
- package/bundled-skills/code-review/SKILL.md +280 -280
- package/bundled-skills/code-review-expert/SKILL.md +85 -85
- package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
- package/bundled-skills/context-compressor/SKILL.md +75 -75
- package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
- package/bundled-skills/frontend-expert/SKILL.md +93 -93
- package/bundled-skills/github/SKILL.md +12 -12
- package/bundled-skills/high-agency/SKILL.md +473 -473
- package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
- package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
- package/bundled-skills/memory-manager/SKILL.md +214 -214
- package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
- package/bundled-skills/orchestrator/SKILL.md +681 -681
- package/bundled-skills/planning-with-files/SKILL.md +193 -193
- package/bundled-skills/skill-creator/SKILL.md +220 -220
- package/bundled-skills/testing-expert/SKILL.md +99 -99
- package/bundled-skills/verify/SKILL.md +15 -15
- package/dist/agent.d.ts +5 -0
- package/dist/agent.js +11 -1
- package/dist/agent.js.map +1 -1
- package/dist/agents/catalog.d.ts +47 -0
- package/dist/agents/catalog.js +63 -5
- package/dist/agents/catalog.js.map +1 -1
- package/dist/agents/router.d.ts +12 -1
- package/dist/agents/router.js +43 -3
- package/dist/agents/router.js.map +1 -1
- package/dist/agents/spawn.js +36 -18
- package/dist/agents/spawn.js.map +1 -1
- package/dist/autonomous.js +5 -5
- package/dist/cli.js +23 -21
- package/dist/cli.js.map +1 -1
- package/dist/compactor.js +39 -39
- package/dist/dream.js +29 -29
- package/dist/image-input.d.ts +44 -0
- package/dist/image-input.js +161 -0
- package/dist/image-input.js.map +1 -0
- package/dist/memory.js +13 -13
- package/dist/project.js +15 -15
- package/dist/repl.js +88 -0
- package/dist/repl.js.map +1 -1
- package/dist/skills.js +54 -54
- package/dist/sub-agents.js +65 -65
- package/dist/tools/browser.js +21 -21
- package/dist/tools/claude-code.js +10 -10
- package/dist/web.js +7 -7
- package/dist/wiki-commands.d.ts +2 -0
- package/dist/wiki-commands.js +249 -0
- package/dist/wiki-commands.js.map +1 -0
- package/dist/wiki.d.ts +90 -0
- package/dist/wiki.js +614 -0
- package/dist/wiki.js.map +1 -0
- package/knowledge/advanced-patterns.md +70 -70
- package/knowledge/agent-directives.md +74 -74
- package/knowledge/api-integration-patterns.md +102 -0
- package/knowledge/code-review-protocol.md +69 -0
- package/knowledge/dream.md +36 -36
- package/knowledge/engineering.md +52 -46
- package/knowledge/error-catalog.md +38 -33
- package/knowledge/event-driven-architecture.md +43 -0
- package/knowledge/external-alignment.md +47 -0
- package/knowledge/high-agency.md +73 -0
- package/knowledge/image-generation.md +48 -0
- package/knowledge/index.json +194 -169
- package/knowledge/llm-wiki-pattern.md +71 -0
- package/knowledge/long-task-management.md +79 -0
- package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
- package/knowledge/memory/engineering-patterns.md +134 -134
- package/knowledge/memory/feedback_root_structure.md +15 -15
- package/knowledge/memory/project-contexts.md +69 -69
- package/knowledge/memory/tools-and-services.md +85 -85
- package/knowledge/memory-management.md +72 -0
- package/knowledge/rules/advisor-strategy.md +204 -0
- package/knowledge/rules/agents.md +62 -62
- package/knowledge/rules/blocking-rules.md +323 -323
- package/knowledge/rules/cache-management.md +379 -379
- package/knowledge/rules/capability-evolution.md +132 -132
- package/knowledge/rules/coding.md +126 -126
- package/knowledge/rules/engineering-workflows.md +225 -225
- package/knowledge/rules/evomap-content-guidelines.md +354 -354
- package/knowledge/rules/evomap-guide.md +224 -224
- package/knowledge/rules/external-alignment.md +22 -0
- package/knowledge/rules/git.md +31 -31
- package/knowledge/rules/hooks.md +106 -106
- package/knowledge/rules/performance.md +101 -101
- package/knowledge/rules/remotion-auto-production.md +1120 -1120
- package/knowledge/rules/security.md +46 -46
- package/knowledge/rules/testing.md +32 -32
- package/knowledge/rules/work-mode.md +208 -208
- package/knowledge/rules.md +62 -62
- package/knowledge/self-evolution.md +78 -0
- package/knowledge/self-rationalization-guard.md +52 -0
- package/knowledge/skills/Skill_Seekers.md +1722 -1722
- package/knowledge/skills/ab-test-setup.md +557 -557
- package/knowledge/skills/agent-sdk-dev.md +238 -238
- package/knowledge/skills/agent-tools.md +136 -136
- package/knowledge/skills/analytics-tracking.md +597 -597
- package/knowledge/skills/artifacts-builder.md +89 -89
- package/knowledge/skills/asana.md +12 -12
- package/knowledge/skills/backend-expert.md +97 -97
- package/knowledge/skills/brand-voice.md +481 -481
- package/knowledge/skills/browser-use.md +419 -419
- package/knowledge/skills/cache-optimization-skill.md +179 -179
- package/knowledge/skills/canvas-design.md +147 -147
- package/knowledge/skills/citation-validator.md +203 -203
- package/knowledge/skills/clangd-lsp.md +52 -52
- package/knowledge/skills/code-review-expert.md +85 -85
- package/knowledge/skills/code-review.md +280 -280
- package/knowledge/skills/code-simplifier.md +12 -12
- package/knowledge/skills/commit-commands.md +258 -258
- package/knowledge/skills/competitor-alternatives.md +795 -795
- package/knowledge/skills/content-atomizer.md +910 -910
- package/knowledge/skills/content-research-writer.md +605 -605
- package/knowledge/skills/context-optimization-suite.md +162 -162
- package/knowledge/skills/context7.md +12 -12
- package/knowledge/skills/copy-editing.md +494 -494
- package/knowledge/skills/copywriting.md +510 -510
- package/knowledge/skills/csharp-lsp.md +40 -40
- package/knowledge/skills/decision-making-framework.md +154 -154
- package/knowledge/skills/developer-growth-analysis.md +335 -335
- package/knowledge/skills/direct-response-copy.md +2336 -2336
- package/knowledge/skills/docker-expert.md +229 -229
- package/knowledge/skills/document-skills.md +12 -12
- package/knowledge/skills/documentation-expert.md +126 -126
- package/knowledge/skills/email-sequence.md +1061 -1061
- package/knowledge/skills/email-sequences.md +910 -910
- package/knowledge/skills/example-plugin.md +72 -72
- package/knowledge/skills/explanatory-output-style.md +82 -82
- package/knowledge/skills/feature-dev.md +458 -458
- package/knowledge/skills/file-organizer.md +466 -466
- package/knowledge/skills/firebase.disabled.md +12 -12
- package/knowledge/skills/form-cro.md +488 -488
- package/knowledge/skills/free-tool-strategy.md +636 -636
- package/knowledge/skills/frontend-design-offical.md +55 -55
- package/knowledge/skills/frontend-design.md +41 -41
- package/knowledge/skills/frontend-expert.md +93 -93
- package/knowledge/skills/github.md +12 -12
- package/knowledge/skills/gitlab.md +12 -12
- package/knowledge/skills/gopls-lsp.md +32 -32
- package/knowledge/skills/got-controller.md +218 -218
- package/knowledge/skills/greptile.md +72 -72
- package/knowledge/skills/hookify.md +376 -376
- package/knowledge/skills/image-editor.md +189 -189
- package/knowledge/skills/image-enhancer.md +109 -109
- package/knowledge/skills/jdtls-lsp.md +49 -49
- package/knowledge/skills/json-canvas.md +654 -654
- package/knowledge/skills/keyword-research.md +559 -559
- package/knowledge/skills/kotlin-lsp.md +28 -28
- package/knowledge/skills/laravel-boost.md +12 -12
- package/knowledge/skills/launch-strategy.md +394 -394
- package/knowledge/skills/lead-magnet.md +393 -393
- package/knowledge/skills/learning-output-style.md +106 -106
- package/knowledge/skills/linear.md +12 -12
- package/knowledge/skills/lua-lsp.md +47 -47
- package/knowledge/skills/marketing-ideas.md +720 -720
- package/knowledge/skills/marketing-psychology.md +534 -534
- package/knowledge/skills/mcp-builder.md +369 -369
- package/knowledge/skills/meeting-insights-analyzer.md +347 -347
- package/knowledge/skills/memory-evolution-system.md +172 -172
- package/knowledge/skills/multi-lens-thinking.md +407 -407
- package/knowledge/skills/nano-banana-pro.md +116 -116
- package/knowledge/skills/newsletter.md +736 -736
- package/knowledge/skills/notebooklm.md +296 -296
- package/knowledge/skills/obsidian-bases.md +634 -634
- package/knowledge/skills/obsidian-markdown.md +651 -651
- package/knowledge/skills/onboarding-cro.md +494 -494
- package/knowledge/skills/orchestrator.md +681 -681
- package/knowledge/skills/page-cro.md +379 -379
- package/knowledge/skills/paid-ads.md +624 -624
- package/knowledge/skills/paywall-upgrade-cro.md +651 -651
- package/knowledge/skills/php-lsp.md +36 -36
- package/knowledge/skills/planning-with-files.md +193 -193
- package/knowledge/skills/playwright.md +12 -12
- package/knowledge/skills/plugin-dev.md +434 -434
- package/knowledge/skills/popup-cro.md +520 -520
- package/knowledge/skills/positioning-angles.md +330 -330
- package/knowledge/skills/pr-review-toolkit.md +359 -359
- package/knowledge/skills/pricing-strategy.md +777 -777
- package/knowledge/skills/programmatic-seo.md +714 -714
- package/knowledge/skills/pyright-lsp.md +43 -43
- package/knowledge/skills/quality-assurance-framework.md +168 -168
- package/knowledge/skills/question-refiner.md +160 -160
- package/knowledge/skills/ralph-loop.md +205 -205
- package/knowledge/skills/refactoring-expert.md +103 -103
- package/knowledge/skills/referral-program.md +668 -668
- package/knowledge/skills/research-executor.md +164 -164
- package/knowledge/skills/review-with-security.md +12 -12
- package/knowledge/skills/rust-analyzer-lsp.md +50 -50
- package/knowledge/skills/schema-markup.md +647 -647
- package/knowledge/skills/security-audit-expert.md +124 -124
- package/knowledge/skills/security-expert.md +140 -140
- package/knowledge/skills/security-guidance.md +12 -12
- package/knowledge/skills/seedance-prompt.md +139 -139
- package/knowledge/skills/self-evolution.md +1160 -1160
- package/knowledge/skills/seo-audit.md +432 -432
- package/knowledge/skills/seo-content.md +787 -787
- package/knowledge/skills/serena.md +12 -12
- package/knowledge/skills/signup-flow-cro.md +409 -409
- package/knowledge/skills/skill-creator.md +220 -220
- package/knowledge/skills/skill-manager.md +226 -226
- package/knowledge/skills/skill-share.md +98 -98
- package/knowledge/skills/slack.md +12 -12
- package/knowledge/skills/social-content.md +878 -878
- package/knowledge/skills/spec-flow-skill.md +124 -124
- package/knowledge/skills/stripe.md +12 -12
- package/knowledge/skills/supabase.md +12 -12
- package/knowledge/skills/swift-lsp.md +40 -40
- package/knowledge/skills/synthesizer.md +236 -236
- package/knowledge/skills/template-skill.md +16 -16
- package/knowledge/skills/testing-expert.md +99 -99
- package/knowledge/skills/theme-factory.md +72 -72
- package/knowledge/skills/tiktok-research.md +208 -208
- package/knowledge/skills/typescript-lsp.md +36 -36
- package/knowledge/skills/ui-ux-pro-max.md +247 -247
- package/knowledge/skills/verify.md +15 -15
- package/knowledge/skills/visual-prompt-engineer.md +102 -102
- package/knowledge/skills/webapp-testing.md +111 -111
- package/knowledge/skills/wide-research.md +191 -191
- package/knowledge/system.md +93 -93
- package/knowledge/task-router.md +46 -37
- package/knowledge/verification.md +38 -38
- package/knowledge/worker-prompt-craft.md +66 -0
- package/knowledge/workflows/3d-viz.md +47 -47
- package/knowledge/workflows/data-pipeline.md +47 -47
- package/knowledge/workflows/db-migration.md +51 -51
- package/knowledge/workflows/feature-dev.md +41 -41
- package/knowledge/workflows/tdd-flow.md +52 -52
- package/knowledge/workflows/ui-verify.md +51 -51
- package/package.json +74 -74
- package/dist/claude-bridge.d.ts +0 -18
- package/dist/claude-bridge.js +0 -91
- package/dist/claude-bridge.js.map +0 -1
- package/dist/tools/claude-bridge-tool.d.ts +0 -4
- package/dist/tools/claude-bridge-tool.js +0 -44
- package/dist/tools/claude-bridge-tool.js.map +0 -1
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "csharp-lsp"
|
|
3
|
-
title: "csharp-lsp"
|
|
4
|
-
category: "other"
|
|
5
|
-
tags: ["csharp-lsp", "supported extensions", "installation", "requirements", "more information"]
|
|
6
|
-
triggers: []
|
|
7
|
-
dependencies: []
|
|
8
|
-
source: "E:/Bobo's Coding cache/.claude/skills/csharp-lsp"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# csharp-lsp
|
|
12
|
-
|
|
13
|
-
C# language server for Claude Code, providing code intelligence and diagnostics.
|
|
14
|
-
|
|
15
|
-
## Supported Extensions
|
|
16
|
-
|
|
17
|
-
`.cs`
|
|
18
|
-
|
|
19
|
-
## Installation
|
|
20
|
-
|
|
21
|
-
### Via .NET tool (recommended)
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
dotnet tool install --global csharp-ls
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
### Via Homebrew (macOS)
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
brew install csharp-ls
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## Requirements
|
|
34
|
-
|
|
35
|
-
- .NET SDK 6.0 or later
|
|
36
|
-
|
|
37
|
-
## More Information
|
|
38
|
-
|
|
39
|
-
- [csharp-ls GitHub](https://github.com/razzmatazz/csharp-language-server)
|
|
40
|
-
- [.NET SDK Download](https://dotnet.microsoft.com/download)
|
|
1
|
+
---
|
|
2
|
+
id: "csharp-lsp"
|
|
3
|
+
title: "csharp-lsp"
|
|
4
|
+
category: "other"
|
|
5
|
+
tags: ["csharp-lsp", "supported extensions", "installation", "requirements", "more information"]
|
|
6
|
+
triggers: []
|
|
7
|
+
dependencies: []
|
|
8
|
+
source: "E:/Bobo's Coding cache/.claude/skills/csharp-lsp"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# csharp-lsp
|
|
12
|
+
|
|
13
|
+
C# language server for Claude Code, providing code intelligence and diagnostics.
|
|
14
|
+
|
|
15
|
+
## Supported Extensions
|
|
16
|
+
|
|
17
|
+
`.cs`
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
### Via .NET tool (recommended)
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
dotnet tool install --global csharp-ls
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
### Via Homebrew (macOS)
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
brew install csharp-ls
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Requirements
|
|
34
|
+
|
|
35
|
+
- .NET SDK 6.0 or later
|
|
36
|
+
|
|
37
|
+
## More Information
|
|
38
|
+
|
|
39
|
+
- [csharp-ls GitHub](https://github.com/razzmatazz/csharp-language-server)
|
|
40
|
+
- [.NET SDK Download](https://dotnet.microsoft.com/download)
|
|
@@ -1,154 +1,154 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "decision-making-framework"
|
|
3
|
-
title: "Decision Making Framework"
|
|
4
|
-
category: "agent-engineering"
|
|
5
|
-
tags: ["decision making framework", "decision modes", "decision triggers", "high-agency behaviors", "structured decision template", "anti-patterns (avoid)", "integration with work mode"]
|
|
6
|
-
triggers: []
|
|
7
|
-
dependencies: []
|
|
8
|
-
source: "E:/Bobo's Coding cache/.claude/skills/decision-making-framework"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
name: decision-making-framework
|
|
13
|
-
description: Unified decision framework - combines high-agency (autonomous decisions) + structured-decision-alignment (systematic decision-making). Use when facing complex choices, architectural decisions, or conflicting requirements.
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
# Decision Making Framework
|
|
17
|
-
|
|
18
|
-
> **Merged from**: high-agency + structured-decision-alignment
|
|
19
|
-
> **Core principle**: Decide fast, decide well, decide once
|
|
20
|
-
|
|
21
|
-
## Decision Modes
|
|
22
|
-
|
|
23
|
-
### Mode 1: Autonomous (95% of decisions)
|
|
24
|
-
|
|
25
|
-
For decisions where the codebase, conventions, or best practices provide clear guidance:
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
1. Check existing patterns in codebase
|
|
29
|
-
2. Apply the most common convention
|
|
30
|
-
3. Execute without asking
|
|
31
|
-
4. Document the choice in commit message
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**Examples**: File naming, code style, dependency versions, UI details, test strategy
|
|
35
|
-
|
|
36
|
-
### Mode 2: Structured (4% of decisions)
|
|
37
|
-
|
|
38
|
-
For decisions with multiple valid approaches:
|
|
39
|
-
|
|
40
|
-
```
|
|
41
|
-
1. State the decision clearly
|
|
42
|
-
2. List top 2-3 options with trade-offs
|
|
43
|
-
3. Apply scoring matrix
|
|
44
|
-
4. Choose highest-scoring option
|
|
45
|
-
5. Document reasoning
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
**Scoring Matrix**:
|
|
49
|
-
| Criterion | Weight |
|
|
50
|
-
|-----------|--------|
|
|
51
|
-
| Maintains existing patterns | 3x |
|
|
52
|
-
| Simpler implementation | 2x |
|
|
53
|
-
| Better performance | 2x |
|
|
54
|
-
| Easier to test | 1x |
|
|
55
|
-
| More flexible | 1x |
|
|
56
|
-
|
|
57
|
-
### Mode 3: Blocking (1% of decisions)
|
|
58
|
-
|
|
59
|
-
Only 4 situations require user input:
|
|
60
|
-
1. **Missing credentials** — API keys, passwords, private keys
|
|
61
|
-
2. **Opposing approaches** — REST vs GraphQL, SQL vs NoSQL
|
|
62
|
-
3. **Contradictory requirements** — "Fast but perfect"
|
|
63
|
-
4. **Irreversible risk** — Delete production data, force push
|
|
64
|
-
|
|
65
|
-
---
|
|
66
|
-
|
|
67
|
-
## Decision Triggers
|
|
68
|
-
|
|
69
|
-
| Signal | Mode | Action |
|
|
70
|
-
|--------|------|--------|
|
|
71
|
-
| Codebase has existing pattern | Autonomous | Follow it |
|
|
72
|
-
| Best practice is clear | Autonomous | Apply it |
|
|
73
|
-
| Language convention exists | Autonomous | Use it |
|
|
74
|
-
| 2+ equally valid approaches | Structured | Score and choose |
|
|
75
|
-
| Requirements contradict | Blocking | Ask user |
|
|
76
|
-
| Risk is irreversible | Blocking | Confirm with user |
|
|
77
|
-
|
|
78
|
-
---
|
|
79
|
-
|
|
80
|
-
## High-Agency Behaviors
|
|
81
|
-
|
|
82
|
-
### Do Immediately (No Permission Needed)
|
|
83
|
-
- Create files following project conventions
|
|
84
|
-
- Install needed dependencies
|
|
85
|
-
- Run tests to verify changes
|
|
86
|
-
- Fix obvious bugs encountered
|
|
87
|
-
- Refactor to follow existing patterns
|
|
88
|
-
|
|
89
|
-
### Do After Documenting Intent
|
|
90
|
-
- Architecture changes (document in commit)
|
|
91
|
-
- New feature additions (document in plan)
|
|
92
|
-
- Performance optimizations (document why)
|
|
93
|
-
|
|
94
|
-
### Never Do Without Explicit Permission
|
|
95
|
-
- Delete production data
|
|
96
|
-
- Force push to shared branches
|
|
97
|
-
- Modify CI/CD pipelines
|
|
98
|
-
- Send messages to external services
|
|
99
|
-
- Upload sensitive content
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## Structured Decision Template
|
|
104
|
-
|
|
105
|
-
When facing a non-trivial decision:
|
|
106
|
-
|
|
107
|
-
```markdown
|
|
108
|
-
## Decision: [What needs to be decided]
|
|
109
|
-
|
|
110
|
-
### Context
|
|
111
|
-
[Why this decision is needed]
|
|
112
|
-
|
|
113
|
-
### Options Considered
|
|
114
|
-
1. **Option A**: [Description]
|
|
115
|
-
- Pros: [...]
|
|
116
|
-
- Cons: [...]
|
|
117
|
-
- Score: [X/10]
|
|
118
|
-
|
|
119
|
-
2. **Option B**: [Description]
|
|
120
|
-
- Pros: [...]
|
|
121
|
-
- Cons: [...]
|
|
122
|
-
- Score: [X/10]
|
|
123
|
-
|
|
124
|
-
### Decision
|
|
125
|
-
**Chosen**: Option [X]
|
|
126
|
-
**Reason**: [Why]
|
|
127
|
-
**Trade-off**: [What we give up]
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
---
|
|
131
|
-
|
|
132
|
-
## Anti-Patterns (Avoid)
|
|
133
|
-
|
|
134
|
-
1. **Analysis Paralysis** — Spending more time deciding than doing
|
|
135
|
-
2. **Premature Abstraction** — Designing for hypothetical futures
|
|
136
|
-
3. **Bikeshedding** — Debating trivial details
|
|
137
|
-
4. **Decision Reversal** — Reopening closed decisions without new information
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## Integration with Work Mode
|
|
142
|
-
|
|
143
|
-
```
|
|
144
|
-
Receive task
|
|
145
|
-
↓
|
|
146
|
-
Quick plan → TodoList
|
|
147
|
-
↓
|
|
148
|
-
For each step:
|
|
149
|
-
├─ Can decide autonomously? → Execute
|
|
150
|
-
├─ Need structured analysis? → Score and choose
|
|
151
|
-
└─ Hit blocking condition? → Ask user (4 types only)
|
|
152
|
-
↓
|
|
153
|
-
Complete and verify
|
|
154
|
-
```
|
|
1
|
+
---
|
|
2
|
+
id: "decision-making-framework"
|
|
3
|
+
title: "Decision Making Framework"
|
|
4
|
+
category: "agent-engineering"
|
|
5
|
+
tags: ["decision making framework", "decision modes", "decision triggers", "high-agency behaviors", "structured decision template", "anti-patterns (avoid)", "integration with work mode"]
|
|
6
|
+
triggers: []
|
|
7
|
+
dependencies: []
|
|
8
|
+
source: "E:/Bobo's Coding cache/.claude/skills/decision-making-framework"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
name: decision-making-framework
|
|
13
|
+
description: Unified decision framework - combines high-agency (autonomous decisions) + structured-decision-alignment (systematic decision-making). Use when facing complex choices, architectural decisions, or conflicting requirements.
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# Decision Making Framework
|
|
17
|
+
|
|
18
|
+
> **Merged from**: high-agency + structured-decision-alignment
|
|
19
|
+
> **Core principle**: Decide fast, decide well, decide once
|
|
20
|
+
|
|
21
|
+
## Decision Modes
|
|
22
|
+
|
|
23
|
+
### Mode 1: Autonomous (95% of decisions)
|
|
24
|
+
|
|
25
|
+
For decisions where the codebase, conventions, or best practices provide clear guidance:
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
1. Check existing patterns in codebase
|
|
29
|
+
2. Apply the most common convention
|
|
30
|
+
3. Execute without asking
|
|
31
|
+
4. Document the choice in commit message
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**Examples**: File naming, code style, dependency versions, UI details, test strategy
|
|
35
|
+
|
|
36
|
+
### Mode 2: Structured (4% of decisions)
|
|
37
|
+
|
|
38
|
+
For decisions with multiple valid approaches:
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
1. State the decision clearly
|
|
42
|
+
2. List top 2-3 options with trade-offs
|
|
43
|
+
3. Apply scoring matrix
|
|
44
|
+
4. Choose highest-scoring option
|
|
45
|
+
5. Document reasoning
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**Scoring Matrix**:
|
|
49
|
+
| Criterion | Weight |
|
|
50
|
+
|-----------|--------|
|
|
51
|
+
| Maintains existing patterns | 3x |
|
|
52
|
+
| Simpler implementation | 2x |
|
|
53
|
+
| Better performance | 2x |
|
|
54
|
+
| Easier to test | 1x |
|
|
55
|
+
| More flexible | 1x |
|
|
56
|
+
|
|
57
|
+
### Mode 3: Blocking (1% of decisions)
|
|
58
|
+
|
|
59
|
+
Only 4 situations require user input:
|
|
60
|
+
1. **Missing credentials** — API keys, passwords, private keys
|
|
61
|
+
2. **Opposing approaches** — REST vs GraphQL, SQL vs NoSQL
|
|
62
|
+
3. **Contradictory requirements** — "Fast but perfect"
|
|
63
|
+
4. **Irreversible risk** — Delete production data, force push
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Decision Triggers
|
|
68
|
+
|
|
69
|
+
| Signal | Mode | Action |
|
|
70
|
+
|--------|------|--------|
|
|
71
|
+
| Codebase has existing pattern | Autonomous | Follow it |
|
|
72
|
+
| Best practice is clear | Autonomous | Apply it |
|
|
73
|
+
| Language convention exists | Autonomous | Use it |
|
|
74
|
+
| 2+ equally valid approaches | Structured | Score and choose |
|
|
75
|
+
| Requirements contradict | Blocking | Ask user |
|
|
76
|
+
| Risk is irreversible | Blocking | Confirm with user |
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## High-Agency Behaviors
|
|
81
|
+
|
|
82
|
+
### Do Immediately (No Permission Needed)
|
|
83
|
+
- Create files following project conventions
|
|
84
|
+
- Install needed dependencies
|
|
85
|
+
- Run tests to verify changes
|
|
86
|
+
- Fix obvious bugs encountered
|
|
87
|
+
- Refactor to follow existing patterns
|
|
88
|
+
|
|
89
|
+
### Do After Documenting Intent
|
|
90
|
+
- Architecture changes (document in commit)
|
|
91
|
+
- New feature additions (document in plan)
|
|
92
|
+
- Performance optimizations (document why)
|
|
93
|
+
|
|
94
|
+
### Never Do Without Explicit Permission
|
|
95
|
+
- Delete production data
|
|
96
|
+
- Force push to shared branches
|
|
97
|
+
- Modify CI/CD pipelines
|
|
98
|
+
- Send messages to external services
|
|
99
|
+
- Upload sensitive content
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Structured Decision Template
|
|
104
|
+
|
|
105
|
+
When facing a non-trivial decision:
|
|
106
|
+
|
|
107
|
+
```markdown
|
|
108
|
+
## Decision: [What needs to be decided]
|
|
109
|
+
|
|
110
|
+
### Context
|
|
111
|
+
[Why this decision is needed]
|
|
112
|
+
|
|
113
|
+
### Options Considered
|
|
114
|
+
1. **Option A**: [Description]
|
|
115
|
+
- Pros: [...]
|
|
116
|
+
- Cons: [...]
|
|
117
|
+
- Score: [X/10]
|
|
118
|
+
|
|
119
|
+
2. **Option B**: [Description]
|
|
120
|
+
- Pros: [...]
|
|
121
|
+
- Cons: [...]
|
|
122
|
+
- Score: [X/10]
|
|
123
|
+
|
|
124
|
+
### Decision
|
|
125
|
+
**Chosen**: Option [X]
|
|
126
|
+
**Reason**: [Why]
|
|
127
|
+
**Trade-off**: [What we give up]
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Anti-Patterns (Avoid)
|
|
133
|
+
|
|
134
|
+
1. **Analysis Paralysis** — Spending more time deciding than doing
|
|
135
|
+
2. **Premature Abstraction** — Designing for hypothetical futures
|
|
136
|
+
3. **Bikeshedding** — Debating trivial details
|
|
137
|
+
4. **Decision Reversal** — Reopening closed decisions without new information
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## Integration with Work Mode
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
Receive task
|
|
145
|
+
↓
|
|
146
|
+
Quick plan → TodoList
|
|
147
|
+
↓
|
|
148
|
+
For each step:
|
|
149
|
+
├─ Can decide autonomously? → Execute
|
|
150
|
+
├─ Need structured analysis? → Score and choose
|
|
151
|
+
└─ Hit blocking condition? → Ask user (4 types only)
|
|
152
|
+
↓
|
|
153
|
+
Complete and verify
|
|
154
|
+
```
|