claudify-agent 1.0.1 → 1.0.2

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 (47) hide show
  1. package/.claude/QUICK-REFERENCE.md +213 -213
  2. package/.claude/cost-dashboard.md +162 -162
  3. package/.claude/docs/COST-OPTIMIZATION.md +402 -403
  4. package/.claude/docs/MCP-INTEGRATION-GUIDE.md +348 -348
  5. package/.claude/docs/PLAN-MODE-OPTIMIZATION.md +835 -836
  6. package/.claude/hooks/auto-learning-review.ts +200 -195
  7. package/.claude/hooks/auto-lint-fix.ts +60 -104
  8. package/.claude/hooks/auto-security-review.ts +314 -354
  9. package/.claude/hooks/auto-validate.ts +249 -348
  10. package/.claude/hooks/lib/claude-hook.ts +168 -0
  11. package/.claude/hooks/plan-quality-tracker.ts +598 -719
  12. package/.claude/rules/anti-patterns.md +22 -22
  13. package/.claude/rules/context-tier-1.md +41 -41
  14. package/.claude/rules/context-tier-2.md +285 -285
  15. package/.claude/rules/general.md +25 -25
  16. package/.claude/rules/mcp-auto-use.md +46 -46
  17. package/.claude/rules/parallel-exploration-auto.md +30 -31
  18. package/.claude/rules/plan-mode-execution.md +289 -289
  19. package/.claude/rules/plan-mode-research.md +34 -34
  20. package/.claude/rules/plan-mode-structure.md +166 -166
  21. package/.claude/rules/plan-mode-validation.md +129 -130
  22. package/.claude/rules/security-critical.md +19 -19
  23. package/.claude/rules/tool-auto-selection.md +45 -45
  24. package/.claude/rules/tool-strategy.md +22 -22
  25. package/.claude/scripts/security-scan.js +1 -1
  26. package/.claude/security-dashboard.md +142 -142
  27. package/.claude/settings.json +50 -0
  28. package/.claude/skills/debug-optimizer/SKILL.md +420 -399
  29. package/.claude/skills/learning-loop/SKILL.md +313 -308
  30. package/.claude/skills/mcp-mastery/SKILL.md +218 -214
  31. package/.claude/skills/nextjs-guide/SKILL.md +687 -687
  32. package/.claude/skills/parallel-exploration/SKILL.md +197 -193
  33. package/.claude/skills/plan-mode-mastery/SKILL.md +268 -263
  34. package/.claude/skills/python-guide/SKILL.md +822 -822
  35. package/.claude/skills/react-guide/SKILL.md +762 -762
  36. package/.claude/skills/{security.md → security-guide/SKILL.md} +10 -0
  37. package/.claude/skills/solidity-guide/SKILL.md +5 -0
  38. package/.claude/skills/tool-selection/SKILL.md +433 -428
  39. package/.claude/skills/vite-guide/SKILL.md +445 -445
  40. package/CLAUDE.md +1 -0
  41. package/README.md +74 -35
  42. package/README.vi.md +106 -0
  43. package/bin/cli.js +13 -4
  44. package/package.json +9 -1
  45. package/.claude/skills/debug-optimizer.md +0 -12
  46. package/.claude/skills/nextjs.md +0 -13
  47. package/.claude/skills/react.md +0 -12
