superkit-mcp-server 1.2.4 → 1.2.5

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
  1. package/ARCHITECTURE.md +102 -102
  2. package/README.md +71 -71
  3. package/SUPERKIT.md +168 -168
  4. package/agents/code-archaeologist.md +106 -106
  5. package/agents/coder.md +90 -90
  6. package/agents/data-engineer.md +28 -28
  7. package/agents/devops-engineer.md +242 -242
  8. package/agents/git-manager.md +203 -203
  9. package/agents/orchestrator.md +420 -420
  10. package/agents/penetration-tester.md +188 -188
  11. package/agents/performance-optimizer.md +187 -187
  12. package/agents/planner.md +270 -270
  13. package/agents/qa-automation-engineer.md +103 -103
  14. package/agents/quant-developer.md +32 -32
  15. package/agents/reviewer.md +100 -100
  16. package/agents/scout.md +222 -222
  17. package/agents/tester.md +274 -274
  18. package/agents/ui-designer.md +208 -208
  19. package/build/index.js +88 -45
  20. package/build/tools/todoTools.js +39 -39
  21. package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
  22. package/build/tools/validators/__tests__/convertRules.test.js +5 -5
  23. package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
  24. package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
  25. package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
  26. package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
  27. package/build/tools/validators/__tests__/securityScan.test.js +6 -6
  28. package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
  29. package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
  30. package/commands/README.md +122 -122
  31. package/commands/ask.toml +72 -72
  32. package/commands/brainstorm.toml +119 -119
  33. package/commands/chat.toml +77 -77
  34. package/commands/code-preview.toml +37 -37
  35. package/commands/code.toml +28 -28
  36. package/commands/content.toml +200 -200
  37. package/commands/cook.toml +77 -77
  38. package/commands/copywrite.toml +131 -131
  39. package/commands/db.toml +192 -192
  40. package/commands/debug.toml +166 -166
  41. package/commands/design.toml +158 -158
  42. package/commands/dev-rules.toml +14 -14
  43. package/commands/do.toml +117 -117
  44. package/commands/doc-rules.toml +14 -14
  45. package/commands/docs.toml +148 -148
  46. package/commands/fix.toml +440 -440
  47. package/commands/fullstack.toml +175 -175
  48. package/commands/git.toml +235 -235
  49. package/commands/help.toml +84 -84
  50. package/commands/integrate.toml +127 -127
  51. package/commands/journal.toml +136 -136
  52. package/commands/kit-setup.toml +40 -40
  53. package/commands/mcp.toml +183 -183
  54. package/commands/orchestration.toml +15 -15
  55. package/commands/plan.toml +206 -172
  56. package/commands/pm.toml +148 -148
  57. package/commands/pr.toml +50 -50
  58. package/commands/project.toml +32 -32
  59. package/commands/research.toml +117 -117
  60. package/commands/review-pr.toml +63 -63
  61. package/commands/review.toml +190 -190
  62. package/commands/scout-ext.toml +97 -97
  63. package/commands/scout.toml +79 -79
  64. package/commands/screenshot.toml +65 -65
  65. package/commands/session.toml +102 -102
  66. package/commands/skill.toml +384 -384
  67. package/commands/status.toml +22 -22
  68. package/commands/team.toml +56 -56
  69. package/commands/test.toml +164 -164
  70. package/commands/ticket.toml +70 -70
  71. package/commands/use.toml +106 -106
  72. package/commands/video.toml +83 -83
  73. package/commands/watzup.toml +71 -71
  74. package/commands/workflow.toml +14 -14
  75. package/package.json +35 -35
  76. package/skills/meta/README.md +30 -30
  77. package/skills/meta/api-design/SKILL.md +134 -134
  78. package/skills/meta/code-review/SKILL.md +44 -44
  79. package/skills/meta/code-review/checklists/pre-merge.md +25 -25
  80. package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
  81. package/skills/meta/code-review/workflows/performance-pass.md +27 -27
  82. package/skills/meta/code-review/workflows/security-pass.md +29 -29
  83. package/skills/meta/compound-docs/SKILL.md +133 -133
  84. package/skills/meta/debug/SKILL.md +40 -40
  85. package/skills/meta/debug/templates/bug-report.template.md +31 -31
  86. package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
  87. package/skills/meta/docker/SKILL.md +126 -126
  88. package/skills/meta/examples/supabase/SKILL.md +46 -46
  89. package/skills/meta/examples/supabase/references/best-practices.md +319 -319
  90. package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
  91. package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
  92. package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
  93. package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
  94. package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
  95. package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
  96. package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
  97. package/skills/meta/file-todos/SKILL.md +88 -88
  98. package/skills/meta/mobile/SKILL.md +140 -140
  99. package/skills/meta/nextjs/SKILL.md +101 -101
  100. package/skills/meta/performance/SKILL.md +130 -130
  101. package/skills/meta/react-patterns/SKILL.md +83 -83
  102. package/skills/meta/security/SKILL.md +114 -114
  103. package/skills/meta/session-resume/SKILL.md +96 -96
  104. package/skills/meta/tailwind/SKILL.md +139 -139
  105. package/skills/meta/testing/SKILL.md +43 -43
  106. package/skills/meta/testing/references/vitest-patterns.md +45 -45
  107. package/skills/meta/testing/templates/component-test.template.tsx +37 -37
  108. package/skills/tech/alpha-vantage/SKILL.md +142 -142
  109. package/skills/tech/alpha-vantage/references/commodities.md +153 -153
  110. package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
  111. package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
  112. package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
  113. package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
  114. package/skills/tech/alpha-vantage/references/options.md +93 -93
  115. package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
  116. package/skills/tech/alpha-vantage/references/time-series.md +157 -157
  117. package/skills/tech/financial-modeling/SKILL.md +18 -18
  118. package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
  119. package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
  120. package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
  121. package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
  122. package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
  123. package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
  124. package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
  125. package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
  126. package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
  127. package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
  128. package/skills/workflows/README.md +203 -203
  129. package/skills/workflows/adr.md +174 -174
  130. package/skills/workflows/changelog.md +74 -74
  131. package/skills/workflows/compound.md +323 -323
  132. package/skills/workflows/compound_health.md +74 -74
  133. package/skills/workflows/create-agent-skill.md +138 -138
  134. package/skills/workflows/cycle.md +144 -144
  135. package/skills/workflows/deploy-docs.md +84 -84
  136. package/skills/workflows/development-rules.md +42 -42
  137. package/skills/workflows/doc.md +95 -95
  138. package/skills/workflows/documentation-management.md +34 -34
  139. package/skills/workflows/explore.md +146 -146
  140. package/skills/workflows/generate_command.md +106 -106
  141. package/skills/workflows/heal-skill.md +97 -97
  142. package/skills/workflows/housekeeping.md +229 -229
  143. package/skills/workflows/kit-setup.md +102 -102
  144. package/skills/workflows/map-codebase.md +78 -78
  145. package/skills/workflows/orchestration-protocol.md +43 -43
  146. package/skills/workflows/plan-compound.md +439 -439
  147. package/skills/workflows/plan_review.md +269 -269
  148. package/skills/workflows/primary-workflow.md +37 -37
  149. package/skills/workflows/promote_pattern.md +86 -86
  150. package/skills/workflows/release-docs.md +82 -82
  151. package/skills/workflows/report-bug.md +135 -135
  152. package/skills/workflows/reproduce-bug.md +118 -118
  153. package/skills/workflows/resolve_pr.md +133 -133
  154. package/skills/workflows/resolve_todo.md +128 -128
  155. package/skills/workflows/review-compound.md +376 -376
  156. package/skills/workflows/skill-review.md +127 -127
  157. package/skills/workflows/specs.md +257 -257
  158. package/skills/workflows/triage-sprint.md +102 -102
  159. package/skills/workflows/triage.md +152 -152
  160. package/skills/workflows/work.md +399 -399
  161. package/skills/workflows/xcode-test.md +93 -93
