npm - superkit-mcp-server - Versions diffs - 1.2.3 → 1.2.4 - Mend

superkit-mcp-server 1.2.3 → 1.2.4

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 (161) hide show

package/ARCHITECTURE.md +102 -102
package/README.md +71 -71
package/SUPERKIT.md +168 -168
package/agents/code-archaeologist.md +106 -106
package/agents/coder.md +90 -90
package/agents/data-engineer.md +28 -28
package/agents/devops-engineer.md +242 -242
package/agents/git-manager.md +203 -203
package/agents/orchestrator.md +420 -420
package/agents/penetration-tester.md +188 -188
package/agents/performance-optimizer.md +187 -187
package/agents/planner.md +270 -270
package/agents/qa-automation-engineer.md +103 -103
package/agents/quant-developer.md +32 -32
package/agents/reviewer.md +100 -100
package/agents/scout.md +222 -222
package/agents/tester.md +274 -274
package/agents/ui-designer.md +208 -208
package/build/tools/sessionManager.js +79 -10
package/build/tools/todoTools.js +39 -39
package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
package/build/tools/validators/__tests__/convertRules.test.js +5 -5
package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
package/build/tools/validators/__tests__/securityScan.test.js +6 -6
package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
package/commands/README.md +122 -122
package/commands/ask.toml +72 -72
package/commands/brainstorm.toml +119 -119
package/commands/chat.toml +77 -77
package/commands/code-preview.toml +37 -37
package/commands/code.toml +28 -28
package/commands/content.toml +200 -200
package/commands/cook.toml +77 -77
package/commands/copywrite.toml +131 -131
package/commands/db.toml +192 -192
package/commands/debug.toml +166 -166
package/commands/design.toml +158 -158
package/commands/dev-rules.toml +14 -14
package/commands/do.toml +117 -117
package/commands/doc-rules.toml +14 -14
package/commands/docs.toml +148 -148
package/commands/fix.toml +440 -440
package/commands/fullstack.toml +175 -175
package/commands/git.toml +235 -235
package/commands/help.toml +84 -84
package/commands/integrate.toml +127 -127
package/commands/journal.toml +136 -136
package/commands/kit-setup.toml +40 -40
package/commands/mcp.toml +183 -183
package/commands/orchestration.toml +15 -15
package/commands/plan.toml +171 -171
package/commands/pm.toml +148 -148
package/commands/pr.toml +50 -50
package/commands/project.toml +32 -32
package/commands/research.toml +117 -117
package/commands/review-pr.toml +63 -63
package/commands/review.toml +190 -190
package/commands/scout-ext.toml +97 -97
package/commands/scout.toml +79 -79
package/commands/screenshot.toml +65 -65
package/commands/session.toml +102 -102
package/commands/skill.toml +384 -384
package/commands/status.toml +22 -22
package/commands/team.toml +56 -56
package/commands/test.toml +164 -164
package/commands/ticket.toml +70 -70
package/commands/use.toml +106 -106
package/commands/video.toml +83 -83
package/commands/watzup.toml +71 -71
package/commands/workflow.toml +14 -14
package/package.json +35 -35
package/skills/meta/README.md +30 -30
package/skills/meta/api-design/SKILL.md +134 -134
package/skills/meta/code-review/SKILL.md +44 -44
package/skills/meta/code-review/checklists/pre-merge.md +25 -25
package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
package/skills/meta/code-review/workflows/performance-pass.md +27 -27
package/skills/meta/code-review/workflows/security-pass.md +29 -29
package/skills/meta/compound-docs/SKILL.md +133 -133
package/skills/meta/debug/SKILL.md +40 -40
package/skills/meta/debug/templates/bug-report.template.md +31 -31
package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
package/skills/meta/docker/SKILL.md +126 -126
package/skills/meta/examples/supabase/SKILL.md +46 -46
package/skills/meta/examples/supabase/references/best-practices.md +319 -319
package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
package/skills/meta/file-todos/SKILL.md +88 -88
package/skills/meta/mobile/SKILL.md +140 -140
package/skills/meta/nextjs/SKILL.md +101 -101
package/skills/meta/performance/SKILL.md +130 -130
package/skills/meta/react-patterns/SKILL.md +83 -83
package/skills/meta/security/SKILL.md +114 -114
package/skills/meta/session-resume/SKILL.md +96 -96
package/skills/meta/tailwind/SKILL.md +139 -139
package/skills/meta/testing/SKILL.md +43 -43
package/skills/meta/testing/references/vitest-patterns.md +45 -45
package/skills/meta/testing/templates/component-test.template.tsx +37 -37
package/skills/tech/alpha-vantage/SKILL.md +142 -142
package/skills/tech/alpha-vantage/references/commodities.md +153 -153
package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
package/skills/tech/alpha-vantage/references/options.md +93 -93
package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
package/skills/tech/alpha-vantage/references/time-series.md +157 -157
package/skills/tech/financial-modeling/SKILL.md +18 -18
package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
package/skills/workflows/README.md +203 -203
package/skills/workflows/adr.md +174 -174
package/skills/workflows/changelog.md +74 -74
package/skills/workflows/compound.md +323 -323
package/skills/workflows/compound_health.md +74 -74
package/skills/workflows/create-agent-skill.md +138 -138
package/skills/workflows/cycle.md +144 -144
package/skills/workflows/deploy-docs.md +84 -84
package/skills/workflows/development-rules.md +42 -42
package/skills/workflows/doc.md +95 -95
package/skills/workflows/documentation-management.md +34 -34
package/skills/workflows/explore.md +146 -146
package/skills/workflows/generate_command.md +106 -106
package/skills/workflows/heal-skill.md +97 -97
package/skills/workflows/housekeeping.md +229 -229
package/skills/workflows/kit-setup.md +102 -102
package/skills/workflows/map-codebase.md +78 -78
package/skills/workflows/orchestration-protocol.md +43 -43
package/skills/workflows/plan-compound.md +439 -439
package/skills/workflows/plan_review.md +269 -269
package/skills/workflows/primary-workflow.md +37 -37
package/skills/workflows/promote_pattern.md +86 -86
package/skills/workflows/release-docs.md +82 -82
package/skills/workflows/report-bug.md +135 -135
package/skills/workflows/reproduce-bug.md +118 -118
package/skills/workflows/resolve_pr.md +133 -133
package/skills/workflows/resolve_todo.md +128 -128
package/skills/workflows/review-compound.md +376 -376
package/skills/workflows/skill-review.md +127 -127
package/skills/workflows/specs.md +257 -257
package/skills/workflows/triage-sprint.md +102 -102
package/skills/workflows/triage.md +152 -152
package/skills/workflows/work.md +399 -399
package/skills/workflows/xcode-test.md +93 -93

