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,43 +1,43 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "pyright-lsp"
|
|
3
|
-
title: "pyright-lsp"
|
|
4
|
-
category: "other"
|
|
5
|
-
tags: ["pyright-lsp", "supported extensions", "installation", "more information"]
|
|
6
|
-
triggers: []
|
|
7
|
-
dependencies: []
|
|
8
|
-
source: "E:/Bobo's Coding cache/.claude/skills/pyright-lsp"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# pyright-lsp
|
|
12
|
-
|
|
13
|
-
Python language server (Pyright) for Claude Code, providing static type checking and code intelligence.
|
|
14
|
-
|
|
15
|
-
## Supported Extensions
|
|
16
|
-
|
|
17
|
-
`.py`, `.pyi`
|
|
18
|
-
|
|
19
|
-
## Installation
|
|
20
|
-
|
|
21
|
-
Install Pyright globally via npm:
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
npm install -g pyright
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
Or with pip:
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
pip install pyright
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Or with pipx (recommended for CLI tools):
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
pipx install pyright
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
## More Information
|
|
40
|
-
|
|
41
|
-
- [Pyright on npm](https://www.npmjs.com/package/pyright)
|
|
42
|
-
- [Pyright on PyPI](https://pypi.org/project/pyright/)
|
|
43
|
-
- [GitHub Repository](https://github.com/microsoft/pyright)
|
|
1
|
+
---
|
|
2
|
+
id: "pyright-lsp"
|
|
3
|
+
title: "pyright-lsp"
|
|
4
|
+
category: "other"
|
|
5
|
+
tags: ["pyright-lsp", "supported extensions", "installation", "more information"]
|
|
6
|
+
triggers: []
|
|
7
|
+
dependencies: []
|
|
8
|
+
source: "E:/Bobo's Coding cache/.claude/skills/pyright-lsp"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# pyright-lsp
|
|
12
|
+
|
|
13
|
+
Python language server (Pyright) for Claude Code, providing static type checking and code intelligence.
|
|
14
|
+
|
|
15
|
+
## Supported Extensions
|
|
16
|
+
|
|
17
|
+
`.py`, `.pyi`
|
|
18
|
+
|
|
19
|
+
## Installation
|
|
20
|
+
|
|
21
|
+
Install Pyright globally via npm:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm install -g pyright
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Or with pip:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
pip install pyright
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Or with pipx (recommended for CLI tools):
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
pipx install pyright
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## More Information
|
|
40
|
+
|
|
41
|
+
- [Pyright on npm](https://www.npmjs.com/package/pyright)
|
|
42
|
+
- [Pyright on PyPI](https://pypi.org/project/pyright/)
|
|
43
|
+
- [GitHub Repository](https://github.com/microsoft/pyright)
|
|
@@ -1,168 +1,168 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: "quality-assurance-framework"
|
|
3
|
-
title: "Quality Assurance Framework"
|
|
4
|
-
category: "agent-engineering"
|
|
5
|
-
tags: ["quality assurance framework", "pre-commit qa", "combined qa workflow", "quick reference"]
|
|
6
|
-
triggers: []
|
|
7
|
-
dependencies: []
|
|
8
|
-
source: "E:/Bobo's Coding cache/.claude/skills/quality-assurance-framework"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
name: quality-assurance-framework
|
|
13
|
-
description: Unified QA - combines adversarial-verification (find vulnerabilities via attack) + self-rationalization-guard (prevent self-deception). Use before commits, after code changes, or when reviewing critical logic.
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
# Quality Assurance Framework
|
|
17
|
-
|
|
18
|
-
> **Merged from**: adversarial-verification + self-rationalization-guard
|
|
19
|
-
> **Core principle**: Attack first, defend assumptions, verify ruthlessly
|
|
20
|
-
|
|
21
|
-
## Module 1: Adversarial Verification
|
|
22
|
-
|
|
23
|
-
### Attack Modes
|
|
24
|
-
|
|
25
|
-
**Mode A: Input Attack** — What inputs break this?
|
|
26
|
-
```
|
|
27
|
-
- Empty input? null? undefined?
|
|
28
|
-
- Extremely large input? (1M chars)
|
|
29
|
-
- Special characters? (<script>, SQL injection, path traversal)
|
|
30
|
-
- Unicode edge cases? (RTL, zero-width, emoji)
|
|
31
|
-
- Concurrent requests?
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**Mode B: State Attack** — What states break this?
|
|
35
|
-
```
|
|
36
|
-
- Race conditions between operations
|
|
37
|
-
- State transitions out of order
|
|
38
|
-
- Partial failures (network timeout mid-write)
|
|
39
|
-
- Resource exhaustion (disk full, memory OOM)
|
|
40
|
-
- Permission escalation paths
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
**Mode C: Logic Attack** — What assumptions are wrong?
|
|
44
|
-
```
|
|
45
|
-
- "This API always returns data" → What if it returns null?
|
|
46
|
-
- "This file always exists" → What if deleted mid-operation?
|
|
47
|
-
- "This operation is atomic" → What if interrupted?
|
|
48
|
-
- "This order is guaranteed" → What if reordered?
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Verification Checklist
|
|
52
|
-
|
|
53
|
-
```markdown
|
|
54
|
-
## Pre-Commit QA
|
|
55
|
-
|
|
56
|
-
### Input Validation
|
|
57
|
-
- [ ] All user inputs validated at system boundary
|
|
58
|
-
- [ ] SQL uses parameterized queries (no string concat)
|
|
59
|
-
- [ ] HTML output sanitized (no raw user content)
|
|
60
|
-
- [ ] File paths validated (no path traversal)
|
|
61
|
-
- [ ] Rate limiting on all public endpoints
|
|
62
|
-
|
|
63
|
-
### Error Handling
|
|
64
|
-
- [ ] All async operations have try/catch
|
|
65
|
-
- [ ] Errors are thrown, not silently swallowed
|
|
66
|
-
- [ ] Error messages don't leak sensitive data
|
|
67
|
-
- [ ] Failed operations clean up resources
|
|
68
|
-
|
|
69
|
-
### State Safety
|
|
70
|
-
- [ ] No race conditions in shared state
|
|
71
|
-
- [ ] Atomic operations where needed
|
|
72
|
-
- [ ] Proper locking for concurrent access
|
|
73
|
-
- [ ] Rollback on partial failures
|
|
74
|
-
|
|
75
|
-
### Security
|
|
76
|
-
- [ ] No hardcoded secrets
|
|
77
|
-
- [ ] Authentication verified on protected routes
|
|
78
|
-
- [ ] Authorization checked at each level
|
|
79
|
-
- [ ] CSRF protection enabled
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## Module 2: Self-Rationalization Guard
|
|
85
|
-
|
|
86
|
-
### Red Flags (Self-Deception Patterns)
|
|
87
|
-
|
|
88
|
-
| Pattern | What You Tell Yourself | Reality |
|
|
89
|
-
|---------|----------------------|---------|
|
|
90
|
-
| **Hand-waving** | "This edge case won't happen" | It will, in production |
|
|
91
|
-
| **Scope creep** | "While I'm here, let me also..." | Unrelated changes introduce bugs |
|
|
92
|
-
| **Assumption skip** | "The caller will validate this" | They won't |
|
|
93
|
-
| **Optimism bias** | "This should work" | Prove it with a test |
|
|
94
|
-
| **Sunk cost** | "I've already spent time on this approach" | Switch if a better one exists |
|
|
95
|
-
| **Complexity justify** | "It needs to be this complex" | Simpler exists, find it |
|
|
96
|
-
|
|
97
|
-
### Anti-Deception Protocol
|
|
98
|
-
|
|
99
|
-
Before marking any task complete:
|
|
100
|
-
|
|
101
|
-
```
|
|
102
|
-
1. Red Team your own code
|
|
103
|
-
→ "If I wanted to break this, how would I?"
|
|
104
|
-
→ Find at least ONE potential issue
|
|
105
|
-
|
|
106
|
-
2. Challenge your assumptions
|
|
107
|
-
→ List every assumption you made
|
|
108
|
-
→ Verify each one is actually true
|
|
109
|
-
|
|
110
|
-
3. Ask "What would make this fail?"
|
|
111
|
-
→ Not "Does this work?"
|
|
112
|
-
→ But "Under what conditions does this break?"
|
|
113
|
-
|
|
114
|
-
4. Simplicity check
|
|
115
|
-
→ Could this be done with fewer abstractions?
|
|
116
|
-
→ Is every line earning its existence?
|
|
117
|
-
|
|
118
|
-
5. Test the negative path
|
|
119
|
-
→ Don't just test the happy path
|
|
120
|
-
→ Test every error/failure scenario
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
125
|
-
## Combined QA Workflow
|
|
126
|
-
|
|
127
|
-
### Before Every Commit
|
|
128
|
-
|
|
129
|
-
```
|
|
130
|
-
1. Adversarial scan (Module 1)
|
|
131
|
-
├─ Input attack: 2 min
|
|
132
|
-
├─ State attack: 2 min
|
|
133
|
-
└─ Logic attack: 2 min
|
|
134
|
-
|
|
135
|
-
2. Self-deception check (Module 2)
|
|
136
|
-
├─ Red flag scan: 1 min
|
|
137
|
-
├─ Assumption challenge: 1 min
|
|
138
|
-
└─ Simplicity check: 1 min
|
|
139
|
-
|
|
140
|
-
3. Automated verification
|
|
141
|
-
├─ Run tests: npm test
|
|
142
|
-
├─ Type check: tsc --noEmit
|
|
143
|
-
└─ Lint: eslint .
|
|
144
|
-
|
|
145
|
-
Total: ~10 minutes per commit
|
|
146
|
-
```
|
|
147
|
-
|
|
148
|
-
### Before Every PR
|
|
149
|
-
|
|
150
|
-
```
|
|
151
|
-
1. Full adversarial verification (Module 1)
|
|
152
|
-
2. Self-deception deep dive (Module 2)
|
|
153
|
-
3. Security scan (OWASP top 10)
|
|
154
|
-
4. Performance check (no regressions)
|
|
155
|
-
5. Accessibility check (if UI changes)
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
---
|
|
159
|
-
|
|
160
|
-
## Quick Reference
|
|
161
|
-
|
|
162
|
-
```markdown
|
|
163
|
-
# 3-Question QA (use for every change)
|
|
164
|
-
|
|
165
|
-
1. "How would I break this?" → Fix the break point
|
|
166
|
-
2. "What assumption am I making?" → Verify the assumption
|
|
167
|
-
3. "Could this be simpler?" → Simplify if yes
|
|
168
|
-
```
|
|
1
|
+
---
|
|
2
|
+
id: "quality-assurance-framework"
|
|
3
|
+
title: "Quality Assurance Framework"
|
|
4
|
+
category: "agent-engineering"
|
|
5
|
+
tags: ["quality assurance framework", "pre-commit qa", "combined qa workflow", "quick reference"]
|
|
6
|
+
triggers: []
|
|
7
|
+
dependencies: []
|
|
8
|
+
source: "E:/Bobo's Coding cache/.claude/skills/quality-assurance-framework"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
name: quality-assurance-framework
|
|
13
|
+
description: Unified QA - combines adversarial-verification (find vulnerabilities via attack) + self-rationalization-guard (prevent self-deception). Use before commits, after code changes, or when reviewing critical logic.
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# Quality Assurance Framework
|
|
17
|
+
|
|
18
|
+
> **Merged from**: adversarial-verification + self-rationalization-guard
|
|
19
|
+
> **Core principle**: Attack first, defend assumptions, verify ruthlessly
|
|
20
|
+
|
|
21
|
+
## Module 1: Adversarial Verification
|
|
22
|
+
|
|
23
|
+
### Attack Modes
|
|
24
|
+
|
|
25
|
+
**Mode A: Input Attack** — What inputs break this?
|
|
26
|
+
```
|
|
27
|
+
- Empty input? null? undefined?
|
|
28
|
+
- Extremely large input? (1M chars)
|
|
29
|
+
- Special characters? (<script>, SQL injection, path traversal)
|
|
30
|
+
- Unicode edge cases? (RTL, zero-width, emoji)
|
|
31
|
+
- Concurrent requests?
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**Mode B: State Attack** — What states break this?
|
|
35
|
+
```
|
|
36
|
+
- Race conditions between operations
|
|
37
|
+
- State transitions out of order
|
|
38
|
+
- Partial failures (network timeout mid-write)
|
|
39
|
+
- Resource exhaustion (disk full, memory OOM)
|
|
40
|
+
- Permission escalation paths
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
**Mode C: Logic Attack** — What assumptions are wrong?
|
|
44
|
+
```
|
|
45
|
+
- "This API always returns data" → What if it returns null?
|
|
46
|
+
- "This file always exists" → What if deleted mid-operation?
|
|
47
|
+
- "This operation is atomic" → What if interrupted?
|
|
48
|
+
- "This order is guaranteed" → What if reordered?
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Verification Checklist
|
|
52
|
+
|
|
53
|
+
```markdown
|
|
54
|
+
## Pre-Commit QA
|
|
55
|
+
|
|
56
|
+
### Input Validation
|
|
57
|
+
- [ ] All user inputs validated at system boundary
|
|
58
|
+
- [ ] SQL uses parameterized queries (no string concat)
|
|
59
|
+
- [ ] HTML output sanitized (no raw user content)
|
|
60
|
+
- [ ] File paths validated (no path traversal)
|
|
61
|
+
- [ ] Rate limiting on all public endpoints
|
|
62
|
+
|
|
63
|
+
### Error Handling
|
|
64
|
+
- [ ] All async operations have try/catch
|
|
65
|
+
- [ ] Errors are thrown, not silently swallowed
|
|
66
|
+
- [ ] Error messages don't leak sensitive data
|
|
67
|
+
- [ ] Failed operations clean up resources
|
|
68
|
+
|
|
69
|
+
### State Safety
|
|
70
|
+
- [ ] No race conditions in shared state
|
|
71
|
+
- [ ] Atomic operations where needed
|
|
72
|
+
- [ ] Proper locking for concurrent access
|
|
73
|
+
- [ ] Rollback on partial failures
|
|
74
|
+
|
|
75
|
+
### Security
|
|
76
|
+
- [ ] No hardcoded secrets
|
|
77
|
+
- [ ] Authentication verified on protected routes
|
|
78
|
+
- [ ] Authorization checked at each level
|
|
79
|
+
- [ ] CSRF protection enabled
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Module 2: Self-Rationalization Guard
|
|
85
|
+
|
|
86
|
+
### Red Flags (Self-Deception Patterns)
|
|
87
|
+
|
|
88
|
+
| Pattern | What You Tell Yourself | Reality |
|
|
89
|
+
|---------|----------------------|---------|
|
|
90
|
+
| **Hand-waving** | "This edge case won't happen" | It will, in production |
|
|
91
|
+
| **Scope creep** | "While I'm here, let me also..." | Unrelated changes introduce bugs |
|
|
92
|
+
| **Assumption skip** | "The caller will validate this" | They won't |
|
|
93
|
+
| **Optimism bias** | "This should work" | Prove it with a test |
|
|
94
|
+
| **Sunk cost** | "I've already spent time on this approach" | Switch if a better one exists |
|
|
95
|
+
| **Complexity justify** | "It needs to be this complex" | Simpler exists, find it |
|
|
96
|
+
|
|
97
|
+
### Anti-Deception Protocol
|
|
98
|
+
|
|
99
|
+
Before marking any task complete:
|
|
100
|
+
|
|
101
|
+
```
|
|
102
|
+
1. Red Team your own code
|
|
103
|
+
→ "If I wanted to break this, how would I?"
|
|
104
|
+
→ Find at least ONE potential issue
|
|
105
|
+
|
|
106
|
+
2. Challenge your assumptions
|
|
107
|
+
→ List every assumption you made
|
|
108
|
+
→ Verify each one is actually true
|
|
109
|
+
|
|
110
|
+
3. Ask "What would make this fail?"
|
|
111
|
+
→ Not "Does this work?"
|
|
112
|
+
→ But "Under what conditions does this break?"
|
|
113
|
+
|
|
114
|
+
4. Simplicity check
|
|
115
|
+
→ Could this be done with fewer abstractions?
|
|
116
|
+
→ Is every line earning its existence?
|
|
117
|
+
|
|
118
|
+
5. Test the negative path
|
|
119
|
+
→ Don't just test the happy path
|
|
120
|
+
→ Test every error/failure scenario
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Combined QA Workflow
|
|
126
|
+
|
|
127
|
+
### Before Every Commit
|
|
128
|
+
|
|
129
|
+
```
|
|
130
|
+
1. Adversarial scan (Module 1)
|
|
131
|
+
├─ Input attack: 2 min
|
|
132
|
+
├─ State attack: 2 min
|
|
133
|
+
└─ Logic attack: 2 min
|
|
134
|
+
|
|
135
|
+
2. Self-deception check (Module 2)
|
|
136
|
+
├─ Red flag scan: 1 min
|
|
137
|
+
├─ Assumption challenge: 1 min
|
|
138
|
+
└─ Simplicity check: 1 min
|
|
139
|
+
|
|
140
|
+
3. Automated verification
|
|
141
|
+
├─ Run tests: npm test
|
|
142
|
+
├─ Type check: tsc --noEmit
|
|
143
|
+
└─ Lint: eslint .
|
|
144
|
+
|
|
145
|
+
Total: ~10 minutes per commit
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### Before Every PR
|
|
149
|
+
|
|
150
|
+
```
|
|
151
|
+
1. Full adversarial verification (Module 1)
|
|
152
|
+
2. Self-deception deep dive (Module 2)
|
|
153
|
+
3. Security scan (OWASP top 10)
|
|
154
|
+
4. Performance check (no regressions)
|
|
155
|
+
5. Accessibility check (if UI changes)
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Quick Reference
|
|
161
|
+
|
|
162
|
+
```markdown
|
|
163
|
+
# 3-Question QA (use for every change)
|
|
164
|
+
|
|
165
|
+
1. "How would I break this?" → Fix the break point
|
|
166
|
+
2. "What assumption am I making?" → Verify the assumption
|
|
167
|
+
3. "Could this be simpler?" → Simplify if yes
|
|
168
|
+
```
|