musubi-sdd 5.0.0 → 5.6.1

package/src/templates/agents/claude-code/skills/system-architect/c4-model-guide.md

@@ -15,6 +15,7 @@ The C4 model is a set of hierarchical diagrams for visualizing software architec
 **Scope**: Single software system
 
 **Primary Elements**:
+
 - Your system (center)
 - Users (people)
 - External systems
@@ -24,16 +25,16 @@ The C4 model is a set of hierarchical diagrams for visualizing software architec
 ```mermaid
 C4Context
     title System Context Diagram - E-Commerce Platform
-    
+
     Person(customer, "Customer", "A user who purchases products")
     Person(admin, "Admin", "System administrator")
-    
+
     System(ecommerce, "E-Commerce Platform", "Allows customers to browse and purchase products")
-    
+
     System_Ext(payment, "Payment Gateway", "Processes credit card payments")
     System_Ext(shipping, "Shipping API", "Calculates shipping rates")
     System_Ext(email, "Email Service", "Sends transactional emails")
-    
+
     Rel(customer, ecommerce, "Browses, purchases")
     Rel(admin, ecommerce, "Manages products, orders")
     Rel(ecommerce, payment, "Processes payments")
@@ -42,21 +43,25 @@ C4Context
 ```
 
 **Template**:
+
 ```markdown
 ## Level 1: System Context
 
 ### System
+
 - **Name**: [System Name]
 - **Description**: [What the system does]
 
 ### Users
-| User | Description |
-|------|-------------|
+
+| User        | Description                  |
+| ----------- | ---------------------------- |
 | [User Type] | [User description and goals] |
 
 ### External Systems
-| System | Description | Integration |
-|--------|-------------|-------------|
+
+| System            | Description    | Integration        |
+| ----------------- | -------------- | ------------------ |
 | [External System] | [What it does] | [How we integrate] |
 ```
 
@@ -69,6 +74,7 @@ C4Context
 **Scope**: Single software system
 
 **Primary Elements**:
+
 - Containers (applications, data stores, etc.)
 - Relationships between containers
 
@@ -77,9 +83,9 @@ C4Context
 ```mermaid
 C4Container
     title Container Diagram - E-Commerce Platform
-    
+
     Person(customer, "Customer")
-    
+
     Container_Boundary(c1, "E-Commerce Platform") {
         Container(web, "Web Application", "React", "Delivers the web frontend")
         Container(api, "API Server", "Node.js/Express", "Provides REST API")
@@ -88,9 +94,9 @@ C4Container
         ContainerDb(cache, "Cache", "Redis", "Caches sessions, products")
         ContainerDb(queue, "Message Queue", "RabbitMQ", "Handles async messaging")
     }
-    
+
     System_Ext(payment, "Payment Gateway")
-    
+
     Rel(customer, web, "Uses", "HTTPS")
     Rel(web, api, "API calls", "HTTPS/JSON")
     Rel(api, db, "Reads/Writes")
@@ -101,26 +107,27 @@ C4Container
 ```
 
 **Template**:
+
 ```markdown
 ## Level 2: Container Diagram
 
 ### Containers
 
-| Container | Technology | Description |
-|-----------|------------|-------------|
-| Web App | React | Frontend SPA |
-| API Server | Node.js/Express | REST API backend |
-| Database | PostgreSQL | Persistent storage |
-| Cache | Redis | Session and data cache |
-| Queue | RabbitMQ | Async message processing |
+| Container  | Technology      | Description              |
+| ---------- | --------------- | ------------------------ |
+| Web App    | React           | Frontend SPA             |
+| API Server | Node.js/Express | REST API backend         |
+| Database   | PostgreSQL      | Persistent storage       |
+| Cache      | Redis           | Session and data cache   |
+| Queue      | RabbitMQ        | Async message processing |
 
 ### Communication
 
-| From | To | Protocol | Purpose |
-|------|----|-----------| --------|
-| Web App | API Server | HTTPS/REST | API calls |
-| API Server | Database | TCP | Data persistence |
-| API Server | Cache | TCP | Caching |
+| From       | To         | Protocol   | Purpose          |
+| ---------- | ---------- | ---------- | ---------------- |
+| Web App    | API Server | HTTPS/REST | API calls        |
+| API Server | Database   | TCP        | Data persistence |
+| API Server | Cache      | TCP        | Caching          |
 ```
 
 ---