@@ -11,22 +11,22 @@ describe('seoChecker', () => {
11
11
  name: 'index.tsx', // valid page layout file
12
12
  isDirectory: () => false
13
13
  }]);
14
- vi.mocked(fs.readFile).mockResolvedValue(`
15
- export default function Index() {
16
- return (
17
- <html>
18
- <head>
19
- <title>Oops missing description and og</title>
20
- </head>
21
- <body>
22
- <h1>Title</h1>
23
- <h1>Duplicate Title</h1>
24
- <img src="foo" />
25
- <img src="bar" alt="" />
26
- </body>
27
- </html>
28
- )
29
- }
14
+ vi.mocked(fs.readFile).mockResolvedValue(`
15
+ export default function Index() {
16
+ return (
17
+ <html>
18
+ <head>
19
+ <title>Oops missing description and og</title>
20
+ </head>
21
+ <body>
22
+ <h1>Title</h1>
23
+ <h1>Duplicate Title</h1>
24
+ <img src="foo" />
25
+ <img src="bar" alt="" />
26
+ </body>
27
+ </html>
28
+ )
29
+ }
30
30
  `);
31
31
  const res = await runSeoChecker('.');
32
32
  expect(res.passed).toBe(false);
@@ -14,9 +14,9 @@ describe('typeCoverage', () => {
14
14
  isDirectory: () => false
15
15
  }]);
16
16
  // Mock readFile to return a snippet with an untyped function and an "any"
17
- vi.mocked(fs.readFile).mockResolvedValue(`
18
- function test(): any { return 1; }
19
- const test2 = (x) => console.log(x);
17
+ vi.mocked(fs.readFile).mockResolvedValue(`
18
+ function test(): any { return 1; }
19
+ const test2 = (x) => console.log(x);
20
20
  `);
21
21
  const result = await checkTypescriptCoverage('/mock/folder');
22
22
  expect(result.type).toBe('typescript');
@@ -29,8 +29,8 @@ describe('typeCoverage', () => {
29
29
  name: 'good.ts',
30
30
  isDirectory: () => false
31
31
  }]);
