bobo-ai-cli 1.0.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 (234) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +216 -0
  3. package/dist/agent.d.ts +9 -0
  4. package/dist/agent.js +144 -0
  5. package/dist/agent.js.map +1 -0
  6. package/dist/config.d.ts +15 -0
  7. package/dist/config.js +76 -0
  8. package/dist/config.js.map +1 -0
  9. package/dist/index.d.ts +2 -0
  10. package/dist/index.js +366 -0
  11. package/dist/index.js.map +1 -0
  12. package/dist/knowledge-commands.d.ts +2 -0
  13. package/dist/knowledge-commands.js +40 -0
  14. package/dist/knowledge-commands.js.map +1 -0
  15. package/dist/knowledge.d.ts +17 -0
  16. package/dist/knowledge.js +112 -0
  17. package/dist/knowledge.js.map +1 -0
  18. package/dist/memory.d.ts +17 -0
  19. package/dist/memory.js +215 -0
  20. package/dist/memory.js.map +1 -0
  21. package/dist/planner.d.ts +22 -0
  22. package/dist/planner.js +130 -0
  23. package/dist/planner.js.map +1 -0
  24. package/dist/project.d.ts +25 -0
  25. package/dist/project.js +117 -0
  26. package/dist/project.js.map +1 -0
  27. package/dist/rules-commands.d.ts +2 -0
  28. package/dist/rules-commands.js +51 -0
  29. package/dist/rules-commands.js.map +1 -0
  30. package/dist/skills.d.ts +28 -0
  31. package/dist/skills.js +349 -0
  32. package/dist/skills.js.map +1 -0
  33. package/dist/structured/loader.d.ts +19 -0
  34. package/dist/structured/loader.js +147 -0
  35. package/dist/structured/loader.js.map +1 -0
  36. package/dist/structured/paths.d.ts +2 -0
  37. package/dist/structured/paths.js +14 -0
  38. package/dist/structured/paths.js.map +1 -0
  39. package/dist/structured/project-scaffold.d.ts +7 -0
  40. package/dist/structured/project-scaffold.js +60 -0
  41. package/dist/structured/project-scaffold.js.map +1 -0
  42. package/dist/structured/render-markdown.d.ts +37 -0
  43. package/dist/structured/render-markdown.js +47 -0
  44. package/dist/structured/render-markdown.js.map +1 -0
  45. package/dist/structured/render-table.d.ts +1 -0
  46. package/dist/structured/render-table.js +15 -0
  47. package/dist/structured/render-table.js.map +1 -0
  48. package/dist/structured/search.d.ts +10 -0
  49. package/dist/structured/search.js +104 -0
  50. package/dist/structured/search.js.map +1 -0
  51. package/dist/structured/skill-runner.d.ts +15 -0
  52. package/dist/structured/skill-runner.js +60 -0
  53. package/dist/structured/skill-runner.js.map +1 -0
  54. package/dist/structured/types.d.ts +212 -0
  55. package/dist/structured/types.js +97 -0
  56. package/dist/structured/types.js.map +1 -0
  57. package/dist/structured-skills-commands.d.ts +3 -0
  58. package/dist/structured-skills-commands.js +126 -0
  59. package/dist/structured-skills-commands.js.map +1 -0
  60. package/dist/structured-template-commands.d.ts +2 -0
  61. package/dist/structured-template-commands.js +34 -0
  62. package/dist/structured-template-commands.js.map +1 -0
  63. package/dist/tools/index.d.ts +3 -0
  64. package/dist/tools/index.js +450 -0
  65. package/dist/tools/index.js.map +1 -0
  66. package/dist/ui.d.ts +19 -0
  67. package/dist/ui.js +72 -0
  68. package/dist/ui.js.map +1 -0
  69. package/dist/web.d.ts +4 -0
  70. package/dist/web.js +124 -0
  71. package/dist/web.js.map +1 -0
  72. package/knowledge/advanced-patterns.md +70 -0
  73. package/knowledge/agent-directives.md +74 -0
  74. package/knowledge/dream.md +36 -0
  75. package/knowledge/engineering.md +46 -0
  76. package/knowledge/error-catalog.md +33 -0
  77. package/knowledge/index.json +170 -0
  78. package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -0
  79. package/knowledge/memory/engineering-patterns.md +134 -0
  80. package/knowledge/memory/feedback_root_structure.md +16 -0
  81. package/knowledge/memory/project-contexts.md +69 -0
  82. package/knowledge/memory/tools-and-services.md +85 -0
  83. package/knowledge/rules/agents.md +62 -0
  84. package/knowledge/rules/blocking-rules.md +323 -0
  85. package/knowledge/rules/cache-management.md +379 -0
  86. package/knowledge/rules/capability-evolution.md +132 -0
  87. package/knowledge/rules/coding.md +126 -0
  88. package/knowledge/rules/engineering-workflows.md +225 -0
  89. package/knowledge/rules/evomap-content-guidelines.md +354 -0
  90. package/knowledge/rules/evomap-guide.md +224 -0
  91. package/knowledge/rules/git.md +31 -0
  92. package/knowledge/rules/hooks.md +106 -0
  93. package/knowledge/rules/performance.md +101 -0
  94. package/knowledge/rules/remotion-auto-production.md +1120 -0
  95. package/knowledge/rules/security.md +46 -0
  96. package/knowledge/rules/testing.md +32 -0
  97. package/knowledge/rules/work-mode.md +208 -0
  98. package/knowledge/rules.md +62 -0
  99. package/knowledge/skills/Skill_Seekers.md +1722 -0
  100. package/knowledge/skills/ab-test-setup.md +557 -0
  101. package/knowledge/skills/agent-sdk-dev.md +238 -0
  102. package/knowledge/skills/agent-tools.md +136 -0
  103. package/knowledge/skills/analytics-tracking.md +597 -0
  104. package/knowledge/skills/artifacts-builder.md +89 -0
  105. package/knowledge/skills/asana.md +13 -0
  106. package/knowledge/skills/backend-expert.md +97 -0
  107. package/knowledge/skills/brand-voice.md +481 -0
  108. package/knowledge/skills/browser-use.md +419 -0
  109. package/knowledge/skills/cache-optimization-skill.md +179 -0
  110. package/knowledge/skills/canvas-design.md +147 -0
  111. package/knowledge/skills/citation-validator.md +203 -0
  112. package/knowledge/skills/clangd-lsp.md +52 -0
  113. package/knowledge/skills/code-review-expert.md +85 -0
  114. package/knowledge/skills/code-review.md +280 -0
  115. package/knowledge/skills/code-simplifier.md +13 -0
  116. package/knowledge/skills/commit-commands.md +258 -0
  117. package/knowledge/skills/competitor-alternatives.md +795 -0
  118. package/knowledge/skills/content-atomizer.md +910 -0
  119. package/knowledge/skills/content-research-writer.md +605 -0
  120. package/knowledge/skills/context-optimization-suite.md +162 -0
  121. package/knowledge/skills/context7.md +13 -0
  122. package/knowledge/skills/copy-editing.md +494 -0
  123. package/knowledge/skills/copywriting.md +510 -0
  124. package/knowledge/skills/csharp-lsp.md +40 -0
  125. package/knowledge/skills/decision-making-framework.md +154 -0
  126. package/knowledge/skills/developer-growth-analysis.md +335 -0
  127. package/knowledge/skills/direct-response-copy.md +2336 -0
  128. package/knowledge/skills/docker-expert.md +229 -0
  129. package/knowledge/skills/document-skills.md +13 -0
  130. package/knowledge/skills/documentation-expert.md +126 -0
  131. package/knowledge/skills/email-sequence.md +1061 -0
  132. package/knowledge/skills/email-sequences.md +910 -0
  133. package/knowledge/skills/example-plugin.md +72 -0
  134. package/knowledge/skills/explanatory-output-style.md +82 -0
  135. package/knowledge/skills/feature-dev.md +458 -0
  136. package/knowledge/skills/file-organizer.md +466 -0
  137. package/knowledge/skills/firebase.disabled.md +13 -0
  138. package/knowledge/skills/form-cro.md +488 -0
  139. package/knowledge/skills/free-tool-strategy.md +636 -0
  140. package/knowledge/skills/frontend-design-offical.md +55 -0
  141. package/knowledge/skills/frontend-design.md +41 -0
  142. package/knowledge/skills/frontend-expert.md +93 -0
  143. package/knowledge/skills/github.md +13 -0
  144. package/knowledge/skills/gitlab.md +13 -0
  145. package/knowledge/skills/gopls-lsp.md +32 -0
  146. package/knowledge/skills/got-controller.md +218 -0
  147. package/knowledge/skills/greptile.md +72 -0
  148. package/knowledge/skills/hookify.md +376 -0
  149. package/knowledge/skills/image-editor.md +189 -0
  150. package/knowledge/skills/image-enhancer.md +109 -0
  151. package/knowledge/skills/jdtls-lsp.md +49 -0
  152. package/knowledge/skills/json-canvas.md +654 -0
  153. package/knowledge/skills/keyword-research.md +559 -0
  154. package/knowledge/skills/kotlin-lsp.md +28 -0
  155. package/knowledge/skills/laravel-boost.md +13 -0
  156. package/knowledge/skills/launch-strategy.md +394 -0
  157. package/knowledge/skills/lead-magnet.md +393 -0
  158. package/knowledge/skills/learning-output-style.md +106 -0
  159. package/knowledge/skills/linear.md +13 -0
  160. package/knowledge/skills/lua-lsp.md +47 -0
  161. package/knowledge/skills/marketing-ideas.md +720 -0
  162. package/knowledge/skills/marketing-psychology.md +534 -0
  163. package/knowledge/skills/mcp-builder.md +369 -0
  164. package/knowledge/skills/meeting-insights-analyzer.md +347 -0
  165. package/knowledge/skills/memory-evolution-system.md +172 -0
  166. package/knowledge/skills/multi-lens-thinking.md +407 -0
  167. package/knowledge/skills/nano-banana-pro.md +116 -0
  168. package/knowledge/skills/newsletter.md +736 -0
  169. package/knowledge/skills/notebooklm.md +296 -0
  170. package/knowledge/skills/obsidian-bases.md +634 -0
  171. package/knowledge/skills/obsidian-markdown.md +651 -0
  172. package/knowledge/skills/onboarding-cro.md +494 -0
  173. package/knowledge/skills/orchestrator.md +681 -0
  174. package/knowledge/skills/page-cro.md +379 -0
  175. package/knowledge/skills/paid-ads.md +624 -0
  176. package/knowledge/skills/paywall-upgrade-cro.md +651 -0
  177. package/knowledge/skills/php-lsp.md +36 -0
  178. package/knowledge/skills/planning-with-files.md +193 -0
  179. package/knowledge/skills/playwright.md +13 -0
  180. package/knowledge/skills/plugin-dev.md +434 -0
  181. package/knowledge/skills/popup-cro.md +520 -0
  182. package/knowledge/skills/positioning-angles.md +330 -0
  183. package/knowledge/skills/pr-review-toolkit.md +359 -0
  184. package/knowledge/skills/pricing-strategy.md +777 -0
  185. package/knowledge/skills/programmatic-seo.md +714 -0
  186. package/knowledge/skills/pyright-lsp.md +43 -0
  187. package/knowledge/skills/quality-assurance-framework.md +168 -0
  188. package/knowledge/skills/question-refiner.md +160 -0
  189. package/knowledge/skills/ralph-loop.md +205 -0
  190. package/knowledge/skills/refactoring-expert.md +103 -0
  191. package/knowledge/skills/referral-program.md +668 -0
  192. package/knowledge/skills/research-executor.md +164 -0
  193. package/knowledge/skills/review-with-security.md +12 -0
  194. package/knowledge/skills/rust-analyzer-lsp.md +50 -0
  195. package/knowledge/skills/schema-markup.md +647 -0
  196. package/knowledge/skills/security-audit-expert.md +124 -0
  197. package/knowledge/skills/security-expert.md +140 -0
  198. package/knowledge/skills/security-guidance.md +13 -0
  199. package/knowledge/skills/seedance-prompt.md +139 -0
  200. package/knowledge/skills/self-evolution.md +1160 -0
  201. package/knowledge/skills/seo-audit.md +432 -0
  202. package/knowledge/skills/seo-content.md +787 -0
  203. package/knowledge/skills/serena.md +13 -0
  204. package/knowledge/skills/signup-flow-cro.md +409 -0
  205. package/knowledge/skills/skill-creator.md +220 -0
  206. package/knowledge/skills/skill-manager.md +226 -0
  207. package/knowledge/skills/skill-share.md +98 -0
  208. package/knowledge/skills/slack.md +13 -0
  209. package/knowledge/skills/social-content.md +878 -0
  210. package/knowledge/skills/spec-flow-skill.md +124 -0
  211. package/knowledge/skills/stripe.md +13 -0
  212. package/knowledge/skills/supabase.md +13 -0
  213. package/knowledge/skills/swift-lsp.md +40 -0
  214. package/knowledge/skills/synthesizer.md +236 -0
  215. package/knowledge/skills/template-skill.md +16 -0
  216. package/knowledge/skills/testing-expert.md +99 -0
  217. package/knowledge/skills/theme-factory.md +72 -0
  218. package/knowledge/skills/tiktok-research.md +208 -0
  219. package/knowledge/skills/typescript-lsp.md +36 -0
  220. package/knowledge/skills/ui-ux-pro-max.md +247 -0
  221. package/knowledge/skills/verify.md +15 -0
  222. package/knowledge/skills/visual-prompt-engineer.md +102 -0
  223. package/knowledge/skills/webapp-testing.md +111 -0
  224. package/knowledge/skills/wide-research.md +191 -0
  225. package/knowledge/system.md +93 -0
  226. package/knowledge/task-router.md +37 -0
  227. package/knowledge/verification.md +38 -0
  228. package/knowledge/workflows/3d-viz.md +47 -0
  229. package/knowledge/workflows/data-pipeline.md +47 -0
  230. package/knowledge/workflows/db-migration.md +51 -0
  231. package/knowledge/workflows/feature-dev.md +41 -0
  232. package/knowledge/workflows/tdd-flow.md +52 -0
  233. package/knowledge/workflows/ui-verify.md +51 -0
  234. package/package.json +60 -0