@@ -132,6 +139,7 @@ C4Container
 **Scope**: Single container
 
 **Primary Elements**:
+
 - Components (modules, services, controllers)
 - Relationships between components
 
@@ -140,7 +148,7 @@ C4Container
 ```mermaid
 C4Component
     title Component Diagram - API Server
-    
+
     Container_Boundary(api, "API Server") {
         Component(auth, "Auth Controller", "Express Router", "Handles authentication")
         Component(user, "User Controller", "Express Router", "User CRUD operations")
@@ -150,9 +158,9 @@ C4Component
         Component(orderService, "Order Service", "TypeScript", "Order business logic")
         Component(repo, "Repository Layer", "TypeScript", "Data access abstraction")
     }
-    
+
     ContainerDb(db, "Database", "PostgreSQL")
-    
+
     Rel(auth, authService, "Uses")
     Rel(user, userService, "Uses")
     Rel(order, orderService, "Uses")
@@ -163,23 +171,24 @@ C4Component
 ```
 
 **Template**:
+
 ```markdown
 ## Level 3: Component Diagram - [Container Name]
 
 ### Components
 
-| Component | Type | Responsibility |
-|-----------|------|----------------|
+| Component       | Type       | Responsibility        |
+| --------------- | ---------- | --------------------- |
 | Auth Controller | Controller | Handle auth endpoints |
-| Auth Service | Service | Authentication logic |
-| User Repository | Repository | User data access |
+| Auth Service    | Service    | Authentication logic  |
+| User Repository | Repository | User data access      |
 
 ### Dependencies
 
-| Component | Depends On | Purpose |
-|-----------|------------|---------|
-| Auth Controller | Auth Service | Business logic |
-| Auth Service | User Repository | Data access |
+| Component       | Depends On      | Purpose        |
+| --------------- | --------------- | -------------- |
+| Auth Controller | Auth Service    | Business logic |
+| Auth Service    | User Repository | Data access    |
 ```
 
 ---
@@ -191,6 +200,7 @@ C4Component
 **Scope**: Single component
 
 **Primary Elements**:
+
 - Classes, interfaces, modules
 - Relationships (inheritance, composition)
 
@@ -208,18 +218,18 @@ classDiagram
         +validateToken(token): boolean
         +refreshToken(token): string
     }
-    
+
     class UserRepository {
         +findByEmail(email): User
         +create(user): User
         +update(id, data): User
     }
-    
+
     class JwtService {
         +sign(payload): string
         +verify(token): Payload
     }
-    
+
     AuthService --> UserRepository
     AuthService --> JwtService
 ```
@@ -230,14 +240,14 @@ classDiagram
 
 ### Element Types
 
-| Element | Notation | Description |
-|---------|----------|-------------|
-| Person | ![Person](stick figure) | A user of the system |
-| System | ![System](box) | The system being described |
-| External System | ![External](dashed box) | External dependency |
-| Container | ![Container](box in system) | Deployable unit |
-| Component | ![Component](box in container) | Code module |
-| Database | ![Database](cylinder) | Data storage |
+| Element         | Notation                       | Description                |
+| --------------- | ------------------------------ | -------------------------- |
+| Person          | ![Person](stick figure)        | A user of the system       |
+| System          | ![System](box)                 | The system being described |
+| External System | ![External](dashed box)        | External dependency        |
+| Container       | ![Container](box in system)    | Deployable unit            |
+| Component       | ![Component](box in container) | Code module                |
+| Database        | ![Database](cylinder)          | Data storage               |
 
 ### Relationship Arrows
 
@@ -282,27 +292,30 @@ Examples:
 [Mermaid diagram]
 
 ### Systems and Users
+
 | Element | Type | Description |
-|---------|------|-------------|
-| | | |
+| ------- | ---- | ----------- |
+|         |      |             |
 
 ## Level 2: Container Diagram
 
 [Mermaid diagram]
 
 ### Containers
+
 | Container | Technology | Purpose |
-|-----------|------------|---------|
-| | | |
+| --------- | ---------- | ------- |
+|           |            |         |
 
 ## Level 3: Component Diagram - [Container]
 
 [Mermaid diagram]
 
 ### Components
+
 | Component | Type | Responsibility |
-|-----------|------|----------------|
-| | | |
+| --------- | ---- | -------------- |
+|           |      |                |
 
 ## Technology Decisions
 
@@ -310,8 +323,8 @@ See ADR-XXX for rationale.
 
 ## Requirements Traceability
 
-| REQ ID | Addressed By |
-|--------|--------------|
+| REQ ID  | Addressed By |
+| ------- | ------------ |
 | REQ-001 | Auth Service |
 ```
 