32
- vi.mocked(fs.readFile).mockResolvedValue(`
33
- function typedFunc(val: string): number { return val.length; }
32
+ vi.mocked(fs.readFile).mockResolvedValue(`
33
+ function typedFunc(val: string): number { return val.length; }
34
34
  `);
35
35
  const result = await checkTypescriptCoverage('/mock/good');
36
36
  expect(result.stats.any_count).toBe(0);
@@ -44,15 +44,15 @@ describe('typeCoverage', () => {
44
44
  name: 'script.py',
45
45
  isDirectory: () => false
46
46
  }]);
47
- vi.mocked(fs.readFile).mockResolvedValue(`
48
- def bad_func(arg):
49
- pass
50
-
51
- def good_func(arg: str) -> bool:
52
- return True
53
-
54
- def any_func(arg: Any) -> Any:
55
- pass
47
+ vi.mocked(fs.readFile).mockResolvedValue(`
48
+ def bad_func(arg):
49
+ pass
50
+
51
+ def good_func(arg: str) -> bool:
52
+ return True
53
+
54
+ def any_func(arg: Any) -> Any:
55
+ pass
56
56
  `);
57
57
  const result = await checkPythonCoverage('/mock/py');
58
58
  expect(result.stats.any_count).toBeGreaterThan(0);
@@ -1,122 +1,122 @@
1
- # Commands
2
-
3
- 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.
4
-
5
- ## Overview
6
-
7
- 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.
8
-
9
- ## Command Categories
10
-
11
- | Category | Commands | Purpose |
12
- |----------|----------|---------|
13
- | **Planning** | `plan`, `brainstorm` | Create implementation plans |
14
- | **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
15
- | **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
16
- | **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
17
- | **Project** | `project`, `pm`, `status` | Project management |
18
- | **Git** | `git`, `session` | Git and session management |
19
- | **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
20
- | **Content** | `content`, `copywrite`, `chat` | Content creation |
21
- | **Database** | `db` | Database operations |
22
- | **Design** | `design` | UI/UX design tasks |
23
- | **Testing** | `test` | Testing and QA |
24
- | **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
25
-
26
- ## Components
27
-
28
- | Component | Purpose | Status |
29
- |-----------|---------|--------|
30
- | `ask.toml` | General Q&A with context | ✅ Active |
31
- | `brainstorm.toml` | Creative ideation | ✅ Active |
32
- | `chat.toml` | Conversational interactions | ✅ Active |
33
- | `code.toml` | Code implementation | ✅ Active |
34
- | `code-preview.toml` | Code preview mode | ✅ Active |
35
- | `content.toml` | Content creation | ✅ Active |
36
- | `cook.toml` | Execute plans step-by-step | ✅ Active |
37
- | `copywrite.toml` | Marketing copy | ✅ Active |
38
- | `db.toml` | Database operations | ✅ Active |
39
- | `debug.toml` | Debugging assistance | ✅ Active |
40
- | `design.toml` | UI/UX design | ✅ Active |
41
- | `dev-rules.toml` | Development rules loader | ✅ Active |
42
- | `do.toml` | Quick task execution | ✅ Active |
43
- | `doc-rules.toml` | Documentation rules | ✅ Active |
44
- | `docs.toml` | Documentation management | ✅ Active |
45
- | `fix.toml` | Bug fixing | ✅ Active |
46
- | `fullstack.toml` | Full-stack development | ✅ Active |
47
- | `git.toml` | Git operations | ✅ Active |
48
- | `help.toml` | Help and guidance | ✅ Active |
49
- | `integrate.toml` | Integration tasks | ✅ Active |
50
- | `journal.toml` | Session journaling | ✅ Active |
51
- | `kit-setup.toml` | Project setup wizard | ✅ Active |
52
- | `mcp.toml` | MCP server management | ✅ Active |
53
- | `orchestration.toml` | Multi-agent orchestration | ✅ Active |
54
- | `plan.toml` | Implementation planning | ✅ Active |
55
- | `pm.toml` | Project management | ✅ Active |
56
- | `pr.toml` | Pull request creation | ✅ Active |
57
- | `project.toml` | Project context | ✅ Active |
58
- | `research.toml` | Research tasks | ✅ Active |
59
- | `review-pr.toml` | PR review | ✅ Active |
60
- | `review.toml` | Code review | ✅ Active |
61
- | `scout-ext.toml` | Extended codebase exploration | ✅ Active |
62
- | `scout.toml` | Codebase scout | ✅ Active |
63
- | `screenshot.toml` | Screenshot capture | ✅ Active |
64
- | `session.toml` | Session management | ✅ Active |
65
- | `skill.toml` | Skill creation | ✅ Active |
66
- | `status.toml` | Status reporting | ✅ Active |
67
- | `team.toml` | Team coordination | ✅ Active |
68
- | `test.toml` | Testing tasks | ✅ Active |
69
- | `ticket.toml` | Issue/ticket management | ✅ Active |
70
- | `use.toml` | Use existing patterns | ✅ Active |
71
- | `video.toml` | Video processing | ✅ Active |
72
- | `watzup.toml` | Quick status check | ✅ Active |
73
- | `workflow.toml` | Workflow management | ✅ Active |
74
-
75
- ## TOML Structure
76
-
77
- Each command file follows this structure:
78
-
79
- ```toml
80
- description = "Brief description shown in command list"
81
-
82
- prompt = '''
83
- # Command Name
84
-
85
- {{args}} - User input passed to the command
86
-
87
- ## Instructions
88
- ...
89
- '''
90
- ```
91
-
92
- ### String Types
93
-
94
- - **Basic string** (`"""..."""`): Processes escape sequences
95
- - **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
96
-
97
- > [!NOTE]
98
- > Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
99
-
100
- ## Usage
101
-
102
- ```bash
103
- # In Gemini CLI
104
- /command-name [arguments]
105
-
106
- # Examples
107
- /plan Add user authentication
108
- /code Implement login form
109
- /review @src/auth/login.ts
110
- ```
111
-
112
- ## Changelog
113
-
114
- ### 2026-01-24
115
- - Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
116
-
117
- ---
118
-
119
- ## References
120
-
121
- - [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
122
- - [TOML Specification](https://toml.io/en/)
1
+ # Commands
2
+
3
+ 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.
4
+
5
+ ## Overview
6
+
7
+ 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.
8
+
9
+ ## Command Categories
10
+
11
+ | Category | Commands | Purpose |
12
+ |----------|----------|---------|
13
+ | **Planning** | `plan`, `brainstorm` | Create implementation plans |
14
+ | **Coding** | `code`, `fix`, `debug`, `fullstack` | Write and debug code |
15
+ | **Review** | `review`, `review-pr`, `pr` | Code review and PR management |
16
+ | **Documentation** | `docs`, `doc-rules`, `help` | Documentation tasks |
17
+ | **Project** | `project`, `pm`, `status` | Project management |
18
+ | **Git** | `git`, `session` | Git and session management |
19
+ | **Research** | `research`, `scout`, `scout-ext` | Codebase exploration |
20
+ | **Content** | `content`, `copywrite`, `chat` | Content creation |
21
+ | **Database** | `db` | Database operations |
22
+ | **Design** | `design` | UI/UX design tasks |
23
+ | **Testing** | `test` | Testing and QA |
24
+ | **Tools** | `mcp`, `skill`, `screenshot`, `video` | Tool integrations |
25
+
26
+ ## Components
27
+
28
+ | Component | Purpose | Status |
29
+ |-----------|---------|--------|
30
+ | `ask.toml` | General Q&A with context | ✅ Active |
31
+ | `brainstorm.toml` | Creative ideation | ✅ Active |
32
+ | `chat.toml` | Conversational interactions | ✅ Active |
33
+ | `code.toml` | Code implementation | ✅ Active |
34
+ | `code-preview.toml` | Code preview mode | ✅ Active |
35
+ | `content.toml` | Content creation | ✅ Active |
36
+ | `cook.toml` | Execute plans step-by-step | ✅ Active |
37
+ | `copywrite.toml` | Marketing copy | ✅ Active |
38
+ | `db.toml` | Database operations | ✅ Active |
39
+ | `debug.toml` | Debugging assistance | ✅ Active |
40
+ | `design.toml` | UI/UX design | ✅ Active |
41
+ | `dev-rules.toml` | Development rules loader | ✅ Active |
42
+ | `do.toml` | Quick task execution | ✅ Active |
43
+ | `doc-rules.toml` | Documentation rules | ✅ Active |
44
+ | `docs.toml` | Documentation management | ✅ Active |
45
+ | `fix.toml` | Bug fixing | ✅ Active |
46
+ | `fullstack.toml` | Full-stack development | ✅ Active |
47
+ | `git.toml` | Git operations | ✅ Active |
48
+ | `help.toml` | Help and guidance | ✅ Active |
49
+ | `integrate.toml` | Integration tasks | ✅ Active |
50
+ | `journal.toml` | Session journaling | ✅ Active |
51
+ | `kit-setup.toml` | Project setup wizard | ✅ Active |
52
+ | `mcp.toml` | MCP server management | ✅ Active |
53
+ | `orchestration.toml` | Multi-agent orchestration | ✅ Active |
54
+ | `plan.toml` | Implementation planning | ✅ Active |
55
+ | `pm.toml` | Project management | ✅ Active |
56
+ | `pr.toml` | Pull request creation | ✅ Active |
57
+ | `project.toml` | Project context | ✅ Active |
58
+ | `research.toml` | Research tasks | ✅ Active |
59
+ | `review-pr.toml` | PR review | ✅ Active |
60
+ | `review.toml` | Code review | ✅ Active |
61
+ | `scout-ext.toml` | Extended codebase exploration | ✅ Active |
62
+ | `scout.toml` | Codebase scout | ✅ Active |
63
+ | `screenshot.toml` | Screenshot capture | ✅ Active |
64
+ | `session.toml` | Session management | ✅ Active |
65
+ | `skill.toml` | Skill creation | ✅ Active |
66
+ | `status.toml` | Status reporting | ✅ Active |
67
+ | `team.toml` | Team coordination | ✅ Active |
68
+ | `test.toml` | Testing tasks | ✅ Active |
69
+ | `ticket.toml` | Issue/ticket management | ✅ Active |
70
+ | `use.toml` | Use existing patterns | ✅ Active |
71
+ | `video.toml` | Video processing | ✅ Active |
72
+ | `watzup.toml` | Quick status check | ✅ Active |
73
+ | `workflow.toml` | Workflow management | ✅ Active |
74
+
75
+ ## TOML Structure
76
+
77
+ Each command file follows this structure:
78
+
79
+ ```toml
80
+ description = "Brief description shown in command list"
81
+
82
+ prompt = '''
83
+ # Command Name
84
+
85
+ {{args}} - User input passed to the command
86
+
87
+ ## Instructions
88
+ ...
89
+ '''
90
+ ```
91
+
92
+ ### String Types
93
+
94
+ - **Basic string** (`"""..."""`): Processes escape sequences
95
+ - **Literal string** (`'''...'''`): Raw content, no escape processing (preferred for complex prompts with code blocks)
96
+
97
+ > [!NOTE]
98
+ > Use literal strings (`'''`) when your prompt contains nested markdown code blocks to avoid TOML parsing issues.
99
+
100
+ ## Usage
101
+
102
+ ```bash
103
+ # In Gemini CLI
104
+ /command-name [arguments]
105
+
106
+ # Examples
107
+ /plan Add user authentication
108
+ /code Implement login form
109
+ /review @src/auth/login.ts
110
+ ```
111
+
112
+ ## Changelog
113
+
114
+ ### 2026-01-24
115
+ - Fixed TOML parsing failure in `docs.toml` by switching from basic strings (`"""`) to literal strings (`'''`) - Issue #9
116
+
117
+ ---
118
+
119
+ ## References
120
+
121
+ - [Gemini CLI Commands Documentation](https://ai.google.dev/gemini-api/docs/gemini-cli)
122
+ - [TOML Specification](https://toml.io/en/)
package/commands/ask.toml CHANGED
@@ -1,72 +1,72 @@
1
- # Ask - Ask About Codebase
2
- # Usage: /ask <question>
3
- # Ask questions about the codebase, AI will search and answer
4
-
5
- description = "Ask questions about the codebase, AI will search and answer"
6
-
7
- prompt = """
8
- {{#if args}}
9
- # ❓ Ask About Codebase
10
-
11
- **Question:** {{args}}
12
-
13
- ## Instructions:
14
-
15
- 1. **Search the codebase** to find relevant files and code
16
- 2. **Analyze** the code structure and patterns
17
- 3. **Answer** the question based on actual code
18
-
19
- ## Search Strategy:
20
- - Look for files related to the question keywords
21
- - Read relevant source files
22
- - Check imports and dependencies
23
- - Look at tests for usage examples
24
-
25
- ## Answer Format:
26
-
27
- ### 📋 Answer
28
- [Direct answer to the question]
29
-
30
- ### 📁 Relevant Files
31
- - `file1.ts` - [description]
32
- - `file2.ts` - [description]
33
-
34
- ### 💡 Code Examples
35
- ```typescript
36
- // relevant code snippets
37
- ```
38
-
39
- ### 🔗 Related
40
- - [other related concepts or files]
41
-
42
- ---
43
-
44
- Now search the codebase and answer: "{{args}}"
45
- {{else}}
46
- # ❓ Ask About Codebase
47
-
48
- Ask any question about the codebase and get AI-powered answers.
49
-
50
- ## Usage:
51
- ```
52
- /ask <your question>
53
- ```
54
-
55
- ## Examples:
56
- ```
57
- /ask How does authentication work?
58
- /ask Where is the user model defined?
59
- /ask What API endpoints are available?
60
- /ask How do I add a new route?
61
- /ask Where are database queries made?
62
- ```
63
-
64
- ## What it does:
65
- 1. Searches codebase for relevant files
66
- 2. Analyzes code structure and patterns
67
- 3. Provides answer based on actual code
68
- 4. Shows relevant code snippets
69
-
70
- Ask your question!
71
- {{/if}}
72
- """
1
+ # Ask - Ask About Codebase
2
+ # Usage: /ask <question>
3
+ # Ask questions about the codebase, AI will search and answer
4
+
5
+ description = "Ask questions about the codebase, AI will search and answer"
6
+
7
+ prompt = """
8
+ {{#if args}}
9
+ # ❓ Ask About Codebase
10
+
11
+ **Question:** {{args}}
12
+
13
+ ## Instructions:
14
+
15
+ 1. **Search the codebase** to find relevant files and code
16
+ 2. **Analyze** the code structure and patterns
17
+ 3. **Answer** the question based on actual code
18
+
19
+ ## Search Strategy:
20
+ - Look for files related to the question keywords
21
+ - Read relevant source files
22
+ - Check imports and dependencies
23
+ - Look at tests for usage examples
24
+
25
+ ## Answer Format:
26
+
27
+ ### 📋 Answer
28
+ [Direct answer to the question]
29
+
30
+ ### 📁 Relevant Files
31
+ - `file1.ts` - [description]
32
+ - `file2.ts` - [description]
33
+
34
+ ### 💡 Code Examples
35
+ ```typescript
36
+ // relevant code snippets
37
+ ```
38
+
39
+ ### 🔗 Related
40
+ - [other related concepts or files]
41
+
42
+ ---
43
+
44
+ Now search the codebase and answer: "{{args}}"
45
+ {{else}}
46
+ # ❓ Ask About Codebase
47
+
48
+ Ask any question about the codebase and get AI-powered answers.
49
+
50
+ ## Usage:
51
+ ```
52
+ /ask <your question>
53
+ ```
54
+
55
+ ## Examples:
56
+ ```
57
+ /ask How does authentication work?
58
+ /ask Where is the user model defined?
59
+ /ask What API endpoints are available?
60
+ /ask How do I add a new route?
61
+ /ask Where are database queries made?
62
+ ```
63
+
64
+ ## What it does:
65
+ 1. Searches codebase for relevant files
66
+ 2. Analyzes code structure and patterns
67
+ 3. Provides answer based on actual code
68
+ 4. Shows relevant code snippets
69
+
70
+ Ask your question!
71
+ {{/if}}
72
+ """