musubix 3.4.1 → 3.4.3

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 (95) hide show
  1. package/README.md +50 -315
  2. package/bin/musubix.js +1 -9
  3. package/dist/index.d.ts +25 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +74 -0
  6. package/dist/index.js.map +1 -0
  7. package/package.json +51 -57
  8. package/.github/AGENTS.md +0 -949
  9. package/.github/prompts/sdd-change-apply.prompt.md +0 -283
  10. package/.github/prompts/sdd-change-archive.prompt.md +0 -241
  11. package/.github/prompts/sdd-change-init.prompt.md +0 -269
  12. package/.github/prompts/sdd-design.prompt.md +0 -250
  13. package/.github/prompts/sdd-implement.prompt.md +0 -387
  14. package/.github/prompts/sdd-requirements.prompt.md +0 -193
  15. package/.github/prompts/sdd-review.prompt.md +0 -155
  16. package/.github/prompts/sdd-security.prompt.md +0 -228
  17. package/.github/prompts/sdd-steering.prompt.md +0 -269
  18. package/.github/prompts/sdd-tasks.prompt.md +0 -255
  19. package/.github/prompts/sdd-test.prompt.md +0 -230
  20. package/.github/prompts/sdd-validate.prompt.md +0 -304
  21. package/.github/skills/musubix-adr-generation/SKILL.md +0 -209
  22. package/.github/skills/musubix-best-practices/SKILL.md +0 -315
  23. package/.github/skills/musubix-c4-design/SKILL.md +0 -162
  24. package/.github/skills/musubix-code-generation/SKILL.md +0 -237
  25. package/.github/skills/musubix-domain-inference/SKILL.md +0 -196
  26. package/.github/skills/musubix-ears-validation/SKILL.md +0 -161
  27. package/.github/skills/musubix-sdd-workflow/SKILL.md +0 -217
  28. package/.github/skills/musubix-technical-writing/SKILL.md +0 -444
  29. package/.github/skills/musubix-test-generation/SKILL.md +0 -212
  30. package/.github/skills/musubix-traceability/SKILL.md +0 -141
  31. package/AGENTS.md +0 -1134
  32. package/LICENSE +0 -21
  33. package/README.ja.md +0 -313
  34. package/bin/musubix-mcp.js +0 -15
  35. package/docs/API-REFERENCE.md +0 -1425
  36. package/docs/GITHUB-ACTIONS-NPM-SETUP.md +0 -132
  37. package/docs/INSTALL-GUIDE.ja.md +0 -459
  38. package/docs/INSTALL-GUIDE.md +0 -459
  39. package/docs/MIGRATION-v3.0.md +0 -324
  40. package/docs/MUSUBI-enhancement_roadmap_20260105.md +0 -651
  41. package/docs/MUSUBIX-v3.0-User-Guide.md +0 -1357
  42. package/docs/MUSUBIXv2.2.0-Manual-outline.md +0 -136
  43. package/docs/MUSUBIXv2.2.0-Manual.md +0 -3123
  44. package/docs/MUSUBIXv2.3.5-Refactering.md +0 -1310
  45. package/docs/MUSUBIv1.6.1-enhancement_roadmap_20260105.md +0 -291
  46. package/docs/MUSUBIv2.2.0-USERGUIDE.md +0 -2079
  47. package/docs/ROADMAP-v1.5.md +0 -116
  48. package/docs/SwarmCoding.md +0 -1284
  49. package/docs/Test-prompt.md +0 -105
  50. package/docs/USER-GUIDE-v1.8.0.md +0 -2371
  51. package/docs/USER-GUIDE.ja.md +0 -2147
  52. package/docs/USER-GUIDE.md +0 -3022
  53. package/docs/YATA-GLOBAL-GUIDE.ja.md +0 -750
  54. package/docs/YATA-GLOBAL-GUIDE.md +0 -595
  55. package/docs/YATA-LOCAL-GUIDE.ja.md +0 -989
  56. package/docs/YATA-LOCAL-GUIDE.md +0 -730
  57. package/docs/adr/0001-real-time-pattern-learning-architecture-for-v1-5-0.md +0 -75
  58. package/docs/adr/0002-pattern-sharing-protocol-for-cross-team-collaborat.md +0 -79
  59. package/docs/adr/0003-owl-2-rl-implementation-strategy-for-advanced-infe.md +0 -90
  60. package/docs/adr/ADR-v3.4.0-001-deep-research-architecture.md +0 -217
  61. package/docs/adr/ADR-v3.4.0-002-search-provider-selection.md +0 -308
  62. package/docs/adr/ADR-v3.4.0-003-lm-api-integration.md +0 -475
  63. package/docs/enterprise-knowledge-management.md +0 -1737
  64. package/docs/evolution-from-musubi-to-musubix.md +0 -2170
  65. package/docs/getting-started-with-sdd.md +0 -1602
  66. package/docs/moodle-refactering-codegraph-musubix.md +0 -391
  67. package/docs/moodle-refactering-codegraph.md +0 -278
  68. package/docs/overview/MUSUBIX-CodeGraph.md +0 -322
  69. package/docs/overview/MUSUBIX-Core.md +0 -671
  70. package/docs/overview/MUSUBIX-Decisions.md +0 -494
  71. package/docs/overview/MUSUBIX-FormalVerify.md +0 -566
  72. package/docs/overview/MUSUBIX-Knowledge.md +0 -1231
  73. package/docs/overview/MUSUBIX-Learning.md +0 -837
  74. package/docs/overview/MUSUBIX-MCP-Server.md +0 -535
  75. package/docs/overview/MUSUBIX-Overview.md +0 -264
  76. package/docs/overview/MUSUBIX-Phase1-Complete.md +0 -271
  77. package/docs/overview/MUSUBIX-Phase2-Complete.md +0 -310
  78. package/docs/overview/MUSUBIX-Policy.md +0 -477
  79. package/docs/overview/MUSUBIX-Roadmap-v2.md +0 -399
  80. package/docs/overview/MUSUBIX-Security-Plan.md +0 -939
  81. package/docs/overview/MUSUBIX-Security-v2.1.md +0 -668
  82. package/docs/overview/MUSUBIX-Security.md +0 -891
  83. package/docs/overview/MUSUBIX-YATA.md +0 -666
  84. package/docs/overview/MUSUBIX-v2.2.0-Advanced-Learning.md +0 -513
  85. package/docs/overview/Neuro-SymbolicAI.md +0 -159
  86. package/docs/packages/knowledge.md +0 -594
  87. package/docs/qiita-linux-kernel-knowledge-graph.md +0 -596
  88. package/scripts/generate-quality-gate-report.ts +0 -106
  89. package/scripts/postinstall.js +0 -94
  90. package/steering/.musubi-version +0 -1
  91. package/steering/product.ja.md +0 -572
  92. package/steering/project.yml +0 -66
  93. package/steering/rules/constitution.md +0 -491
  94. package/steering/structure.ja.md +0 -503
  95. package/steering/tech.ja.md +0 -208