@@ -319,10 +332,10 @@ See ADR-XXX for rationale.
 
 ## Tools for C4 Diagrams
 
-| Tool | Format | Notes |
-|------|--------|-------|
-| Mermaid | Markdown | Recommended - works in GitHub |
-| PlantUML | Text | Rich features |
-| Structurizr | DSL | Official C4 tooling |
-| Draw.io | Visual | Easy for non-technical |
-| Lucidchart | Visual | Collaboration features |
+| Tool        | Format   | Notes                         |
+| ----------- | -------- | ----------------------------- |
+| Mermaid     | Markdown | Recommended - works in GitHub |
+| PlantUML    | Text     | Rich features                 |
+| Structurizr | DSL      | Official C4 tooling           |
+| Draw.io     | Visual   | Easy for non-technical        |
+| Lucidchart  | Visual   | Collaboration features        |

package/src/templates/agents/claude-code/skills/technical-writer/doc-templates/documentation-templates.md

@@ -25,10 +25,13 @@ Brief description of what this project does.
 ## Quick Start
 
 \`\`\`bash
+
 # Install
+
 npm install project-name
 
 # Run
+
 npx project-name
 \`\`\`
 
@@ -72,10 +75,10 @@ See [Advanced Guide](docs/advanced.md) for more options.
 
 ## Configuration
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `port` | number | 3000 | Server port |
-| `debug` | boolean | false | Enable debug mode |
+| Option  | Type    | Default | Description       |
+| ------- | ------- | ------- | ----------------- |
+| `port`  | number  | 3000    | Server port       |
+| `debug` | boolean | false   | Enable debug mode |
 
 ## API Reference
 
@@ -117,26 +120,26 @@ GET /api/v1/users
 
 **Query Parameters**
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| page | integer | No | Page number (default: 1) |
-| limit | integer | No | Items per page (default: 20) |
+| Parameter | Type    | Required | Description                  |
+| --------- | ------- | -------- | ---------------------------- |
+| page      | integer | No       | Page number (default: 1)     |
+| limit     | integer | No       | Items per page (default: 20) |
 
 **Response**
 
 \`\`\`json
 {
-  "data": [
-    {
-      "id": "123",
-      "name": "John Doe",
-      "email": "john@example.com"
-    }
-  ],
-  "meta": {
-    "total": 100,
-    "page": 1
-  }
+"data": [
+{
+"id": "123",
+"name": "John Doe",
+"email": "john@example.com"
+}
+],
+"meta": {
+"total": 100,
+"page": 1
+}
 }
 \`\`\`
 
@@ -148,19 +151,19 @@ GET /api/v1/users/:id
 
 **Path Parameters**
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| id | string | User ID |
+| Parameter | Type   | Description |
+| --------- | ------ | ----------- |
+| id        | string | User ID     |
 
 **Response**
 
 \`\`\`json
 {
-  "data": {
-    "id": "123",
-    "name": "John Doe",
-    "email": "john@example.com"
-  }
+"data": {
+"id": "123",
+"name": "John Doe",
+"email": "john@example.com"
+}
 }
 \`\`\`
 
@@ -174,9 +177,9 @@ POST /api/v1/users
 
 \`\`\`json
 {
-  "name": "John Doe",
-  "email": "john@example.com",
-  "password": "secret123"
+"name": "John Doe",
+"email": "john@example.com",
+"password": "secret123"
 }
 \`\`\`
 
@@ -184,38 +187,38 @@ POST /api/v1/users
 
 \`\`\`json
 {
-  "data": {
-    "id": "123",
-    "name": "John Doe",
-    "email": "john@example.com"
-  }
+"data": {
+"id": "123",
+"name": "John Doe",
+"email": "john@example.com"
+}
 }
 \`\`\`
 
 ## Error Responses
 
-| Status | Code | Description |
-|--------|------|-------------|
-| 400 | VALIDATION_ERROR | Invalid request data |
-| 401 | UNAUTHORIZED | Authentication required |
-| 403 | FORBIDDEN | Insufficient permissions |
-| 404 | NOT_FOUND | Resource not found |
-| 500 | INTERNAL_ERROR | Server error |
+| Status | Code             | Description              |
+| ------ | ---------------- | ------------------------ |
+| 400    | VALIDATION_ERROR | Invalid request data     |
+| 401    | UNAUTHORIZED     | Authentication required  |
+| 403    | FORBIDDEN        | Insufficient permissions |
+| 404    | NOT_FOUND        | Resource not found       |
+| 500    | INTERNAL_ERROR   | Server error             |
 
 **Error Format**
 
 \`\`\`json
 {
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Invalid request data",
-    "details": [
-      {
-        "field": "email",
-        "message": "Invalid email format"
-      }
-    ]
-  }
+"error": {
+"code": "VALIDATION_ERROR",
+"message": "Invalid request data",
+"details": [
+{
+"field": "email",
+"message": "Invalid email format"
+}
+]
+}
 }
 \`\`\`
 ```
