cokit-cli 1.0.7 → 1.0.9

package/README.md

@@ -1,171 +1,92 @@
-# CoKit
-
-Make GitHub Copilot smarter in 30 seconds.
-
-CoKit provides 15 agents, 64 prompts, 7 instructions, 27 skills, and 6 collections to supercharge your Copilot experience.
-
-## Quick Start
-
-```bash
-npx cokit-cli init -g
-```
-
-This installs all CoKit resources to `~/.copilot/` for global use.
-
-## Installation Options
-
-| Command | Description |
-|---------|-------------|
-| `npx cokit-cli init` | Interactive setup |
-| `npx cokit-cli init -g` | Install global resources only |
-| `npx cokit-cli init -a` | Install both project and global resources |
-
-## Resources
-
-## Agents
-
-| Agent | Description |
-|-------|-------------|
-| [brainstormer](agents/brainstormer.agent.md) | >-. |
-| [code-reviewer](agents/code-reviewer.agent.md) |  |
-| [database-admin](agents/database-admin.agent.md) |  |
-| [debugger](agents/debugger.agent.md) |  |
-| [docs-manager](agents/docs-manager.agent.md) |  |
-| [fullstack-developer](agents/fullstack-developer.agent.md) |  |
-| [git-manager](agents/git-manager.agent.md) | Stage, commit, and push code changes with conventional commits. |
-| [mcp-manager](agents/mcp-manager.agent.md) | Manage MCP (Model Context Protocol) server integrations - discover tools/prompts/resources, analyze ... |
-| [planner](agents/planner.agent.md) |  |
-| [project-manager](agents/project-manager.agent.md) | Use this agent when you need comprehensive project oversight and coordination. |
-| [researcher](agents/researcher.agent.md) |  |
-| [scout-external](agents/scout-external.agent.md) |  |
-| [scout](agents/scout.agent.md) |  |
-| [tester](agents/tester.agent.md) | Use this agent when you need to validate code quality through testing, including running unit and in... |
-| [ui-ux-designer](agents/ui-ux-designer.agent.md) |  |
-
-## Prompts
-
-| Prompt | Description |
-|--------|-------------|
-| [ck-ask](prompts/ck-ask.prompt.md) | Answer technical and architectural questions. |
-| [ck-bootstrap-auto-fast](prompts/ck-bootstrap-auto-fast.prompt.md) |  |
-| [ck-bootstrap-auto-parallel](prompts/ck-bootstrap-auto-parallel.prompt.md) |  |
-| [ck-bootstrap-auto](prompts/ck-bootstrap-auto.prompt.md) |  |
-| [ck-bootstrap](prompts/ck-bootstrap.prompt.md) |  |
-| [ck-brainstorm](prompts/ck-brainstorm.prompt.md) |  |
-| [ck-ck-help](prompts/ck-ck-help.prompt.md) |  |
-| [ck-code-auto](prompts/ck-code-auto.prompt.md) |  |
-| [ck-code-no-test](prompts/ck-code-no-test.prompt.md) |  |
-| [ck-code-parallel](prompts/ck-code-parallel.prompt.md) |  |
-| [ck-code](prompts/ck-code.prompt.md) |  |
-| [ck-coding-level](prompts/ck-coding-level.prompt.md) | Set your coding experience level for tailored explanations and output format. |
-| [ck-cook-auto-fast](prompts/ck-cook-auto-fast.prompt.md) |  |
-| [ck-cook-auto-parallel](prompts/ck-cook-auto-parallel.prompt.md) |  |
-| [ck-cook-auto](prompts/ck-cook-auto.prompt.md) |  |
-| [ck-cook](prompts/ck-cook.prompt.md) |  |
-| [ck-debug](prompts/ck-debug.prompt.md) |  |
-| [ck-design-3d](prompts/ck-design-3d.prompt.md) |  |
-| [ck-design-describe](prompts/ck-design-describe.prompt.md) |  |
-| [ck-design-fast](prompts/ck-design-fast.prompt.md) |  |
-| [ck-design-good](prompts/ck-design-good.prompt.md) |  |
-| [ck-design-screenshot](prompts/ck-design-screenshot.prompt.md) |  |
-| [ck-design-video](prompts/ck-design-video.prompt.md) |  |
-| [ck-docs-init](prompts/ck-docs-init.prompt.md) |  |
-| [ck-docs-summarize](prompts/ck-docs-summarize.prompt.md) |  |
-| [ck-docs-update](prompts/ck-docs-update.prompt.md) |  |
-| [ck-fix-ci](prompts/ck-fix-ci.prompt.md) |  |
-| [ck-fix-fast](prompts/ck-fix-fast.prompt.md) |  |
-| [ck-fix-hard](prompts/ck-fix-hard.prompt.md) |  |
-| [ck-fix-logs](prompts/ck-fix-logs.prompt.md) |  |
-| [ck-fix-parallel](prompts/ck-fix-parallel.prompt.md) |  |
-| [ck-fix-test](prompts/ck-fix-test.prompt.md) |  |
-| [ck-fix-types](prompts/ck-fix-types.prompt.md) | Fix type errors |
-| [ck-fix-ui](prompts/ck-fix-ui.prompt.md) |  |
-| [ck-fix](prompts/ck-fix.prompt.md) |  |
-| [ck-git-cm](prompts/ck-git-cm.prompt.md) |  |
-| [ck-git-cp](prompts/ck-git-cp.prompt.md) |  |
-| [ck-git-merge](prompts/ck-git-merge.prompt.md) | ⚠️ Merge code from one branch to another |
-| [ck-git-pr](prompts/ck-git-pr.prompt.md) | Create a pull request |
-| [ck-kanban](prompts/ck-kanban.prompt.md) |  |
-| [ck-plan-archive](prompts/ck-plan-archive.prompt.md) |  |
-| [ck-plan-ci](prompts/ck-plan-ci.prompt.md) |  |
-| [ck-plan-cro](prompts/ck-plan-cro.prompt.md) |  |
-| [ck-plan-fast](prompts/ck-plan-fast.prompt.md) |  |
-| [ck-plan-hard](prompts/ck-plan-hard.prompt.md) |  |
-| [ck-plan-parallel](prompts/ck-plan-parallel.prompt.md) |  |
-| [ck-plan-two](prompts/ck-plan-two.prompt.md) |  |
-| [ck-plan-validate](prompts/ck-plan-validate.prompt.md) |  |
-| [ck-plan](prompts/ck-plan.prompt.md) |  |
-| [ck-preview](prompts/ck-preview.prompt.md) |  |
-| [ck-review-codebase](prompts/ck-review-codebase.prompt.md) |  |
-| [ck-scout-ext](prompts/ck-scout-ext.prompt.md) |  |
-| [ck-scout](prompts/ck-scout.prompt.md) |  |
-| [ck-skill-add](prompts/ck-skill-add.prompt.md) |  |
-| [ck-skill-create](prompts/ck-skill-create.prompt.md) |  |
-| [ck-skill-fix-logs](prompts/ck-skill-fix-logs.prompt.md) |  |
-| [ck-skill-optimize-auto](prompts/ck-skill-optimize-auto.prompt.md) |  |
-| [ck-skill-optimize](prompts/ck-skill-optimize.prompt.md) |  |
-| [ck-skill-plan](prompts/ck-skill-plan.prompt.md) |  |
-| [ck-test-ui](prompts/ck-test-ui.prompt.md) |  |
-| [ck-test](prompts/ck-test.prompt.md) |  |
-| [ck-use-mcp](prompts/ck-use-mcp.prompt.md) |  |
-| [ck-watzup](prompts/ck-watzup.prompt.md) | Review recent changes and wrap up the work |
-| [ck-worktree](prompts/ck-worktree.prompt.md) | Create isolated git worktree for parallel development |
-
-## Instructions
-
-| Instruction | ApplyTo | Description |
-|-------------|---------|-------------|
-| [ck-backend](instructions/ck-backend.instructions.md) | `**/*.py, *.go, *.rs, *.java, *.cs, api/**` | Backend development rules |
-| [ck-development](instructions/ck-development.instructions.md) | `**/*` | YAGNI/KISS/DRY principles |
-| [ck-frontend](instructions/ck-frontend.instructions.md) | `**/*.tsx, *.jsx, *.vue, *.svelte, components/**` | Frontend component guidelines |
-| [ck-frontend-design-pro](instructions/ck-frontend-design-pro.instructions.md) | `**/*.tsx, *.jsx, *.css` | Production-ready frontend with perfect images |
-| [ck-google-adk-python](instructions/ck-google-adk-python.instructions.md) | `**/*` | Google ADK Python guidelines |
-| [ck-research](instructions/ck-research.instructions.md) | `*` | Research guidelines |
-| [ck-testing](instructions/ck-testing.instructions.md) | `**/*.test.*, *.spec.*, test_*.py, *_test.go` | Testing standards |
-
-## Skills
-
-| Skill | Description |
-|-------|-------------|
-| [ck-ai-artist](skills/ck-ai-artist/SKILL.md) | Write and optimize prompts for AI-generated outcomes across text and image models. Use when crafting... |
-| [ck-backend-development](skills/ck-backend-development/SKILL.md) | Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJ... |
-| [ck-better-auth](skills/ck-better-auth/SKILL.md) | Implement authentication and authorization with Better Auth - a framework-agnostic TypeScript authen... |
-| [ck-chrome-devtools](skills/ck-chrome-devtools/SKILL.md) | Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automat... |
-| [ck-code-review](skills/ck-code-review/SKILL.md) | Use when receiving code review feedback (especially if unclear or technically questionable), when co... |
-| [ck-databases](skills/ck-databases/SKILL.md) | Work with MongoDB (document database, BSON documents, aggregation pipelines, Atlas cloud) and Postgr... |
-| [ck-debugging](skills/ck-debugging/SKILL.md) | Systematic debugging framework ensuring root cause investigation before fixes. Includes four-phase d... |
-| [ck-devops](skills/ck-devops/SKILL.md) | Deploy and manage cloud infrastructure on Cloudflare (Workers, R2, D1, KV, Pages, Durable Objects, B... |
-| [ck-docs-seeker](skills/ck-docs-seeker/SKILL.md) | Search technical documentation using executable scripts to detect query type, fetch from llms.txt so... |
-| [ck-frontend-design](skills/ck-frontend-design/SKILL.md) | Create distinctive, production-grade frontend interfaces with high design quality. Use when building... |
-| [ck-frontend-development](skills/ck-frontend-development/SKILL.md) | Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspens... |
-| [ck-markdown-novel-viewer](skills/ck-markdown-novel-viewer/SKILL.md) | Render markdown files with calm, book-like reading experience via background HTTP server. Features n... |
-| [ck-mcp-builder](skills/ck-mcp-builder/SKILL.md) | Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact wi... |
-| [ck-mcp-management](skills/ck-mcp-management/SKILL.md) | Manage Model Context Protocol (MCP) servers - discover, analyze, and execute tools/prompts/resources... |
-| [ck-media-processing](skills/ck-media-processing/SKILL.md) | Process multimedia files with FFmpeg (video/audio encoding, conversion, streaming, filtering, hardwa... |
-| [ck-mobile-development](skills/ck-mobile-development/SKILL.md) | Build modern mobile applications with React Native, Flutter, Swift/SwiftUI, and Kotlin/Jetpack Compo... |
-| [ck-payment-integration](skills/ck-payment-integration/SKILL.md) | Implement payment integrations with SePay (Vietnamese payment gateway with VietQR, bank transfers, c... |
-| [ck-planning](skills/ck-planning/SKILL.md) | Use when you need to plan technical solutions that are scalable, secure, and maintainable. |
-| [ck-problem-solving](skills/ck-problem-solving/SKILL.md) | Apply systematic problem-solving techniques for complexity spirals (simplification cascades), innova... |
-| [ck-repomix](skills/ck-repomix/SKILL.md) | Package entire code repositories into single AI-friendly files using Repomix. Capabilities include p... |
-| [ck-sequential-thinking](skills/ck-sequential-thinking/SKILL.md) | Apply structured, reflective problem-solving for complex tasks requiring multi-step analysis, revisi... |
-| [ck-shopify](skills/ck-shopify/SKILL.md) | Build Shopify applications, extensions, and themes using GraphQL/REST APIs, Shopify CLI, Polaris UI ... |
-| [ck-skill-creator](skills/ck-skill-creator/SKILL.md) | Guide for creating effective skills, adding skill references, skill scripts or optimizing existing s... |
-| [ck-threejs](skills/ck-threejs/SKILL.md) | Build immersive 3D web experiences with Three.js - WebGL/WebGPU library for scenes, cameras, geometr... |
-| [ck-ui-styling](skills/ck-ui-styling/SKILL.md) | Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind... |
-| [ck-ui-ux-pro-max](skills/ck-ui-ux-pro-max/SKILL.md) | Frontend UI/UX design intelligence - activate FIRST when user requests beautiful, stunning, or aesth... |
-| [ck-web-frameworks](skills/ck-web-frameworks/SKILL.md) | Build modern full-stack web applications with Next.js (App Router, Server Components, RSC, PPR, SSR,... |
-
-## Collections
-
-| Collection | Description |
-|------------|-------------|
-| [CK Core Workflows](collections/ck-core.collection.yml) | Core CoKit workflows combining all essential agents, prompts, and skills for full-stack development ... |
-| [CK Development Rules](collections/ck-development-rules.collection.yml) | Essential development rules and best practices including YAGNI, KISS, DRY principles, file naming, c... |
-| [CK Documentation Management](collections/ck-documentation.collection.yml) | Documentation management workflows for maintaining project docs, codebase summaries, design guidelin... |
-| [CK Git Workflow](collections/ck-git-workflow.collection.yml) | Git workflow automation including commit, push, merge, and pull request management. |
-| [CK Orchestration Protocol](collections/ck-orchestration.collection.yml) | Workflow orchestration patterns for managing subagents, task delegation, and multi-phase implementat... |
-| [CK UI/UX Design](collections/ck-ui-design.collection.yml) | UI/UX design workflows with frontend development, styling, multimodal AI for image generation, and d... |
-
-## License
-
-CC BY-NC 4.0 - See [LICENSE](LICENSE) for details.
+# CoKit
+
+Make GitHub Copilot smarter in 30 seconds.
+
+CoKit provides 9 agents, 14 prompts, 5 instructions, 7 skills, and 5 collections to supercharge your Copilot experience.
+
+## Quick Start
+
+```bash
+npx cokit-cli init -g
+```
+
+This installs all CoKit resources to `~/.copilot/` for global use.
+
+## Installation Options
+
+| Command | Description |
+|---------|-------------|
+| `npx cokit-cli init` | Interactive setup |
+| `npx cokit-cli init -g` | Install global resources only |
+| `npx cokit-cli init -a` | Install both project and global resources |
+
+## Resources
+
+## Agents
+
+| Agent | Description |
+|-------|-------------|
+| [brainstormer](agents/brainstormer.agent.md) | Brainstorm software solutions, evaluate architectural approaches, debate technical decisions. |
+| [code-reviewer](agents/code-reviewer.agent.md) | Comprehensive code review and quality assessment. |
+| [debugger](agents/debugger.agent.md) | Investigate issues, analyze system behavior, diagnose performance problems, collect and analyze logs. |
+| [docs-manager](agents/docs-manager.agent.md) | Manage technical documentation, implementation standards, update docs based on code changes. |
+| [git-manager](agents/git-manager.agent.md) | Stage, commit, and push code changes with conventional commits. |
+| [planner](agents/planner.agent.md) | Research, analyze, and create comprehensive implementation plans for features and architectures. |
+| [researcher](agents/researcher.agent.md) | Conduct comprehensive research on software topics, investigate technologies, find documentation. |
+| [scout](agents/scout.agent.md) | Quickly locate relevant files across a large codebase to complete a specific task. |
+| [tester](agents/tester.agent.md) | Validate code quality through testing - unit, integration, coverage, error handling, performance. |
+
+## Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| [ck-ask](prompts/ck-ask.prompt.md) | Answer technical and architectural questions. |
+| [ck-bootstrap](prompts/ck-bootstrap.prompt.md) | Bootstrap a new project step by step |
+| [ck-brainstorm](prompts/ck-brainstorm.prompt.md) | Brainstorm a feature |
+| [ck-ck-help](prompts/ck-ck-help.prompt.md) | CoKit usage guide - just type naturally |
+| [ck-code](prompts/ck-code.prompt.md) | Start coding & testing an existing plan |
+| [ck-cook](prompts/ck-cook.prompt.md) | Implement a feature [step by step] |
+| [ck-debug](prompts/ck-debug.prompt.md) | Debugging technical issues and providing solutions |
+| [ck-docs](prompts/ck-docs.prompt.md) | Documentation workflow - init, summarize, or update docs |
+| [ck-fix](prompts/ck-fix.prompt.md) | Analyze and fix issues [INTELLIGENT ROUTING] |
+| [ck-git](prompts/ck-git.prompt.md) | Git workflow - commit, push, merge, or create PR |
+| [ck-plan](prompts/ck-plan.prompt.md) | Intelligent plan creation with prompt enhancement |
+| [ck-review-codebase](prompts/ck-review-codebase.prompt.md) | Scan & analyze the codebase |
+| [ck-scout](prompts/ck-scout.prompt.md) | Scout given directories to respond to the user's requests |
+| [ck-test](prompts/ck-test.prompt.md) | Run tests locally and analyze the summary report |
+
+## Instructions
+
+| Instruction | ApplyTo | Description |
+|-------------|---------|-------------|
+| [ck-backend](instructions/ck-backend.instructions.md) | `**/*.py, *.go, *.rs, *.java, *.cs, api/**` | Backend development rules |
+| [ck-development](instructions/ck-development.instructions.md) | `**/*` | YAGNI/KISS/DRY principles |
+| [ck-frontend](instructions/ck-frontend.instructions.md) | `**/*.tsx, *.jsx, *.vue, *.svelte, components/**` | Frontend component guidelines |
+| [ck-research](instructions/ck-research.instructions.md) | `*` | Research guidelines |
+| [ck-testing](instructions/ck-testing.instructions.md) | `**/*.test.*, *.spec.*, test_*.py, *_test.go` | Testing standards |
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| [ck-backend-development](skills/ck-backend-development/SKILL.md) | Build robust backend systems with modern technologies (Node.js, Python, Go, Rust), frameworks (NestJ... |
+| [ck-code-review](skills/ck-code-review/SKILL.md) | Use when receiving code review feedback (especially if unclear or technically questionable), when co... |
+| [ck-debugging](skills/ck-debugging/SKILL.md) | Systematic debugging framework ensuring root cause investigation before fixes. Includes four-phase d... |
+| [ck-frontend-development](skills/ck-frontend-development/SKILL.md) | Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspens... |
+| [ck-planning](skills/ck-planning/SKILL.md) | Use when you need to plan technical solutions that are scalable, secure, and maintainable. |
+| [ck-problem-solving](skills/ck-problem-solving/SKILL.md) | Apply systematic problem-solving techniques for complexity spirals (simplification cascades), innova... |
+| [ck-sequential-thinking](skills/ck-sequential-thinking/SKILL.md) | Apply structured, reflective problem-solving for complex tasks requiring multi-step analysis, revisi... |
+
+## Collections
+
+| Collection | Description |
+|------------|-------------|
+| [CK Core Workflows](collections/ck-core.collection.yml) | Core CoKit workflows combining all essential agents, prompts, and skills for full-stack development ... |
+| [CK Development Rules](collections/ck-development-rules.collection.yml) | Essential development rules and best practices including YAGNI, KISS, DRY principles, file naming, c... |
+| [CK Documentation Management](collections/ck-documentation.collection.yml) | Documentation management workflows for maintaining project docs, codebase summaries, design guidelin... |
+| [CK Git Workflow](collections/ck-git-workflow.collection.yml) | Git workflow automation including commit, push, merge, and pull request management. |
+| [CK Orchestration Protocol](collections/ck-orchestration.collection.yml) | Workflow orchestration patterns for managing subagents, task delegation, and multi-phase implementat... |
+
+## License
+
+CC BY-NC 4.0 - See [LICENSE](LICENSE) for details.

package/agents/brainstormer.agent.md

@@ -1,71 +1,71 @@
----
-description: 'Brainstorm software solutions, evaluate architectural approaches, debate technical decisions.'
-tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
----
-
-# Brainstormer Agent
-
-You are a Solution Brainstormer, an elite software engineering expert who specializes in system architecture design and technical decision-making. Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs.
-
-**IMPORTANT**: Ensure token efficiency while maintaining high quality.
-
-## Communication Style
-If coding level guidelines were injected at session start (levels 0-5), follow those guidelines for response structure and explanation depth. The guidelines define what to explain, what not to explain, and required response format.
-
-## Core Principles
-You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
-
-## Your Expertise
-- System architecture design and scalability patterns
-- Risk assessment and mitigation strategies
-- Development time optimization and resource allocation
-- User Experience (UX) and Developer Experience (DX) optimization
-- Technical debt management and maintainability
-- Performance optimization and bottleneck identification
-
-## Your Approach
-1. **Question Everything**: Ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
-
-2. **Brutal Honesty**: Provide frank, unfiltered feedback about ideas. If something is unrealistic, over-engineered, or likely to cause problems, say so directly. Your job is to prevent costly mistakes.
-
-3. **Explore Alternatives**: Always consider multiple approaches. Present 2-3 viable solutions with clear pros/cons, explaining why one might be superior.
-
-4. **Challenge Assumptions**: Question the user's initial approach. Often the best solution is different from what was originally envisioned.
-
-5. **Consider All Stakeholders**: Evaluate impact on end users, developers, operations team, and business objectives.
-
-## Collaboration Tools
-- Consult the `planner` agent to research industry best practices and find proven solutions
-- Engage the `docs-manager` agent to understand existing project implementation and constraints
-- Use `WebSearch` tool to find efficient approaches and learn from others' experiences
-
-## Workflow Phases
-1. **Discovery Phase**: Ask clarifying questions about requirements, constraints, timeline, and success criteria
-2. **Research Phase**: Gather information from other agents and external sources
-3. **Analysis Phase**: Evaluate multiple approaches using your expertise and principles
-4. **Debate Phase**: Present options, challenge user preferences, and work toward the optimal solution
-5. **Consensus Phase**: Ensure alignment on the chosen approach and document decisions
-6. **Documentation Phase**: Create a comprehensive markdown summary report with the final agreed solution
-
-## Report Output
-
-Save reports to `plans/reports/` directory with naming pattern `{type}-{date}-{slug}.md`.
-
-### Report Content
-When brainstorming concludes with agreement, create a detailed markdown summary report including:
-- Problem statement and requirements
-- Evaluated approaches with pros/cons
-- Final recommended solution with rationale
-- Implementation considerations and risks
-- Success metrics and validation criteria
-- Next steps and dependencies
-
-## Critical Constraints
-- You DO NOT implement solutions yourself - you only brainstorm and advise
-- You must validate feasibility before endorsing any approach
-- You prioritize long-term maintainability over short-term convenience
-- You consider both technical excellence and business pragmatism
-
-**Remember:** Your role is to be the user's most trusted technical advisor - someone who will tell them hard truths to ensure they build something great, maintainable, and successful.
-
-**IMPORTANT:** **DO NOT** implement anything, just brainstorm, answer questions and advise.
+---
+description: 'Brainstorm software solutions, evaluate architectural approaches, debate technical decisions.'
+tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
+---
+
+# Brainstormer Agent
+
+You are a Solution Brainstormer, an elite software engineering expert who specializes in system architecture design and technical decision-making. Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs.
+
+**IMPORTANT**: Ensure token efficiency while maintaining high quality.
+
+## Communication Style
+If coding level guidelines were injected at session start (levels 0-5), follow those guidelines for response structure and explanation depth. The guidelines define what to explain, what not to explain, and required response format.
+
+## Core Principles
+You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
+
+## Your Expertise
+- System architecture design and scalability patterns
+- Risk assessment and mitigation strategies
+- Development time optimization and resource allocation
+- User Experience (UX) and Developer Experience (DX) optimization
+- Technical debt management and maintainability
+- Performance optimization and bottleneck identification
+
+## Your Approach
+1. **Question Everything**: Ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
+
+2. **Brutal Honesty**: Provide frank, unfiltered feedback about ideas. If something is unrealistic, over-engineered, or likely to cause problems, say so directly. Your job is to prevent costly mistakes.
+
+3. **Explore Alternatives**: Always consider multiple approaches. Present 2-3 viable solutions with clear pros/cons, explaining why one might be superior.
+
+4. **Challenge Assumptions**: Question the user's initial approach. Often the best solution is different from what was originally envisioned.
+
+5. **Consider All Stakeholders**: Evaluate impact on end users, developers, operations team, and business objectives.
+
+## Collaboration Tools
+- Consult the `planner` agent to research industry best practices and find proven solutions
+- Engage the `docs-manager` agent to understand existing project implementation and constraints
+- Use `WebSearch` tool to find efficient approaches and learn from others' experiences
+
+## Workflow Phases
+1. **Discovery Phase**: Ask clarifying questions about requirements, constraints, timeline, and success criteria
+2. **Research Phase**: Gather information from other agents and external sources
+3. **Analysis Phase**: Evaluate multiple approaches using your expertise and principles
+4. **Debate Phase**: Present options, challenge user preferences, and work toward the optimal solution
+5. **Consensus Phase**: Ensure alignment on the chosen approach and document decisions
+6. **Documentation Phase**: Create a comprehensive markdown summary report with the final agreed solution
+
+## Report Output
+
+Save reports to `plans/reports/` directory with naming pattern `{type}-{date}-{slug}.md`.
+
+### Report Content
+When brainstorming concludes with agreement, create a detailed markdown summary report including:
+- Problem statement and requirements
+- Evaluated approaches with pros/cons
+- Final recommended solution with rationale
+- Implementation considerations and risks
+- Success metrics and validation criteria
+- Next steps and dependencies
+
+## Critical Constraints
+- You DO NOT implement solutions yourself - you only brainstorm and advise
+- You must validate feasibility before endorsing any approach
+- You prioritize long-term maintainability over short-term convenience
+- You consider both technical excellence and business pragmatism
+
+**Remember:** Your role is to be the user's most trusted technical advisor - someone who will tell them hard truths to ensure they build something great, maintainable, and successful.
+
+**IMPORTANT:** **DO NOT** implement anything, just brainstorm, answer questions and advise.