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.
- package/LICENSE +21 -0
- package/README.md +216 -0
- package/dist/agent.d.ts +9 -0
- package/dist/agent.js +144 -0
- package/dist/agent.js.map +1 -0
- package/dist/config.d.ts +15 -0
- package/dist/config.js +76 -0
- package/dist/config.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +366 -0
- package/dist/index.js.map +1 -0
- package/dist/knowledge-commands.d.ts +2 -0
- package/dist/knowledge-commands.js +40 -0
- package/dist/knowledge-commands.js.map +1 -0
- package/dist/knowledge.d.ts +17 -0
- package/dist/knowledge.js +112 -0
- package/dist/knowledge.js.map +1 -0
- package/dist/memory.d.ts +17 -0
- package/dist/memory.js +215 -0
- package/dist/memory.js.map +1 -0
- package/dist/planner.d.ts +22 -0
- package/dist/planner.js +130 -0
- package/dist/planner.js.map +1 -0
- package/dist/project.d.ts +25 -0
- package/dist/project.js +117 -0
- package/dist/project.js.map +1 -0
- package/dist/rules-commands.d.ts +2 -0
- package/dist/rules-commands.js +51 -0
- package/dist/rules-commands.js.map +1 -0
- package/dist/skills.d.ts +28 -0
- package/dist/skills.js +349 -0
- package/dist/skills.js.map +1 -0
- package/dist/structured/loader.d.ts +19 -0
- package/dist/structured/loader.js +147 -0
- package/dist/structured/loader.js.map +1 -0
- package/dist/structured/paths.d.ts +2 -0
- package/dist/structured/paths.js +14 -0
- package/dist/structured/paths.js.map +1 -0
- package/dist/structured/project-scaffold.d.ts +7 -0
- package/dist/structured/project-scaffold.js +60 -0
- package/dist/structured/project-scaffold.js.map +1 -0
- package/dist/structured/render-markdown.d.ts +37 -0
- package/dist/structured/render-markdown.js +47 -0
- package/dist/structured/render-markdown.js.map +1 -0
- package/dist/structured/render-table.d.ts +1 -0
- package/dist/structured/render-table.js +15 -0
- package/dist/structured/render-table.js.map +1 -0
- package/dist/structured/search.d.ts +10 -0
- package/dist/structured/search.js +104 -0
- package/dist/structured/search.js.map +1 -0
- package/dist/structured/skill-runner.d.ts +15 -0
- package/dist/structured/skill-runner.js +60 -0
- package/dist/structured/skill-runner.js.map +1 -0
- package/dist/structured/types.d.ts +212 -0
- package/dist/structured/types.js +97 -0
- package/dist/structured/types.js.map +1 -0
- package/dist/structured-skills-commands.d.ts +3 -0
- package/dist/structured-skills-commands.js +126 -0
- package/dist/structured-skills-commands.js.map +1 -0
- package/dist/structured-template-commands.d.ts +2 -0
- package/dist/structured-template-commands.js +34 -0
- package/dist/structured-template-commands.js.map +1 -0
- package/dist/tools/index.d.ts +3 -0
- package/dist/tools/index.js +450 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/ui.d.ts +19 -0
- package/dist/ui.js +72 -0
- package/dist/ui.js.map +1 -0
- package/dist/web.d.ts +4 -0
- package/dist/web.js +124 -0
- package/dist/web.js.map +1 -0
- package/knowledge/advanced-patterns.md +70 -0
- package/knowledge/agent-directives.md +74 -0
- package/knowledge/dream.md +36 -0
- package/knowledge/engineering.md +46 -0
- package/knowledge/error-catalog.md +33 -0
- package/knowledge/index.json +170 -0
- package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -0
- package/knowledge/memory/engineering-patterns.md +134 -0
- package/knowledge/memory/feedback_root_structure.md +16 -0
- package/knowledge/memory/project-contexts.md +69 -0
- package/knowledge/memory/tools-and-services.md +85 -0
- package/knowledge/rules/agents.md +62 -0
- package/knowledge/rules/blocking-rules.md +323 -0
- package/knowledge/rules/cache-management.md +379 -0
- package/knowledge/rules/capability-evolution.md +132 -0
- package/knowledge/rules/coding.md +126 -0
- package/knowledge/rules/engineering-workflows.md +225 -0
- package/knowledge/rules/evomap-content-guidelines.md +354 -0
- package/knowledge/rules/evomap-guide.md +224 -0
- package/knowledge/rules/git.md +31 -0
- package/knowledge/rules/hooks.md +106 -0
- package/knowledge/rules/performance.md +101 -0
- package/knowledge/rules/remotion-auto-production.md +1120 -0
- package/knowledge/rules/security.md +46 -0
- package/knowledge/rules/testing.md +32 -0
- package/knowledge/rules/work-mode.md +208 -0
- package/knowledge/rules.md +62 -0
- package/knowledge/skills/Skill_Seekers.md +1722 -0
- package/knowledge/skills/ab-test-setup.md +557 -0
- package/knowledge/skills/agent-sdk-dev.md +238 -0
- package/knowledge/skills/agent-tools.md +136 -0
- package/knowledge/skills/analytics-tracking.md +597 -0
- package/knowledge/skills/artifacts-builder.md +89 -0
- package/knowledge/skills/asana.md +13 -0
- package/knowledge/skills/backend-expert.md +97 -0
- package/knowledge/skills/brand-voice.md +481 -0
- package/knowledge/skills/browser-use.md +419 -0
- package/knowledge/skills/cache-optimization-skill.md +179 -0
- package/knowledge/skills/canvas-design.md +147 -0
- package/knowledge/skills/citation-validator.md +203 -0
- package/knowledge/skills/clangd-lsp.md +52 -0
- package/knowledge/skills/code-review-expert.md +85 -0
- package/knowledge/skills/code-review.md +280 -0
- package/knowledge/skills/code-simplifier.md +13 -0
- package/knowledge/skills/commit-commands.md +258 -0
- package/knowledge/skills/competitor-alternatives.md +795 -0
- package/knowledge/skills/content-atomizer.md +910 -0
- package/knowledge/skills/content-research-writer.md +605 -0
- package/knowledge/skills/context-optimization-suite.md +162 -0
- package/knowledge/skills/context7.md +13 -0
- package/knowledge/skills/copy-editing.md +494 -0
- package/knowledge/skills/copywriting.md +510 -0
- package/knowledge/skills/csharp-lsp.md +40 -0
- package/knowledge/skills/decision-making-framework.md +154 -0
- package/knowledge/skills/developer-growth-analysis.md +335 -0
- package/knowledge/skills/direct-response-copy.md +2336 -0
- package/knowledge/skills/docker-expert.md +229 -0
- package/knowledge/skills/document-skills.md +13 -0
- package/knowledge/skills/documentation-expert.md +126 -0
- package/knowledge/skills/email-sequence.md +1061 -0
- package/knowledge/skills/email-sequences.md +910 -0
- package/knowledge/skills/example-plugin.md +72 -0
- package/knowledge/skills/explanatory-output-style.md +82 -0
- package/knowledge/skills/feature-dev.md +458 -0
- package/knowledge/skills/file-organizer.md +466 -0
- package/knowledge/skills/firebase.disabled.md +13 -0
- package/knowledge/skills/form-cro.md +488 -0
- package/knowledge/skills/free-tool-strategy.md +636 -0
- package/knowledge/skills/frontend-design-offical.md +55 -0
- package/knowledge/skills/frontend-design.md +41 -0
- package/knowledge/skills/frontend-expert.md +93 -0
- package/knowledge/skills/github.md +13 -0
- package/knowledge/skills/gitlab.md +13 -0
- package/knowledge/skills/gopls-lsp.md +32 -0
- package/knowledge/skills/got-controller.md +218 -0
- package/knowledge/skills/greptile.md +72 -0
- package/knowledge/skills/hookify.md +376 -0
- package/knowledge/skills/image-editor.md +189 -0
- package/knowledge/skills/image-enhancer.md +109 -0
- package/knowledge/skills/jdtls-lsp.md +49 -0
- package/knowledge/skills/json-canvas.md +654 -0
- package/knowledge/skills/keyword-research.md +559 -0
- package/knowledge/skills/kotlin-lsp.md +28 -0
- package/knowledge/skills/laravel-boost.md +13 -0
- package/knowledge/skills/launch-strategy.md +394 -0
- package/knowledge/skills/lead-magnet.md +393 -0
- package/knowledge/skills/learning-output-style.md +106 -0
- package/knowledge/skills/linear.md +13 -0
- package/knowledge/skills/lua-lsp.md +47 -0
- package/knowledge/skills/marketing-ideas.md +720 -0
- package/knowledge/skills/marketing-psychology.md +534 -0
- package/knowledge/skills/mcp-builder.md +369 -0
- package/knowledge/skills/meeting-insights-analyzer.md +347 -0
- package/knowledge/skills/memory-evolution-system.md +172 -0
- package/knowledge/skills/multi-lens-thinking.md +407 -0
- package/knowledge/skills/nano-banana-pro.md +116 -0
- package/knowledge/skills/newsletter.md +736 -0
- package/knowledge/skills/notebooklm.md +296 -0
- package/knowledge/skills/obsidian-bases.md +634 -0
- package/knowledge/skills/obsidian-markdown.md +651 -0
- package/knowledge/skills/onboarding-cro.md +494 -0
- package/knowledge/skills/orchestrator.md +681 -0
- package/knowledge/skills/page-cro.md +379 -0
- package/knowledge/skills/paid-ads.md +624 -0
- package/knowledge/skills/paywall-upgrade-cro.md +651 -0
- package/knowledge/skills/php-lsp.md +36 -0
- package/knowledge/skills/planning-with-files.md +193 -0
- package/knowledge/skills/playwright.md +13 -0
- package/knowledge/skills/plugin-dev.md +434 -0
- package/knowledge/skills/popup-cro.md +520 -0
- package/knowledge/skills/positioning-angles.md +330 -0
- package/knowledge/skills/pr-review-toolkit.md +359 -0
- package/knowledge/skills/pricing-strategy.md +777 -0
- package/knowledge/skills/programmatic-seo.md +714 -0
- package/knowledge/skills/pyright-lsp.md +43 -0
- package/knowledge/skills/quality-assurance-framework.md +168 -0
- package/knowledge/skills/question-refiner.md +160 -0
- package/knowledge/skills/ralph-loop.md +205 -0
- package/knowledge/skills/refactoring-expert.md +103 -0
- package/knowledge/skills/referral-program.md +668 -0
- package/knowledge/skills/research-executor.md +164 -0
- package/knowledge/skills/review-with-security.md +12 -0
- package/knowledge/skills/rust-analyzer-lsp.md +50 -0
- package/knowledge/skills/schema-markup.md +647 -0
- package/knowledge/skills/security-audit-expert.md +124 -0
- package/knowledge/skills/security-expert.md +140 -0
- package/knowledge/skills/security-guidance.md +13 -0
- package/knowledge/skills/seedance-prompt.md +139 -0
- package/knowledge/skills/self-evolution.md +1160 -0
- package/knowledge/skills/seo-audit.md +432 -0
- package/knowledge/skills/seo-content.md +787 -0
- package/knowledge/skills/serena.md +13 -0
- package/knowledge/skills/signup-flow-cro.md +409 -0
- package/knowledge/skills/skill-creator.md +220 -0
- package/knowledge/skills/skill-manager.md +226 -0
- package/knowledge/skills/skill-share.md +98 -0
- package/knowledge/skills/slack.md +13 -0
- package/knowledge/skills/social-content.md +878 -0
- package/knowledge/skills/spec-flow-skill.md +124 -0
- package/knowledge/skills/stripe.md +13 -0
- package/knowledge/skills/supabase.md +13 -0
- package/knowledge/skills/swift-lsp.md +40 -0
- package/knowledge/skills/synthesizer.md +236 -0
- package/knowledge/skills/template-skill.md +16 -0
- package/knowledge/skills/testing-expert.md +99 -0
- package/knowledge/skills/theme-factory.md +72 -0
- package/knowledge/skills/tiktok-research.md +208 -0
- package/knowledge/skills/typescript-lsp.md +36 -0
- package/knowledge/skills/ui-ux-pro-max.md +247 -0
- package/knowledge/skills/verify.md +15 -0
- package/knowledge/skills/visual-prompt-engineer.md +102 -0
- package/knowledge/skills/webapp-testing.md +111 -0
- package/knowledge/skills/wide-research.md +191 -0
- package/knowledge/system.md +93 -0
- package/knowledge/task-router.md +37 -0
- package/knowledge/verification.md +38 -0
- package/knowledge/workflows/3d-viz.md +47 -0
- package/knowledge/workflows/data-pipeline.md +47 -0
- package/knowledge/workflows/db-migration.md +51 -0
- package/knowledge/workflows/feature-dev.md +41 -0
- package/knowledge/workflows/tdd-flow.md +52 -0
- package/knowledge/workflows/ui-verify.md +51 -0
- 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
|