@@ -1,94 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * MUSUBIX Postinstall Script
4
- *
5
- * Copies .github/ and AGENTS.md to the project root after npm install.
6
- * This enables GitHub Copilot and other AI agents to use MUSUBIX prompts and skills.
7
- */
8
-
9
- import { existsSync, cpSync, copyFileSync, mkdirSync } from 'fs';
10
- import { dirname, join, resolve } from 'path';
11
- import { fileURLToPath } from 'url';
12
-
13
- const __filename = fileURLToPath(import.meta.url);
14
- const __dirname = dirname(__filename);
15
-
16
- // Source: where musubix is installed (node_modules/musubix)
17
- const packageRoot = resolve(__dirname, '..');
18
-
19
- // Target: project root (where npm install was run)
20
- // When installed as dependency: process.env.INIT_CWD points to project root
21
- // When running in musubix repo itself: skip
22
- const projectRoot = process.env.INIT_CWD || process.cwd();
23
-
24
- // Skip if we're in the musubix package itself
25
- if (projectRoot === packageRoot || projectRoot.includes('node_modules/musubix')) {
26
- console.log('musubix: Skipping postinstall (running in package directory)');
27
- process.exit(0);
28
- }
29
-
30
- const sourceGithub = join(packageRoot, '.github');
31
- const sourceAgents = join(packageRoot, 'AGENTS.md');
32
- const targetGithub = join(projectRoot, '.github');
33
- const targetAgents = join(projectRoot, 'AGENTS.md');
34
-
35
- let copied = false;
36
-
37
- // Copy .github directory
38
- if (existsSync(sourceGithub)) {
39
- // Only copy musubix-specific files, don't overwrite existing .github
40
- const musubixPrompts = join(sourceGithub, 'prompts');
41
- const musubixSkills = join(sourceGithub, 'skills');
42
- const musubixAgents = join(sourceGithub, 'AGENTS.md');
43
-
44
- // Create .github if not exists
45
- if (!existsSync(targetGithub)) {
46
- mkdirSync(targetGithub, { recursive: true });
47
- }
48
-
49
- // Copy prompts
50
- if (existsSync(musubixPrompts)) {
51
- const targetPrompts = join(targetGithub, 'prompts');
52
- if (!existsSync(targetPrompts)) {
53
- mkdirSync(targetPrompts, { recursive: true });
54
- }
55
- cpSync(musubixPrompts, targetPrompts, { recursive: true, force: false });
56
- console.log('musubix: Copied .github/prompts/');
57
- copied = true;
58
- }
59
-
60
- // Copy skills
61
- if (existsSync(musubixSkills)) {
62
- const targetSkills = join(targetGithub, 'skills');
63
- if (!existsSync(targetSkills)) {
64
- mkdirSync(targetSkills, { recursive: true });
65
- }
66
- cpSync(musubixSkills, targetSkills, { recursive: true, force: false });
67
- console.log('musubix: Copied .github/skills/');
68
- copied = true;
69
- }
70
-
71
- // Copy .github/AGENTS.md
72
- if (existsSync(musubixAgents)) {
73
- const targetGithubAgents = join(targetGithub, 'AGENTS.md');
74
- if (!existsSync(targetGithubAgents)) {
75
- copyFileSync(musubixAgents, targetGithubAgents);
76
- console.log('musubix: Copied .github/AGENTS.md');
77
- copied = true;
78
- }
79
- }
80
- }
81
-
82
- // Copy AGENTS.md to project root
83
- if (existsSync(sourceAgents) && !existsSync(targetAgents)) {
84
- copyFileSync(sourceAgents, targetAgents);
85
- console.log('musubix: Copied AGENTS.md');
86
- copied = true;
87
- }
88
-
89
- if (copied) {
90
- console.log('musubix: AI agent configuration files installed successfully!');
91
- console.log('musubix: GitHub Copilot can now use MUSUBIX SDD prompts and skills.');
92
- } else {
93
- console.log('musubix: Configuration files already exist, skipping.');
94
- }
@@ -1 +0,0 @@
1
- 6.2.1
@@ -1,572 +0,0 @@
1
- # Product Context
2
-
3
- **Project**: MUSUBIX
4
- **Last Updated**: 2026-01-04
5
- **Version**: 1.1.15
6
-
7
- ---
8
-
9
- ## Product Vision
10
-
11
- **Vision Statement**: {{VISION_STATEMENT}}
12
-
13
- > [1-2 paragraph description of what this product aims to achieve and why it exists]
14
-
15
- **Mission**: {{MISSION_STATEMENT}}
16
-
17
- > [How the product achieves its vision]
18
-
19
- ---
20
-
21
- ## Product Overview
22
-
23
- ### What is MUSUBIX?
24
-
25
- A software project using MUSUBI SDD
26
-
27
- > [2-3 paragraphs explaining the product, its purpose, and core value proposition]
28
-
29
- ### Problem Statement
30
-
31
- **Problem**: {{PROBLEM_STATEMENT}}
32
-
33
- > [What problem does this product solve? What pain points does it address?]
34
-
35
- ### Solution
36
-
37
- **Solution**: {{SOLUTION_STATEMENT}}
38
-
39
- > [How does this product solve the problem? What makes it unique?]
40
-
41
- ---
42
-
43
- ## Target Users
44
-
45
- ### Primary Users
46
-
47
- #### User Persona 1: {{PERSONA_1_NAME}}
48
-
49
- **Demographics**:
50
-
51
- - **Role**: {{ROLE}}
52
- - **Organization Size**: {{ORG_SIZE}}
53
- - **Technical Level**: {{TECH_LEVEL}}
54
-
55
- **Goals**:
56
-
57
- - [Goal 1]
58
- - [Goal 2]
59
- - [Goal 3]
60
-
61
- **Pain Points**:
62
-
63
- - [Pain point 1]
64
- - [Pain point 2]
65
- - [Pain point 3]
66
-
67
- **Use Cases**:
68
-
69
- - [Use case 1]
70
- - [Use case 2]
71
- - [Use case 3]
72
-
73
- ---
74
-
75
- #### User Persona 2: {{PERSONA_2_NAME}}
76
-
77
- **Demographics**:
78
-
79
- - **Role**: {{ROLE}}
80
- - **Organization Size**: {{ORG_SIZE}}
81
- - **Technical Level**: {{TECH_LEVEL}}
82
-
83
- **Goals**:
84
-
85
- - [Goal 1]
86
- - [Goal 2]
87
-
88
- **Pain Points**:
89
-
90
- - [Pain point 1]
91
- - [Pain point 2]
92
-
93
- **Use Cases**:
94
-
95
- - [Use case 1]
96
- - [Use case 2]
97
-
98
- ---
99
-
100
- ### Secondary Users
101
-
102
- - **{{SECONDARY_USER_1}}**: [Description and role]
103
- - **{{SECONDARY_USER_2}}**: [Description and role]
104
-
105
- ---
106
-
107
- ## Market & Business Context
108
-
109
- ### Market Opportunity
110
-
111
- **Market Size**: {{MARKET_SIZE}}
112
-
113
- **Target Market**: {{TARGET_MARKET}}
114
-
115
- > [Description of the market opportunity, competitive landscape, and positioning]
116
-
117
- ### Business Model
118
-
119
- **Revenue Model**: {{REVENUE_MODEL}}
120
-
121
- > Examples: SaaS subscription, One-time purchase, Freemium, Usage-based
122
-
123
- **Pricing Tiers** (if applicable):
124
-
125
- - **Free Tier**: [Features, limitations]
126
- - **Pro Tier**: ${{PRICE}}/month - [Features]
127
- - **Enterprise Tier**: Custom pricing - [Features]
128
-
129
- ### Competitive Landscape
130
-
131
- | Competitor | Strengths | Weaknesses | Our Differentiation |
132
- | ---------------- | ----------- | ------------ | --------------------- |
133
- | {{COMPETITOR_1}} | [Strengths] | [Weaknesses] | [How we're different] |
134
- | {{COMPETITOR_2}} | [Strengths] | [Weaknesses] | [How we're different] |
135
-
136
- ---
137
-
138
- ## Core Product Capabilities
139
-
140
- ### Must-Have Features (MVP)
141
-
142
- 1. **{{FEATURE_1}}**
143
- - **Description**: [What it does]
144
- - **User Value**: [Why users need it]
145
- - **Priority**: P0 (Critical)
146
-
147
- 2. **{{FEATURE_2}}**
148
- - **Description**: [What it does]
149
- - **User Value**: [Why users need it]
150
- - **Priority**: P0 (Critical)
151
-
152
- 3. **{{FEATURE_3}}**
153
- - **Description**: [What it does]
154
- - **User Value**: [Why users need it]
155
- - **Priority**: P0 (Critical)
156
-
157
- ### High-Priority Features (Post-MVP)
158
-
159
- 4. **{{FEATURE_4}}**
160
- - **Description**: [What it does]
161
- - **User Value**: [Why users need it]
162
- - **Priority**: P1 (High)
163
-
164
- 5. **{{FEATURE_5}}**
165
- - **Description**: [What it does]
166
- - **User Value**: [Why users need it]
167
- - **Priority**: P1 (High)
168
-
169
- ### Future Features (Roadmap)
170
-
171
- 6. **{{FEATURE_6}}**
172
- - **Description**: [What it does]
173
- - **User Value**: [Why users need it]
174
- - **Priority**: P2 (Medium)
175
-
176
- 7. **{{FEATURE_7}}**
177
- - **Description**: [What it does]
178
- - **User Value**: [Why users need it]
179
- - **Priority**: P3 (Low)
180
-
181
- ---
182
-
183
- ## Product Principles
184
-
185
- ### Design Principles
186
-
187
- 1. **{{PRINCIPLE_1}}**
188
- - [Description of what this means for product decisions]
189
-
190
- 2. **{{PRINCIPLE_2}}**
191
- - [Description]
192
-
193
- 3. **{{PRINCIPLE_3}}**
194
- - [Description]
195
-
196
- **Examples**:
197
-
198
- - **Simplicity First**: Favor simple solutions over complex ones
199
- - **User Empowerment**: Give users control and flexibility
200
- - **Speed & Performance**: Fast response times (< 200ms)
201
-
202
- ### User Experience Principles
203
-
204
- 1. **{{UX_PRINCIPLE_1}}**
205
- - [How this guides UX decisions]
206
-
207
- 2. **{{UX_PRINCIPLE_2}}**
208
- - [How this guides UX decisions]
209
-
210
- **Examples**:
211
-
212
- - **Progressive Disclosure**: Show advanced features only when needed
213
- - **Accessibility First**: WCAG 2.1 AA compliance
214
- - **Mobile-First**: Design for mobile, enhance for desktop
215
-
216
- ---
217
-
218
- ## Success Metrics
219
-
220
- ### Key Performance Indicators (KPIs)
221
-
222
- #### Business Metrics
223
-
224
- | Metric | Target | Measurement |
225
- | ----------------------------------- | ----------------- | -------------- |
226
- | **Monthly Active Users (MAU)** | {{MAU_TARGET}} | [How measured] |
227
- | **Monthly Recurring Revenue (MRR)** | ${{MRR_TARGET}} | [How measured] |
228
- | **Customer Acquisition Cost (CAC)** | ${{CAC_TARGET}} | [How measured] |
229
- | **Customer Lifetime Value (LTV)** | ${{LTV_TARGET}} | [How measured] |
230
- | **Churn Rate** | < {{CHURN_RATE}}% | [How measured] |
231
-
232
- #### Product Metrics
233
-
234
- | Metric | Target | Measurement |
235
- | ---------------------------- | --------------------- | -------------- |
236
- | **Daily Active Users (DAU)** | {{DAU_TARGET}} | [How measured] |
237
- | **Feature Adoption Rate** | > {{ADOPTION_RATE}}% | [How measured] |
238
- | **User Retention (Day 7)** | > {{RETENTION_RATE}}% | [How measured] |
239
- | **Net Promoter Score (NPS)** | > {{NPS_TARGET}} | [How measured] |
240
-
241
- #### Technical Metrics
242
-
243
- | Metric | Target | Measurement |
244
- | --------------------------- | ------- | ----------------------- |
245
- | **API Response Time (p95)** | < 200ms | Monitoring dashboard |
246
- | **Uptime** | 99.9% | Status page |
247
- | **Error Rate** | < 0.1% | Error tracking (Sentry) |
248
- | **Page Load Time** | < 2s | Web vitals |
249
-
250
- ---
251
-
252
- ## Product Roadmap
253
-
254
- ### Phase 1: MVP (Months 1-3)
255
-
256
- **Goal**: Launch minimum viable product
257
-
258
- **Features**:
259
-
260
- - [Feature 1]
261
- - [Feature 2]
262
- - [Feature 3]
263
-
264
- **Success Criteria**:
265
-
266
- - [Criterion 1]
267
- - [Criterion 2]
268
-
269
- ---
270
-
271
- ### Phase 2: Growth (Months 4-6)
272
-
273
- **Goal**: Achieve product-market fit
274
-
275
- **Features**:
276
-
277
- - [Feature 4]
278
- - [Feature 5]
279
- - [Feature 6]
280
-
281
- **Success Criteria**:
282
-
283
- - [Criterion 1]
284
- - [Criterion 2]
285
-
286
- ---
287
-
288
- ### Phase 3: Scale (Months 7-12)
289
-
290
- **Goal**: Scale to {{USER_TARGET}} users
291
-
292
- **Features**:
293
-
294
- - [Feature 7]
295
- - [Feature 8]
296
- - [Feature 9]
297
-
298
- **Success Criteria**:
299
-
300
- - [Criterion 1]
301
- - [Criterion 2]
302
-
303
- ---
304
-
305
- ## User Workflows
306
-
307
- ### Primary Workflow 1: {{WORKFLOW_1_NAME}}
308
-
309
- **User Goal**: {{USER_GOAL}}
310
-
311
- **Steps**:
312
-
313
- 1. User [action 1]
314
- 2. System [response 1]
315
- 3. User [action 2]
316
- 4. System [response 2]
317
- 5. User achieves [goal]
318
-
319
- **Success Criteria**:
320
-
321
- - User completes workflow in < {{TIME}} minutes
322
- - Success rate > {{SUCCESS_RATE}}%
323
-
324
- ---
325
-
326
- ### Primary Workflow 2: {{WORKFLOW_2_NAME}}
327
-
328
- **User Goal**: {{USER_GOAL}}
329
-
330
- **Steps**:
331
-
332
- 1. [Step 1]
333
- 2. [Step 2]
334
- 3. [Step 3]
335
-
336
- **Success Criteria**:
337
-
338
- - [Criterion 1]
339
- - [Criterion 2]
340
-
341
- ---
342
-
343
- ## Business Domain
344
-
345
- ### Domain Concepts
346
-
347
- Key concepts and terminology used in this domain:
348
-
349
- 1. **{{CONCEPT_1}}**: [Definition and importance]
350
- 2. **{{CONCEPT_2}}**: [Definition and importance]
351
- 3. **{{CONCEPT_3}}**: [Definition and importance]
352
-
353
- **Example for SaaS Authentication**:
354
-
355
- - **Identity Provider (IdP)**: Service that authenticates users
356
- - **Single Sign-On (SSO)**: One login for multiple applications
357
- - **Multi-Factor Authentication (MFA)**: Additional verification step
358
-
359
- ### Business Rules
360
-
361
- 1. **{{RULE_1}}**
362
- - [Description of business rule]
363
- - **Example**: [Concrete example]
364
-
365
- 2. **{{RULE_2}}**
366
- - [Description]
367
- - **Example**: [Example]
368
-
369
- **Example for E-commerce**:
370
-
371
- - **Inventory Reservation**: Reserved items held for 10 minutes during checkout
372
- - **Refund Window**: Refunds allowed within 30 days of purchase
373
-
374
- ---
375
-
376
- ## Constraints & Requirements
377
-
378
- ### Business Constraints
379
-
380
- - **Budget**: ${{BUDGET}}
381
- - **Timeline**: {{TIMELINE}}
382
- - **Team Size**: {{TEAM_SIZE}} engineers
383
- - **Launch Date**: {{LAUNCH_DATE}}
384
-
385
- ### Compliance Requirements
386
-
387
- - **{{COMPLIANCE_1}}**: [Description, e.g., GDPR, SOC 2, HIPAA]
388
- - **{{COMPLIANCE_2}}**: [Description]
389
- - **Data Residency**: [Requirements, e.g., EU data stays in EU]
390
-
391
- ### Non-Functional Requirements
392
-
393
- - **Performance**: API response < 200ms (95th percentile)
394
- - **Availability**: 99.9% uptime SLA
395
- - **Scalability**: Support {{CONCURRENT_USERS}} concurrent users
396
- - **Security**: OWASP Top 10 compliance
397
- - **Accessibility**: WCAG 2.1 AA compliance
398
-
399
- ---
400
-
401
- ## Stakeholders
402
-
403
- ### Internal Stakeholders
404
-
405
- | Role | Name | Responsibilities |
406
- | ----------------------- | -------------------- | --------------------------------- |
407
- | **Product Owner** | {{PO_NAME}} | Vision, roadmap, priorities |
408
- | **Tech Lead** | {{TECH_LEAD_NAME}} | Architecture, technical decisions |
409
- | **Engineering Manager** | {{EM_NAME}} | Team management, delivery |
410
- | **QA Lead** | {{QA_LEAD_NAME}} | Quality assurance, testing |
411
- | **Design Lead** | {{DESIGN_LEAD_NAME}} | UX/UI design |
412
-
413
- ### External Stakeholders
414
-
415
- | Role | Name | Responsibilities |
416
- | --------------------------- | ----------- | --------------------------- |
417
- | **Customer Advisory Board** | [Members] | Product feedback |
418
- | **Investors** | [Names] | Funding, strategic guidance |
419
- | **Partners** | [Companies] | Integration, co-marketing |
420
-
421
- ---
422
-
423
- ## Go-to-Market Strategy
424
-
425
- ### Launch Strategy
426
-
427
- **Target Launch Date**: {{LAUNCH_DATE}}
428
-
429
- **Launch Phases**:
430
-
431
- 1. **Private Beta** ({{START_DATE}} - {{END_DATE}})
432
- - Invite-only, 50 beta users
433
- - Focus: Gather feedback, fix critical bugs
434
-
435
- 2. **Public Beta** ({{START_DATE}} - {{END_DATE}})
436
- - Open signup
437
- - Focus: Validate product-market fit
438
-
439
- 3. **General Availability** ({{LAUNCH_DATE}})
440
- - Full public launch
441
- - Focus: Acquisition and growth
442
-
443
- ### Marketing Channels
444
-
445
- - **{{CHANNEL_1}}**: [Strategy, e.g., Content marketing, SEO]
446
- - **{{CHANNEL_2}}**: [Strategy, e.g., Social media, Twitter/LinkedIn]
447
- - **{{CHANNEL_3}}**: [Strategy, e.g., Paid ads, Google/Facebook]
448
- - **{{CHANNEL_4}}**: [Strategy, e.g., Partnerships, integrations]
449
-
450
- ---
451
-
452
- ## Risk Assessment
453
-
454
- ### Product Risks
455
-
456
- | Risk | Probability | Impact | Mitigation |
457
- | ---------- | --------------- | --------------- | --------------------- |
458
- | {{RISK_1}} | High/Medium/Low | High/Medium/Low | [Mitigation strategy] |
459
- | {{RISK_2}} | High/Medium/Low | High/Medium/Low | [Mitigation strategy] |
460
-
461
- **Example Risks**:
462
-
463
- - **Low adoption**: Users don't understand value → Clear onboarding, demos
464
- - **Performance issues**: System slow at scale → Load testing, optimization
465
- - **Security breach**: Data compromised → Security audit, penetration testing
466
-
467
- ---
468
-
469
- ## Customer Support
470
-
471
- ### Support Channels
472
-
473
- - **Email**: support@{{COMPANY}}.com
474
- - **Chat**: In-app live chat (business hours)
475
- - **Documentation**: docs.{{COMPANY}}.com
476
- - **Community**: Forum/Discord/Slack
477
-
478
- ### Support SLA
479
-
480
- | Tier | Response Time | Resolution Time |
481
- | ----------------- | ------------- | --------------- |
482
- | **Critical (P0)** | < 1 hour | < 4 hours |
483
- | **High (P1)** | < 4 hours | < 24 hours |
484
- | **Medium (P2)** | < 24 hours | < 3 days |
485
- | **Low (P3)** | < 48 hours | Best effort |
486
-
487
- ---
488
-
489
- ## Product Analytics
490
-
491
- ### Analytics Tools
492
-
493
- - **{{ANALYTICS_TOOL_1}}**: [Purpose, e.g., Google Analytics, Mixpanel]
494
- - **{{ANALYTICS_TOOL_2}}**: [Purpose, e.g., Amplitude, Heap]
495
-
496
- ### Events to Track
497
-
498
- | Event | Description | Purpose |
499
- | ------------------- | ---------------------- | ----------------- |
500
- | `user_signup` | New user registration | Track acquisition |
501
- | `feature_used` | User uses core feature | Track engagement |
502
- | `payment_completed` | User completes payment | Track conversion |
503
- | `error_occurred` | User encounters error | Track reliability |
504
-
505
- ---
506
-
507
- ## Localization & Internationalization
508
-
509
- ### Supported Languages
510
-
511
- - **Primary**: English (en-US)
512
- - **Secondary**: [Languages, e.g., Japanese (ja-JP), Spanish (es-ES)]
513
-
514
- ### Localization Strategy
515
-
516
- - **UI Strings**: i18n framework (next-intl, react-i18next)
517
- - **Date/Time**: Locale-aware formatting
518
- - **Currency**: Multi-currency support
519
- - **Right-to-Left (RTL)**: Support for Arabic, Hebrew (if needed)
520
-
521
- ---
522
-
523
- ## Data & Privacy
524
-
525
- ### Data Collection
526
-
527
- **What data we collect**:
528
-
529
- - User account information (email, name)
530
- - Usage analytics (anonymized)
531
- - Error logs (for debugging)
532
-
533
- **What data we DON'T collect**:
534
-
535
- - [Sensitive data we avoid, e.g., passwords (only hashed), payment details (tokenized)]
536
-
537
- ### Privacy Policy
538
-
539
- - **GDPR Compliance**: Right to access, delete, export data
540
- - **Data Retention**: [Retention period, e.g., 90 days for logs]
541
- - **Third-Party Sharing**: [Who we share data with, why]
542
-
543
- ---
544
-
545
- ## Integrations
546
-
547
- ### Existing Integrations
548
-
549
- | Integration | Purpose | Priority |
550
- | ----------------- | --------- | -------- |
551
- | {{INTEGRATION_1}} | [Purpose] | P0 |
552
- | {{INTEGRATION_2}} | [Purpose] | P1 |
553
-
554
- ### Planned Integrations
555
-
556
- | Integration | Purpose | Timeline |
557
- | ----------------- | --------- | -------- |
558
- | {{INTEGRATION_3}} | [Purpose] | Q2 2025 |
559
- | {{INTEGRATION_4}} | [Purpose] | Q3 2025 |
560
-
561
- ---
562
-
563
- ## Changelog
564
-
565
- ### Version 1.1 (Planned)
566
-
567
- - [Future product updates]
568
-
569
- ---
570
-
571
- **Last Updated**: 2026-01-01
572
- **Maintained By**: {{MAINTAINER}}