@@ -0,0 +1,72 @@
1
+ ---
2
+ id: "example-plugin"
3
+ title: "Example Plugin"
4
+ category: "other"
5
+ tags: ["example plugin", "structure", "extension options", "usage"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/example-plugin"
9
+ ---
10
+
11
+ # Example Plugin
12
+
13
+ A comprehensive example plugin demonstrating Claude Code extension options.
14
+
15
+ ## Structure
16
+
17
+ ```
18
+ example-plugin/
19
+ ├── .claude-plugin/
20
+ │ └── plugin.json # Plugin metadata
21
+ ├── .mcp.json # MCP server configuration
22
+ ├── commands/
23
+ │ └── example-command.md # Slash command definition
24
+ └── skills/
25
+ └── example-skill/
26
+ └── SKILL.md # Skill definition
27
+ ```
28
+
29
+ ## Extension Options
30
+
31
+ ### Commands (`commands/`)
32
+
33
+ Slash commands are user-invoked via `/command-name`. Define them as markdown files with frontmatter:
34
+
35
+ ```yaml
36
+ ---
37
+ description: Short description for /help
38
+ argument-hint: <arg1> [optional-arg]
39
+ allowed-tools: [Read, Glob, Grep]
40
+ ---
41
+ ```
42
+
43
+ ### Skills (`skills/`)
44
+
45
+ Skills are model-invoked capabilities. Create a `SKILL.md` in a subdirectory:
46
+
47
+ ```yaml
48
+ ---
49
+ name: skill-name
50
+ description: Trigger conditions for this skill
51
+ version: 1.0.0
52
+ ---
53
+ ```
54
+
55
+ ### MCP Servers (`.mcp.json`)
56
+
57
+ Configure external tool integration via Model Context Protocol:
58
+
59
+ ```json
60
+ {
61
+ "server-name": {
62
+ "type": "http",
63
+ "url": "https://mcp.example.com/api"
64
+ }
65
+ }
66
+ ```
67
+
68
+ ## Usage
69
+
70
+ - `/example-command [args]` - Run the example slash command
71
+ - The example skill activates based on task context
72
+ - The example MCP activates based on task context
@@ -0,0 +1,82 @@
1
+ ---
2
+ id: "explanatory-output-style"
3
+ title: "Explanatory Output Style Plugin"
4
+ category: "knowledge"
5
+ tags: ["what it does", "how it works", "usage", "migration from output styles", "managing changes"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/explanatory-output-style"
9
+ ---
10
+
11
+ # Explanatory Output Style Plugin
12
+
13
+ This plugin recreates the deprecated Explanatory output style as a SessionStart
14
+ hook.
15
+
16
+ WARNING: Do not install this plugin unless you are fine with incurring the token
17
+ cost of this plugin's additional instructions and output.
18
+
19
+ ## What it does
20
+
21
+ When enabled, this plugin automatically adds instructions at the start of each
22
+ session that encourage Claude to:
23
+
24
+ 1. Provide educational insights about implementation choices
25
+ 2. Explain codebase patterns and decisions
26
+ 3. Balance task completion with learning opportunities
27
+
28
+ ## How it works
29
+
30
+ The plugin uses a SessionStart hook to inject additional context into every
31
+ session. This context instructs Claude to provide brief educational explanations
32
+ before and after writing code, formatted as:
33
+
34
+ ```
35
+ `★ Insight ─────────────────────────────────────`
36
+ [2-3 key educational points]
37
+ `─────────────────────────────────────────────────`
38
+ ```
39
+
40
+ ## Usage
41
+
42
+ Once installed, the plugin activates automatically at the start of every
43
+ session. No additional configuration is needed.
44
+
45
+ The insights focus on:
46
+
47
+ - Specific implementation choices for your codebase
48
+ - Patterns and conventions in your code
49
+ - Trade-offs and design decisions
50
+ - Codebase-specific details rather than general programming concepts
51
+
52
+ ## Migration from Output Styles
53
+
54
+ This plugin replaces the deprecated "Explanatory" output style setting. If you
55
+ previously used:
56
+
57
+ ```json
58
+ {
59
+ "outputStyle": "Explanatory"
60
+ }
61
+ ```
62
+
63
+ You can now achieve the same behavior by installing this plugin instead.
64
+
65
+ More generally, this SessionStart hook pattern is roughly equivalent to
66
+ CLAUDE.md, but it is more flexible and allows for distribution through plugins.
67
+
68
+ Note: Output styles that involve tasks besides software development, are better
69
+ expressed as
70
+ [subagents](https://docs.claude.com/en/docs/claude-code/sub-agents), not as
71
+ SessionStart hooks. Subagents change the system prompt while SessionStart hooks
72
+ add to the default system prompt.
73
+
74
+ ## Managing changes
75
+
76
+ - Disable the plugin - keep the code installed on your device
77
+ - Uninstall the plugin - remove the code from your device
78
+ - Update the plugin - create a local copy of this plugin to personalize this
79
+ plugin
80
+ - Hint: Ask Claude to read
81
+ https://docs.claude.com/en/docs/claude-code/plugins.md and set it up for
82
+ you!
@@ -0,0 +1,458 @@
1
+ ---
2
+ id: "feature-dev"
3
+ title: "Feature Development Plugin"
4
+ category: "dev-tools"
5
+ tags: ["feature development plugin", "overview", "philosophy", "the 7-phase workflow", "agents", "usage patterns", "best practices", "when to use this plugin", "requirements"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/feature-dev"
9
+ ---
10
+
11
+ # Feature Development Plugin
12
+
13
+ A comprehensive, structured workflow for feature development with specialized agents for codebase exploration, architecture design, and quality review.
14
+
15
+ ## Overview
16
+
17
+ The Feature Development Plugin provides a systematic 7-phase approach to building new features. Instead of jumping straight into code, it guides you through understanding the codebase, asking clarifying questions, designing architecture, and ensuring quality—resulting in better-designed features that integrate seamlessly with your existing code.
18
+
19
+ ## Philosophy
20
+
21
+ Building features requires more than just writing code. You need to:
22
+
23
+ - **Understand the codebase** before making changes
24
+ - **Ask questions** to clarify ambiguous requirements
25
+ - **Design thoughtfully** before implementing
26
+ - **Review for quality** after building
27
+
28
+ This plugin embeds these practices into a structured workflow that runs automatically when you use the `/feature-dev` command.
29
+
30
+ ## Command: `/feature-dev`
31
+
32
+ Launches a guided feature development workflow with 7 distinct phases.
33
+
34
+ **Usage:**
35
+
36
+ ```bash
37
+ /feature-dev Add user authentication with OAuth
38
+ ```
39
+
40
+ Or simply:
41
+
42
+ ```bash
43
+ /feature-dev
44
+ ```
45
+
46
+ The command will guide you through the entire process interactively.
47
+
48
+ ## The 7-Phase Workflow
49
+
50
+ ### Phase 1: Discovery
51
+
52
+ **Goal**: Understand what needs to be built
53
+
54
+ **What happens:**
55
+
56
+ - Clarifies the feature request if it's unclear
57
+ - Asks what problem you're solving
58
+ - Identifies constraints and requirements
59
+ - Summarizes understanding and confirms with you
60
+
61
+ **Example:**
62
+
63
+ ```
64
+ You: /feature-dev Add caching
65
+ Claude: Let me understand what you need...
66
+ - What should be cached? (API responses, computed values, etc.)
67
+ - What are your performance requirements?
68
+ - Do you have a preferred caching solution?
69
+ ```
70
+
71
+ ### Phase 2: Codebase Exploration
72
+
73
+ **Goal**: Understand relevant existing code and patterns
74
+
75
+ **What happens:**
76
+
77
+ - Launches 2-3 `code-explorer` agents in parallel
78
+ - Each agent explores different aspects (similar features, architecture, UI patterns)
79
+ - Agents return comprehensive analyses with key files to read
80
+ - Claude reads all identified files to build deep understanding
81
+ - Presents comprehensive summary of findings
82
+
83
+ **Agents launched:**
84
+
85
+ - "Find features similar to [feature] and trace implementation"
86
+ - "Map the architecture and abstractions for [area]"
87
+ - "Analyze current implementation of [related feature]"
88
+
89
+ **Example output:**
90
+
91
+ ```
92
+ Found similar features:
93
+ - User authentication (src/auth/): Uses JWT tokens, middleware pattern
94
+ - Session management (src/session/): Redis-backed, 24hr expiry
95
+ - API security (src/api/middleware/): Rate limiting, CORS
96
+
97
+ Key files to understand:
98
+ - src/auth/AuthService.ts:45 - Core authentication logic
99
+ - src/middleware/authMiddleware.ts:12 - Request authentication
100
+ - src/config/security.ts:8 - Security configuration
101
+ ```
102
+
103
+ ### Phase 3: Clarifying Questions
104
+
105
+ **Goal**: Fill in gaps and resolve all ambiguities
106
+
107
+ **What happens:**
108
+
109
+ - Reviews codebase findings and feature request
110
+ - Identifies underspecified aspects:
111
+ - Edge cases
112
+ - Error handling
113
+ - Integration points
114
+ - Backward compatibility
115
+ - Performance needs
116
+ - Presents all questions in an organized list
117
+ - **Waits for your answers before proceeding**
118
+
119
+ **Example:**
120
+
121
+ ```
122
+ Before designing the architecture, I need to clarify:
123
+
124
+ 1. OAuth provider: Which OAuth providers? (Google, GitHub, custom?)
125
+ 2. User data: Store OAuth tokens or just user profile?
126
+ 3. Existing auth: Replace current auth or add alongside?
127
+ 4. Sessions: Integrate with existing session management?
128
+ 5. Error handling: How to handle OAuth failures?
129
+ ```
130
+
131
+ **Critical**: This phase ensures nothing is ambiguous before design begins.
132
+
133
+ ### Phase 4: Architecture Design
134
+
135
+ **Goal**: Design multiple implementation approaches
136
+
137
+ **What happens:**
138
+
139
+ - Launches 2-3 `code-architect` agents with different focuses:
140
+ - **Minimal changes**: Smallest change, maximum reuse
141
+ - **Clean architecture**: Maintainability, elegant abstractions
142
+ - **Pragmatic balance**: Speed + quality
143
+ - Reviews all approaches
144
+ - Forms opinion on which fits best for this task
145
+ - Presents comparison with trade-offs and recommendation
146
+ - **Asks which approach you prefer**
147
+
148
+ **Example output:**
149
+
150
+ ```
151
+ I've designed 3 approaches:
152
+
153
+ Approach 1: Minimal Changes
154
+ - Extend existing AuthService with OAuth methods
155
+ - Add new OAuth routes to existing auth router
156
+ - Minimal refactoring required
157
+ Pros: Fast, low risk
158
+ Cons: Couples OAuth to existing auth, harder to test
159
+
160
+ Approach 2: Clean Architecture
161
+ - New OAuthService with dedicated interface
162
+ - Separate OAuth router and middleware
163
+ - Refactor AuthService to use common interface
164
+ Pros: Clean separation, testable, maintainable
165
+ Cons: More files, more refactoring
166
+
167
+ Approach 3: Pragmatic Balance
168
+ - New OAuthProvider abstraction
169
+ - Integrate into existing AuthService
170
+ - Minimal refactoring, good boundaries
171
+ Pros: Balanced complexity and cleanliness
172
+ Cons: Some coupling remains
173
+
174
+ Recommendation: Approach 3 - gives you clean boundaries without
175
+ excessive refactoring, and fits your existing architecture well.
176
+
177
+ Which approach would you like to use?
178
+ ```
179
+
180
+ ### Phase 5: Implementation
181
+
182
+ **Goal**: Build the feature
183
+
184
+ **What happens:**
185
+
186
+ - **Waits for explicit approval** before starting
187
+ - Reads all relevant files identified in previous phases
188
+ - Implements following chosen architecture
189
+ - Follows codebase conventions strictly
190
+ - Writes clean, well-documented code
191
+ - Updates todos as progress is made
192
+
193
+ **Notes:**
194
+
195
+ - Implementation only starts after you approve
196
+ - Follows patterns discovered in Phase 2
197
+ - Uses architecture designed in Phase 4
198
+ - Continuously tracks progress
199
+
200
+ ### Phase 6: Quality Review
201
+
202
+ **Goal**: Ensure code is simple, DRY, elegant, and functionally correct
203
+
204
+ **What happens:**
205
+
206
+ - Launches 3 `code-reviewer` agents in parallel with different focuses:
207
+ - **Simplicity/DRY/Elegance**: Code quality and maintainability
208
+ - **Bugs/Correctness**: Functional correctness and logic errors
209
+ - **Conventions/Abstractions**: Project standards and patterns
210
+ - Consolidates findings
211
+ - Identifies highest severity issues
212
+ - **Presents findings and asks what you want to do**:
213
+ - Fix now
214
+ - Fix later
215
+ - Proceed as-is
216
+ - Addresses issues based on your decision
217
+
218
+ **Example output:**
219
+
220
+ ```
221
+ Code Review Results:
222
+
223
+ High Priority Issues:
224
+ 1. Missing error handling in OAuth callback (src/auth/oauth.ts:67)
225
+ 2. Memory leak: OAuth state not cleaned up (src/auth/oauth.ts:89)
226
+
227
+ Medium Priority:
228
+ 1. Could simplify token refresh logic (src/auth/oauth.ts:120)
229
+ 2. Consider extracting OAuth config validation
230
+
231
+ All tests pass. Code follows project conventions.
232
+
233
+ What would you like to do?
234
+ ```
235
+
236
+ ### Phase 7: Summary
237
+
238
+ **Goal**: Document what was accomplished
239
+
240
+ **What happens:**
241
+
242
+ - Marks all todos complete
243
+ - Summarizes:
244
+ - What was built
245
+ - Key decisions made
246
+ - Files modified
247
+ - Suggested next steps
248
+
249
+ **Example:**
250
+
251
+ ```
252
+ Feature Complete: OAuth Authentication
253
+
254
+ What was built:
255
+ - OAuth provider abstraction supporting Google and GitHub
256
+ - OAuth routes and middleware integrated with existing auth
257
+ - Token refresh and session integration
258
+ - Error handling for all OAuth flows
259
+
260
+ Key decisions:
261
+ - Used pragmatic approach with OAuthProvider abstraction
262
+ - Integrated with existing session management
263
+ - Added OAuth state to prevent CSRF
264
+
265
+ Files modified:
266
+ - src/auth/OAuthProvider.ts (new)
267
+ - src/auth/AuthService.ts
268
+ - src/routes/auth.ts
269
+ - src/middleware/authMiddleware.ts
270
+
271
+ Suggested next steps:
272
+ - Add tests for OAuth flows
273
+ - Add more OAuth providers (Microsoft, Apple)
274
+ - Update documentation
275
+ ```
276
+
277
+ ## Agents
278
+
279
+ ### `code-explorer`
280
+
281
+ **Purpose**: Deeply analyzes existing codebase features by tracing execution paths
282
+
283
+ **Focus areas:**
284
+
285
+ - Entry points and call chains
286
+ - Data flow and transformations
287
+ - Architecture layers and patterns
288
+ - Dependencies and integrations
289
+ - Implementation details
290
+
291
+ **When triggered:**
292
+
293
+ - Automatically in Phase 2
294
+ - Can be invoked manually when exploring code
295
+
296
+ **Output:**
297
+
298
+ - Entry points with file:line references
299
+ - Step-by-step execution flow
300
+ - Key components and responsibilities
301
+ - Architecture insights
302
+ - List of essential files to read
303
+
304
+ ### `code-architect`
305
+
306
+ **Purpose**: Designs feature architectures and implementation blueprints
307
+
308
+ **Focus areas:**
309
+
310
+ - Codebase pattern analysis
311
+ - Architecture decisions
312
+ - Component design
313
+ - Implementation roadmap
314
+ - Data flow and build sequence
315
+
316
+ **When triggered:**
317
+
318
+ - Automatically in Phase 4
319
+ - Can be invoked manually for architecture design
320
+
321
+ **Output:**
322
+
323
+ - Patterns and conventions found
324
+ - Architecture decision with rationale
325
+ - Complete component design
326
+ - Implementation map with specific files
327
+ - Build sequence with phases
328
+
329
+ ### `code-reviewer`
330
+
331
+ **Purpose**: Reviews code for bugs, quality issues, and project conventions
332
+
333
+ **Focus areas:**
334
+
335
+ - Project guideline compliance (CLAUDE.md)
336
+ - Bug detection
337
+ - Code quality issues
338
+ - Confidence-based filtering (only reports high-confidence issues ≥80)
339
+
340
+ **When triggered:**
341
+
342
+ - Automatically in Phase 6
343
+ - Can be invoked manually after writing code
344
+
345
+ **Output:**
346
+
347
+ - Critical issues (confidence 75-100)
348
+ - Important issues (confidence 50-74)
349
+ - Specific fixes with file:line references
350
+ - Project guideline references
351
+
352
+ ## Usage Patterns
353
+
354
+ ### Full workflow (recommended for new features):
355
+
356
+ ```bash
357
+ /feature-dev Add rate limiting to API endpoints
358
+ ```
359
+
360
+ Let the workflow guide you through all 7 phases.
361
+
362
+ ### Manual agent invocation:
363
+
364
+ **Explore a feature:**
365
+
366
+ ```
367
+ "Launch code-explorer to trace how authentication works"
368
+ ```
369
+
370
+ **Design architecture:**
371
+
372
+ ```
373
+ "Launch code-architect to design the caching layer"
374
+ ```
375
+
376
+ **Review code:**
377
+
378
+ ```
379
+ "Launch code-reviewer to check my recent changes"
380
+ ```
381
+
382
+ ## Best Practices
383
+
384
+ 1. **Use the full workflow for complex features**: The 7 phases ensure thorough planning
385
+ 2. **Answer clarifying questions thoughtfully**: Phase 3 prevents future confusion
386
+ 3. **Choose architecture deliberately**: Phase 4 gives you options for a reason
387
+ 4. **Don't skip code review**: Phase 6 catches issues before they reach production
388
+ 5. **Read the suggested files**: Phase 2 identifies key files—read them to understand context
389
+
390
+ ## When to Use This Plugin
391
+
392
+ **Use for:**
393
+
394
+ - New features that touch multiple files
395
+ - Features requiring architectural decisions
396
+ - Complex integrations with existing code
397
+ - Features where requirements are somewhat unclear
398
+
399
+ **Don't use for:**
400
+
401
+ - Single-line bug fixes
402
+ - Trivial changes
403
+ - Well-defined, simple tasks
404
+ - Urgent hotfixes
405
+
406
+ ## Requirements
407
+
408
+ - Claude Code installed
409
+ - Git repository (for code review)
410
+ - Project with existing codebase (workflow assumes existing code to learn from)
411
+
412
+ ## Troubleshooting
413
+
414
+ ### Agents take too long
415
+
416
+ **Issue**: Code exploration or architecture agents are slow
417
+
418
+ **Solution**:
419
+
420
+ - This is normal for large codebases
421
+ - Agents run in parallel when possible
422
+ - The thoroughness pays off in better understanding
423
+
424
+ ### Too many clarifying questions
425
+
426
+ **Issue**: Phase 3 asks too many questions
427
+
428
+ **Solution**:
429
+
430
+ - Be more specific in your initial feature request
431
+ - Provide context about constraints upfront
432
+ - Say "whatever you think is best" if truly no preference
433
+
434
+ ### Architecture options overwhelming
435
+
436
+ **Issue**: Too many architecture options in Phase 4
437
+
438
+ **Solution**:
439
+
440
+ - Trust the recommendation—it's based on codebase analysis
441
+ - If still unsure, ask for more explanation
442
+ - Pick the pragmatic option when in doubt
443
+
444
+ ## Tips
445
+
446
+ - **Be specific in your feature request**: More detail = fewer clarifying questions
447
+ - **Trust the process**: Each phase builds on the previous one
448
+ - **Review agent outputs**: Agents provide valuable insights about your codebase
449
+ - **Don't skip phases**: Each phase serves a purpose
450
+ - **Use for learning**: The exploration phase teaches you about your own codebase
451
+
452
+ ## Author
453
+
454
+ Sid Bidasaria (sbidasaria@anthropic.com)
455
+
456
+ ## Version
457
+
458
+ 1.0.0