@@ -270,17 +273,22 @@ Please read our [Code of Conduct](CODE_OF_CONDUCT.md).
 ## Development Setup
 
 \`\`\`bash
+
 # Clone
+
 git clone https://github.com/org/project.git
 cd project
 
 # Install
+
 npm install
 
 # Run tests
+
 npm test
 
 # Run dev server
+
 npm run dev
 \`\`\`
 
@@ -322,23 +330,28 @@ YYYY-MM-DD
 ## Consequences
 
 ### Positive
+
 - [Benefit 1]
 - [Benefit 2]
 
 ### Negative
+
 - [Downside 1]
 - [Downside 2]
 
 ### Neutral
+
 - [Trade-off 1]
 
 ## Alternatives Considered
 
 ### Option A
+
 - Pros: [...]
 - Cons: [...]
 
 ### Option B
+
 - Pros: [...]
 - Cons: [...]
 
@@ -398,9 +411,11 @@ If something goes wrong:
 ## Troubleshooting
 
 ### Issue: [Description]
+
 **Solution**: [How to fix]
 
 ### Issue: [Description]
+
 **Solution**: [How to fix]
 
 ## Contacts
@@ -414,6 +429,7 @@ If something goes wrong:
 ## Documentation Checklist
 
 ### README
+
 - [ ] Project description
 - [ ] Quick start guide
 - [ ] Installation steps
@@ -423,6 +439,7 @@ If something goes wrong:
 - [ ] License
 
 ### API Docs
+
 - [ ] Authentication explained
 - [ ] All endpoints documented
 - [ ] Request/response examples
@@ -430,6 +447,7 @@ If something goes wrong:
 - [ ] Rate limits mentioned
 
 ### Code Docs
+
 - [ ] Functions documented
 - [ ] Parameters described
 - [ ] Return values explained

package/src/templates/agents/claude-code/skills/test-engineer/SKILL.md

@@ -166,11 +166,13 @@ musubi-workflow next deployment
 ### テスト結果に応じたアクション
 
 **テスト成功の場合**:
+
 ```bash
 musubi-workflow next deployment
 ```
 
 **テスト失敗の場合（フィードバックループ）**:
+
 ```bash
 # 実装に問題がある場合
 musubi-workflow feedback testing implementation -r "テスト失敗: バグを発見"