@@ -1,46 +1,46 @@
1
- # MCP Server Auto-Use
2
-
3
- ## Automatic Triggers
4
-
5
- ### user-context7 (Library/Framework Questions)
6
- **Trigger Keywords**: "how to", "implement", "best practice", "pattern", "library", "framework", "package"
7
-
8
- **Auto-Fetch Examples**:
9
- - User: "Add authentication" → Fetch: "Next.js auth patterns 2026"
10
- - User: "Create API endpoint" → Fetch: "REST API best practices"
11
- - User: "Use WebSocket" → Fetch: "WebSocket implementation guide"
12
-
13
- **Rule**: **ALWAYS** fetch docs BEFORE implementing unfamiliar patterns
14
-
15
- ### Other MCP Servers
16
-
17
- | MCP Server | When to Use | Cost |
18
- |------------|-------------|------|
19
- | cursor-ide-browser | UI changes, visual verification | High |
20
- | user-github | PR/issue operations, git commands | Moderate |
21
- | user-ESLint | After EVERY code change (automatic) | Low |
22
- | user-chrome-devtools | Performance audits, Lighthouse | Moderate |
23
- | user-playwright | E2E testing, cross-browser | High |
24
-
25
- ## Cost Hierarchy
26
-
27
- **Tier 1 (Use Liberally)**: user-ESLint, user-context7
28
- **Tier 2 (Use When Needed)**: user-github, user-chrome-devtools
29
- **Tier 3 (Use Sparingly)**: cursor-ide-browser, user-playwright
30
-
31
- ## Rules
32
-
33
- 1. Always try cheaper tools first (follow escalation protocol)
34
- 2. Run user-ESLint automatically after code changes
35
- 3. Fetch docs with user-context7 BEFORE implementing
36
- 4. Use cursor-ide-browser ONLY for visual verification
37
- 5. Use user-github for all GitHub operations
38
-
39
- ## Patterns & Examples
40
- See `.cursor/docs/MCP-INTEGRATION-GUIDE.md` for complete patterns, chaining examples, and cost optimization strategies.
41
-
42
- ## Fallback
43
- - Browser unavailable → Use built-in Browser tools
44
- - GitHub unavailable → Use Shell with gh CLI
45
- - ESLint unavailable → Use Shell with npm run lint
46
- - Context7 unavailable → Use WebSearch
1
+ # MCP Server Auto-Use
2
+
3
+ ## Automatic Triggers
4
+
5
+ ### context7 (Library/Framework Questions)
6
+ **Trigger Keywords**: "how to", "implement", "best practice", "pattern", "library", "framework", "package"
7
+
8
+ **Auto-Fetch Examples**:
9
+ - User: "Add authentication" → Fetch: "Next.js auth patterns 2026"
10
+ - User: "Create API endpoint" → Fetch: "REST API best practices"
11
+ - User: "Use WebSocket" → Fetch: "WebSocket implementation guide"
12
+
13
+ **Rule**: **ALWAYS** fetch docs BEFORE implementing unfamiliar patterns
14
+
15
+ ### Other MCP Servers
16
+
17
+ | MCP Server | When to Use | Cost |
18
+ |------------|-------------|------|
19
+ | claude-in-chrome | UI changes, visual verification | High |
20
+ | github | PR/issue operations, git commands | Moderate |
21
+ | eslint | After EVERY code change (automatic) | Low |
22
+ | chrome-devtools | Performance audits, Lighthouse | Moderate |
23
+ | playwright | E2E testing, cross-browser | High |
24
+
25
+ ## Cost Hierarchy
26
+
27
+ **Tier 1 (Use Liberally)**: eslint, context7
28
+ **Tier 2 (Use When Needed)**: github, chrome-devtools
29
+ **Tier 3 (Use Sparingly)**: claude-in-chrome, playwright
30
+
31
+ ## Rules
32
+
33
+ 1. Always try cheaper tools first (follow escalation protocol)
34
+ 2. Run eslint automatically after code changes
35
+ 3. Fetch docs with context7 BEFORE implementing
36
+ 4. Use claude-in-chrome ONLY for visual verification
37
+ 5. Use github for all GitHub operations
38
+
39
+ ## Patterns & Examples
40
+ See `.claude/docs/MCP-INTEGRATION-GUIDE.md` for complete patterns, chaining examples, and cost optimization strategies.
41
+
42
+ ## Fallback
43
+ - Browser unavailable → Use playwright MCP, or WebFetch for static pages
44
+ - GitHub unavailable → Use Bash with gh CLI
45
+ - ESLint unavailable → Use Bash with npm run lint
46
+ - Context7 unavailable → Use WebSearch
@@ -1,31 +1,30 @@
1
- # Parallel Exploration Auto
2
-
3
- ## Automatic Triggers
4
-
5
- **Launch 2-4 parallel subagents when**:
6
- - Task spans >3 areas/directories
7
- - Complexity >10 steps or >5 files
8
- - Bug investigation (unknown root cause)
9
- - Agent unfamiliarity detected (>3 questions)
10
-
11
- ## Configuration
12
-
13
- ```yaml
14
- Task:
15
- subagent_type: "explore"
16
- model: "fast" # ALWAYS for exploration
17
- readonly: true
18
- run_in_background: true
19
- timeout: 120s
20
- ```
21
-
22
- ## Rules
23
-
24
- 1. Default to 2-3 subagents, scale to 4 for complex tasks
25
- 2. ALWAYS use `model="fast"` (90% of cases)
26
- 3. Consolidate findings before planning
27
- 4. See `.cursor/skills/parallel-exploration/SKILL.md` for patterns
28
-
29
- ## Anti-Patterns
30
-
31
- ❌ >4 subagents, ❌ capable model for exploration, ❌ no consolidation
1
+ # Parallel Exploration Auto
2
+
3
+ ## Automatic Triggers
4
+
5
+ **Launch 2-4 parallel subagents when**:
6
+ - Task spans >3 areas/directories
7
+ - Complexity >10 steps or >5 files
8
+ - Bug investigation (unknown root cause)
9
+ - Agent unfamiliarity detected (>3 questions)
10
+
11
+ ## Configuration
12
+
13
+ ```yaml
14
+ Agent:
15
+ subagent_type: "Explore"
16
+ model: "haiku" # ALWAYS for exploration
17
+ run_in_background: true
18
+ timeout: 120s
19
+ ```
20
+
21
+ ## Rules
22
+
23
+ 1. Default to 2-3 subagents, scale to 4 for complex tasks
24
+ 2. ALWAYS use `model="haiku"` (90% of cases)
25
+ 3. Consolidate findings before planning
26
+ 4. See `.claude/skills/parallel-exploration/SKILL.md` for patterns
27
+
28
+ ## Anti-Patterns
29
+
30
+ ❌ >4 subagents, ❌ capable model for exploration, ❌ no consolidation