package/build/tools/validators/__tests__/convertRules.test.js CHANGED Viewed

@@ -15,11 +15,11 @@ describe('convertRules', () => {
     it('should correctly parse frontmatter and generate rules', async () => {
         vi.mocked(fs.stat).mockResolvedValue({ isDirectory: () => true });
         vi.mocked(fs.readdir).mockResolvedValue(['async-waterfall.md']);
-        vi.mocked(fs.readFile).mockResolvedValue(`---
-title: Waterfall check
-impact: HIGH
-tags: perf
----
+        vi.mocked(fs.readFile).mockResolvedValue(`---
+title: Waterfall check
+impact: HIGH
+tags: perf
+---
 Content body of the rule here.`);
         vi.mocked(fs.mkdir).mockResolvedValue(undefined);
         vi.mocked(fs.writeFile).mockResolvedValue(undefined);

package/build/tools/validators/__tests__/frontendDesign.test.js CHANGED Viewed

@@ -9,20 +9,20 @@ describe('accessibilityChecker', () => {
     });
     describe('checkAccessibility', () => {
         it('should detect input without label and img without alt', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 <input type="text" name="bad" />
-                 <button>Click me</button>
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 <input type="text" name="bad" />
+                 <button>Click me</button>
              `);
             const issues = await checkAccessibility('test.html');
             expect(issues.some(i => i.includes('Input without label'))).toBe(true);
             expect(issues.some(i => i.includes('Missing lang'))).toBe(false); // only checks if <html> exists
         });
         it('should pass good inputs', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 <html lang="en">
-                   <input type="text" aria-label="Good" />
-                   <button aria-label="Close">X</button>
-                 </html>
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 <html lang="en">
+                   <input type="text" aria-label="Good" />
+                   <button aria-label="Close">X</button>
+                 </html>
              `);
             const issues = await checkAccessibility('test.html');
             expect(issues).toEqual([]); // Skip link is only requested if <main> or <body> is present
@@ -39,10 +39,10 @@ describe('uxAudit', () => {
                     name: 'test.tsx',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 <button onClick={() => {}}>Submit</button>
-                 <img src="foo.jpg">
-                 <p style="color: #000000; font-family: purple;">Hello</p>
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 <button onClick={() => {}}>Submit</button>
+                 <img src="foo.jpg">
+                 <p style="color: #000000; font-family: purple;">Hello</p>
              `);
             const res = await runUxAudit('.');
             expect(res.passed).toBe(false);

package/build/tools/validators/__tests__/geoChecker.test.js CHANGED Viewed

@@ -8,21 +8,21 @@ describe('geoChecker', () => {
     });
     describe('checkGeoPage', () => {
         it('should detect structured schema and H1s', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                <html lang="en">
-                <head>
-                <script type="application/ld+json">
-                {
-                  "@type": "Article",
-                  "author": "Test Author"
-                }
-                </script>
-                </head>
-                <body>
-                    <h1>Main Title</h1>
-                    <p>Some content with numbers like 50% and $100.</p>
-                </body>
-                </html>
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                <html lang="en">
+                <head>
+                <script type="application/ld+json">
+                {
+                  "@type": "Article",
+                  "author": "Test Author"
+                }
+                </script>
+                </head>
+                <body>
+                    <h1>Main Title</h1>
+                    <p>Some content with numbers like 50% and $100.</p>
+                </body>
+                </html>
             `);
             const result = await checkGeoPage('/mock/page.html');
             expect(result.passed.some(m => m.includes('JSON-LD structured data'))).toBe(true);
@@ -31,10 +31,10 @@ describe('geoChecker', () => {
             expect(result.score).toBeGreaterThan(0);
         });
         it('should flag missing structural tags', async () => {
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                <body>
-                    <p>No headings, no structure, no stats.</p>
-                </body>
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                <body>
+                    <p>No headings, no structure, no stats.</p>
+                </body>
             `);
             const result = await checkGeoPage('/mock/bad.html');
             expect(result.issues.some(m => m.includes('No JSON-LD'))).toBe(true);

package/build/tools/validators/__tests__/mobileAudit.test.js CHANGED Viewed

@@ -11,16 +11,16 @@ describe('mobileAudit', () => {
                 name: 'Screen.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import React from 'react';
-            import { View, ScrollView } from 'react-native';
-            export const Screen = () => {
-                return (
-                    <ScrollView>
-                       {data.map(d => <View key={index} />)}
-                    </ScrollView>
-                )
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import React from 'react';
+            import { View, ScrollView } from 'react-native';
+            export const Screen = () => {
+                return (
+                    <ScrollView>
+                       {data.map(d => <View key={index} />)}
+                    </ScrollView>
+                )
+            }
         `);
         const res = await runMobileAudit('.');
         expect(res.passed).toBe(false);
@@ -31,8 +31,8 @@ describe('mobileAudit', () => {
                 name: 'regular.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            export const App = () => <div>Hello Web</div>
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            export const App = () => <div>Hello Web</div>
         `);
         const res = await runMobileAudit('.');
         expect(res.passed).toBe(true);

package/build/tools/validators/__tests__/reactPerformanceChecker.test.js CHANGED Viewed

@@ -11,14 +11,14 @@ describe('reactPerformanceChecker', () => {
                 name: 'Home.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import { something } from '@/components/index';
-            async function loadData() {
-                const a = await fetchA();
-                const b = await fetchB();
-                return { a, b };
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import { something } from '@/components/index';
+            async function loadData() {
+                const a = await fetchA();
+                const b = await fetchB();
+                return { a, b };
+            }
         `);
         const res = await runReactPerformanceChecker('.');
         console.log("RPC BAD REPORT:", res.report);
@@ -31,15 +31,15 @@ describe('reactPerformanceChecker', () => {
                 name: 'App.tsx',
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            import { useQuery } from '@tanstack/react-query';
-            import Image from 'next/image';
-            const App = React.memo((props: Props) => {
-                const q = useQuery('data', fetchParallel);
-                return <Image src="foo" alt="bar" />
-            });
-            export default App;
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            import { useQuery } from '@tanstack/react-query';
+            import Image from 'next/image';
+            const App = React.memo((props: Props) => {
+                const q = useQuery('data', fetchParallel);
+                return <Image src="foo" alt="bar" />
+            });
+            export default App;
         `);
         const res = await runReactPerformanceChecker('.');
         console.log("RPC GOOD REPORT:", res.report);

package/build/tools/validators/__tests__/securityScan.test.js CHANGED Viewed

@@ -13,8 +13,8 @@ describe('securityScan', () => {
                     name: 'config.json',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 { "aws_key": "AKIA1234567890123456" }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 { "aws_key": "AKIA1234567890123456" }
              `);
             const result = await scanSecrets('/mock');
             expect(result.findings).toBeDefined();
@@ -28,10 +28,10 @@ describe('securityScan', () => {
                     name: 'bad_code.js',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                 eval('2 + 2');
-                 import { exec } from 'child_process';
-                 child_process.exec('rm -rf /');
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                 eval('2 + 2');
+                 import { exec } from 'child_process';
+                 child_process.exec('rm -rf /');
              `);
             const result = await scanCodePatterns('/mock');
             expect(result.findings.length).toBeGreaterThan(1);

package/build/tools/validators/__tests__/seoChecker.test.js CHANGED Viewed

@@ -11,22 +11,22 @@ describe('seoChecker', () => {
                 name: 'index.tsx', // valid page layout file
                 isDirectory: () => false
             }]);
-        vi.mocked(fs.readFile).mockResolvedValue(`
-            export default function Index() {
-                return (
-                    <html>
-                        <head>
-                            <title>Oops missing description and og</title>
-                        </head>
-                        <body>
-                            <h1>Title</h1>
-                            <h1>Duplicate Title</h1>
-                            <img src="foo" />
-                            <img src="bar" alt="" />
-                        </body>
-                    </html>
-                )
-            }
+        vi.mocked(fs.readFile).mockResolvedValue(`
+            export default function Index() {
+                return (
+                    <html>
+                        <head>
+                            <title>Oops missing description and og</title>
+                        </head>
+                        <body>
+                            <h1>Title</h1>
+                            <h1>Duplicate Title</h1>
+                            <img src="foo" />
+                            <img src="bar" alt="" />
+                        </body>
+                    </html>
+                )
+            }
         `);
         const res = await runSeoChecker('.');
         expect(res.passed).toBe(false);

package/build/tools/validators/__tests__/typeCoverage.test.js CHANGED Viewed

@@ -14,9 +14,9 @@ describe('typeCoverage', () => {
                     isDirectory: () => false
                 }]);
             // Mock readFile to return a snippet with an untyped function and an "any"
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                function test(): any { return 1; }
-                const test2 = (x) => console.log(x);
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                function test(): any { return 1; }
+                const test2 = (x) => console.log(x);
             `);
             const result = await checkTypescriptCoverage('/mock/folder');
             expect(result.type).toBe('typescript');
@@ -29,8 +29,8 @@ describe('typeCoverage', () => {
                     name: 'good.ts',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-                function typedFunc(val: string): number { return val.length; }
+            vi.mocked(fs.readFile).mockResolvedValue(`
+                function typedFunc(val: string): number { return val.length; }
             `);
             const result = await checkTypescriptCoverage('/mock/good');
             expect(result.stats.any_count).toBe(0);
@@ -44,15 +44,15 @@ describe('typeCoverage', () => {
                     name: 'script.py',
                     isDirectory: () => false
                 }]);
-            vi.mocked(fs.readFile).mockResolvedValue(`
-def bad_func(arg):
-    pass
-def good_func(arg: str) -> bool:
-    return True
-def any_func(arg: Any) -> Any:
-    pass
+            vi.mocked(fs.readFile).mockResolvedValue(`
+def bad_func(arg):
+    pass
+def good_func(arg: str) -> bool:
+    return True
+def any_func(arg: Any) -> Any:
+    pass
              `);
             const result = await checkPythonCoverage('/mock/py');
             expect(result.stats.any_count).toBeGreaterThan(0);

package/commands/README.md CHANGED Viewed

@@ -1,122 +1,122 @@
-# Commands
-This directory contains all **custom slash commands** for the Super-Kit extension. Commands are defined as TOML files and automatically loaded by the AI agent client.
-## Overview
-Commands extend Super-Kit's capabilities by providing specialized prompts for specific tasks. Each command file follows the TOML format with `description` and `prompt` fields.
-## Command Categories
-| Category | Commands | Purpose |
-|----------|----------|---------|
-| **Planning** | `plan`, `brainstorm` | Create implementation plans |
-| **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
-| **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
-| **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
-| **Project** | `project`, `pm`, `status` | Project management |
-| **Git** | `git`, `session` | Git and session management |
-| **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
-| **Content** | `content`, `copywrite`, `chat` | Content creation |
-| **Database** | `db` | Database operations |
-| **Design** | `design` | UI/UX design tasks |
-| **Testing** | `test` | Testing and QA |
-| **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
-## Components
-| Component | Purpose | Status |
-|-----------|---------|--------|
-| `ask.toml` | General Q&A with context | ✅ Active |
-| `brainstorm.toml` | Creative ideation | ✅ Active |
-| `chat.toml` | Conversational interactions | ✅ Active |
-| `code.toml` | Code implementation | ✅ Active |
-| `code-preview.toml` | Code preview mode | ✅ Active |
-| `content.toml` | Content creation | ✅ Active |
-| `cook.toml` | Execute plans step-by-step | ✅ Active |
-| `copywrite.toml` | Marketing copy | ✅ Active |
-| `db.toml` | Database operations | ✅ Active |
-| `debug.toml` | Debugging assistance | ✅ Active |
-| `design.toml` | UI/UX design | ✅ Active |
-| `dev-rules.toml` | Development rules loader | ✅ Active |
-| `do.toml` | Quick task execution | ✅ Active |
-| `doc-rules.toml` | Documentation rules | ✅ Active |
-| `docs.toml` | Documentation management | ✅ Active |
-| `fix.toml` | Bug fixing | ✅ Active |
-| `fullstack.toml` | Full-stack development | ✅ Active |
-| `git.toml` | Git operations | ✅ Active |
-| `help.toml` | Help and guidance | ✅ Active |
-| `integrate.toml` | Integration tasks | ✅ Active |
-| `journal.toml` | Session journaling | ✅ Active |
-| `kit-setup.toml` | Project setup wizard | ✅ Active |
-| `mcp.toml` | MCP server management | ✅ Active |
-| `orchestration.toml` | Multi-agent orchestration | ✅ Active |
-| `plan.toml` | Implementation planning | ✅ Active |
-| `pm.toml` | Project management | ✅ Active |
-| `pr.toml` | Pull request creation | ✅ Active |
-| `project.toml` | Project context | ✅ Active |
-| `research.toml` | Research tasks | ✅ Active |
-| `review-pr.toml` | PR review | ✅ Active |
-| `review.toml` | Code review | ✅ Active |
-| `scout-ext.toml` | Extended codebase exploration | ✅ Active |
-| `scout.toml` | Codebase scout | ✅ Active |
-| `screenshot.toml` | Screenshot capture | ✅ Active |
-| `session.toml` | Session management | ✅ Active |
-| `skill.toml` | Skill creation | ✅ Active |
-| `status.toml` | Status reporting | ✅ Active |
-| `team.toml` | Team coordination | ✅ Active |
-| `test.toml` | Testing tasks | ✅ Active |
-| `ticket.toml` | Issue/ticket management | ✅ Active |
-| `use.toml` | Use existing patterns | ✅ Active |
-| `video.toml` | Video processing | ✅ Active |
-| `watzup.toml` | Quick status check | ✅ Active |
-| `workflow.toml` | Workflow management | ✅ Active |
-## TOML Structure
-Each command file follows this structure:
-```toml
-description = "Brief description shown in command list"
-prompt = '''
-# Command Name
-{{args}} - User input passed to the command
-## Instructions
-...
-'''
-```
-### String Types
-- **Basic string** (`"""..."""`): Processes escape sequences
-- **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
-> [!NOTE]
-> Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
-## Usage
-```bash
-# In Gemini CLI
-/command-name [arguments]
-# Examples
-/plan Add user authentication
-/code Implement login form
-/review @src/auth/login.ts
-```
-## Changelog
-### 2026-01-24
-- Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
----
-## References
-- [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
-- [TOML Specification](https://toml.io/en/)
+# Commands
+This directory contains all **custom slash commands** for the Super-Kit extension. Commands are defined as TOML files and automatically loaded by the AI agent client.
+## Overview
+Commands extend Super-Kit's capabilities by providing specialized prompts for specific tasks. Each command file follows the TOML format with `description` and `prompt` fields.
+## Command Categories
+| Category | Commands | Purpose |
+|----------|----------|---------|
+| **Planning** | `plan`, `brainstorm` | Create implementation plans |
+| **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
+| **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
+| **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
+| **Project** | `project`, `pm`, `status` | Project management |
+| **Git** | `git`, `session` | Git and session management |
+| **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
+| **Content** | `content`, `copywrite`, `chat` | Content creation |
+| **Database** | `db` | Database operations |
+| **Design** | `design` | UI/UX design tasks |
+| **Testing** | `test` | Testing and QA |
+| **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
+## Components
+| Component | Purpose | Status |
+|-----------|---------|--------|
+| `ask.toml` | General Q&A with context | ✅ Active |
+| `brainstorm.toml` | Creative ideation | ✅ Active |
+| `chat.toml` | Conversational interactions | ✅ Active |
+| `code.toml` | Code implementation | ✅ Active |
+| `code-preview.toml` | Code preview mode | ✅ Active |
+| `content.toml` | Content creation | ✅ Active |
+| `cook.toml` | Execute plans step-by-step | ✅ Active |
+| `copywrite.toml` | Marketing copy | ✅ Active |
+| `db.toml` | Database operations | ✅ Active |
+| `debug.toml` | Debugging assistance | ✅ Active |
+| `design.toml` | UI/UX design | ✅ Active |
+| `dev-rules.toml` | Development rules loader | ✅ Active |
+| `do.toml` | Quick task execution | ✅ Active |
+| `doc-rules.toml` | Documentation rules | ✅ Active |
+| `docs.toml` | Documentation management | ✅ Active |
+| `fix.toml` | Bug fixing | ✅ Active |
+| `fullstack.toml` | Full-stack development | ✅ Active |
+| `git.toml` | Git operations | ✅ Active |
+| `help.toml` | Help and guidance | ✅ Active |
+| `integrate.toml` | Integration tasks | ✅ Active |
+| `journal.toml` | Session journaling | ✅ Active |
+| `kit-setup.toml` | Project setup wizard | ✅ Active |
+| `mcp.toml` | MCP server management | ✅ Active |
+| `orchestration.toml` | Multi-agent orchestration | ✅ Active |
+| `plan.toml` | Implementation planning | ✅ Active |
+| `pm.toml` | Project management | ✅ Active |
+| `pr.toml` | Pull request creation | ✅ Active |
+| `project.toml` | Project context | ✅ Active |
+| `research.toml` | Research tasks | ✅ Active |
+| `review-pr.toml` | PR review | ✅ Active |
+| `review.toml` | Code review | ✅ Active |
+| `scout-ext.toml` | Extended codebase exploration | ✅ Active |
+| `scout.toml` | Codebase scout | ✅ Active |
+| `screenshot.toml` | Screenshot capture | ✅ Active |
+| `session.toml` | Session management | ✅ Active |
+| `skill.toml` | Skill creation | ✅ Active |
+| `status.toml` | Status reporting | ✅ Active |
+| `team.toml` | Team coordination | ✅ Active |
+| `test.toml` | Testing tasks | ✅ Active |
+| `ticket.toml` | Issue/ticket management | ✅ Active |
+| `use.toml` | Use existing patterns | ✅ Active |
+| `video.toml` | Video processing | ✅ Active |
+| `watzup.toml` | Quick status check | ✅ Active |
+| `workflow.toml` | Workflow management | ✅ Active |
+## TOML Structure
+Each command file follows this structure:
+```toml
+description = "Brief description shown in command list"
+prompt = '''
+# Command Name
+{{args}} - User input passed to the command
+## Instructions
+...
+'''
+```
+### String Types
+- **Basic string** (`"""..."""`): Processes escape sequences
+- **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
+> [!NOTE]
+> Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
+## Usage
+```bash
+# In Gemini CLI
+/command-name [arguments]
+# Examples
+/plan Add user authentication
+/code Implement login form
+/review @src/auth/login.ts
+```
+## Changelog
+### 2026-01-24
+- Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
+---
+## References
+- [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
+- [TOML Specification](https://toml.io/en/)