speccrew 0.7.8 → 0.7.10

package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-FASTAPI.md

@@ -11,10 +11,10 @@
 
 | # | File | Source |
 |---|------|--------|
-| 1 | {router} | [View](../../{routerSourcePath}) |
-| 2 | {service} | [View](../../{serviceSourcePath}) |
-| 3 | {model} | [View](../../{modelSourcePath}) |
-| 4 | {schema} | [View](../../{schemaSourcePath}) |
+| 1 | {router} | [View](../../../../../../{routerSourcePath}) |
+| 2 | {service} | [View](../../../../../../{serviceSourcePath}) |
+| 3 | {model} | [View](../../../../../../{modelSourcePath}) |
+| 4 | {schema} | [View](../../../../../../{schemaSourcePath}) |
 
 ---
 
@@ -152,11 +152,11 @@ graph TB
 
 | # | Layer | File | Function/Class | Responsibility | Source |
 |---|-------|------|----------------|----------------|--------|
-| 1 | Router | {users.py} | {create_user} | Receive request, validate params, call service | [Source](../../{routerSourcePath}) |
-| 2 | Service | {user_service.py} | {create_user} | Business validation, data processing, call CRUD | [Source](../../{serviceSourcePath}) |
-| 3 | Service | {user_service.py} | {validate_user_email} | Check email uniqueness | [Source](../../{serviceSourcePath}) |
-| 4 | CRUD | {user_crud.py} | {create} | Execute INSERT via SQLAlchemy | [Source](../../{crudSourcePath}) |
-| 5 | Model | {user.py} | {User model} | SQLAlchemy ORM model definition | [Source](../../{modelSourcePath}) |
+| 1 | Router | {users.py} | {create_user} | Receive request, validate params, call service | [Source](../../../../../../{routerSourcePath}) |
+| 2 | Service | {user_service.py} | {create_user} | Business validation, data processing, call CRUD | [Source](../../../../../../{serviceSourcePath}) |
+| 3 | Service | {user_service.py} | {validate_user_email} | Check email uniqueness | [Source](../../../../../../{serviceSourcePath}) |
+| 4 | CRUD | {user_crud.py} | {create} | Execute INSERT via SQLAlchemy | [Source](../../../../../../{crudSourcePath}) |
+| 5 | Model | {user.py} | {User model} | SQLAlchemy ORM model definition | [Source](../../../../../../{modelSourcePath}) |
 
 **Database Operations:**
 
@@ -213,7 +213,7 @@ graph TB
 | {related_table} | {One-to-Many} | {ForeignKey("related.id")} | {Relationship description} |
 | {another_table} | {Many-to-One} | {ForeignKey("another.id")} | {Relationship description} |
 
-**Source:** [Model](../../{modelSourcePath})
+**Source:** [Model](../../../../../../{modelSourcePath})
 
 ### 3.2 Model-Database Mapping
 
@@ -260,23 +260,23 @@ class {UserResponse}(BaseModel):
 
 | Service Name | Purpose | Source Path |
 |--------------|---------|-------------|
-| {user_service} | {e.g., User business logic} | [Source](../../{serviceSourcePath}) |
-| {auth_service} | {e.g., Authentication validation} | [Source](../../{serviceSourcePath}) |
+| {user_service} | {e.g., User business logic} | [Source](../../../../../../{serviceSourcePath}) |
+| {auth_service} | {e.g., Authentication validation} | [Source](../../../../../../{serviceSourcePath}) |
 
 ### 4.2 Data Access Layer
 
 | CRUD/Repository | Model | Purpose | Source Path |
 |-----------------|-------|---------|-------------|
-| {user_crud} | {User} | {e.g., User CRUD operations} | [Source](../../{crudSourcePath}) |
-| {role_crud} | {Role} | {e.g., Role query} | [Source](../../{crudSourcePath}) |
+| {user_crud} | {User} | {e.g., User CRUD operations} | [Source](../../../../../../{crudSourcePath}) |
+| {role_crud} | {Role} | {e.g., Role query} | [Source](../../../../../../{crudSourcePath}) |
 
 ### 4.3 Schemas and Models
 
 | Class Name | Type | Purpose | Source Path |
 |------------|------|---------|-------------|
-| {UserCreate} | Request Schema | {e.g., Create user request} | [Source](../../{schemaSourcePath}) |
-| {UserResponse} | Response Schema | {e.g., User detail response} | [Source](../../{schemaSourcePath}) |
-| {User} | SQLAlchemy Model | {e.g., User database model} | [Source](../../{modelSourcePath}) |
+| {UserCreate} | Request Schema | {e.g., Create user request} | [Source](../../../../../../{schemaSourcePath}) |
+| {UserResponse} | Response Schema | {e.g., User detail response} | [Source](../../../../../../{schemaSourcePath}) |
+| {User} | SQLAlchemy Model | {e.g., User database model} | [Source](../../../../../../{modelSourcePath}) |
 
 ### 4.4 API Consumers
 
@@ -284,8 +284,8 @@ class {UserResponse}(BaseModel):
 
 | Page Name | Function Description | Source Path | Document Path |
 |-----------|---------------------|-------------|---------------|
-| {PageName} | {e.g., User management list page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
-| {PageName} | {e.g., User form page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
+| {PageName} | {e.g., User management list page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
+| {PageName} | {e.g., User form page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
 
 ---
 
@@ -339,7 +339,7 @@ graph LR
 ```
 
 **Diagram Source**
-- [{Service}.py](../../{serviceSourcePath})
+- [{Service}.py](../../../../../../{serviceSourcePath})
 
 ### 6.3 External Dependencies
 
@@ -458,6 +458,6 @@ router = APIRouter(
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Router}.py](../../{routerSourcePath})
-- [{Service}.py](../../{serviceSourcePath})
-- [{Model}.py](../../{modelSourcePath})
+- [{Router}.py](../../../../../../{routerSourcePath})
+- [{Service}.py](../../../../../../{serviceSourcePath})
+- [{Model}.py](../../../../../../{modelSourcePath})

package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-JAVA.md

@@ -11,10 +11,10 @@
 
 | # | File | Source |
 |---|------|--------|
-| 1 | {Controller} | [View](../../{controllerSourcePath}) |
-| 2 | {Service} | [View](../../{serviceSourcePath}) |
-| 3 | {Entity} | [View](../../{entitySourcePath}) |
-| 4 | {DTO} | [View](../../{dtoSourcePath}) |
+| 1 | {Controller} | [View](../../../../../../{controllerSourcePath}) |
+| 2 | {Service} | [View](../../../../../../{serviceSourcePath}) |
+| 3 | {Entity} | [View](../../../../../../{entitySourcePath}) |
+| 4 | {DTO} | [View](../../../../../../{dtoSourcePath}) |
 
 ---
 
@@ -156,11 +156,11 @@ graph TB
 
 | # | Layer | Class | Method | Responsibility | Source |
 |---|-------|-------|--------|----------------|--------|
-| 1 | Controller | {UserController} | {createUser} | Receive request, validate params, call service | [Source](../../{controllerSourcePath}) |
-| 2 | Service | {UserService} | {createUser} | Business validation, data processing, call mapper | [Source](../../{serviceSourcePath}) |
-| 3 | Service | {UserService} | {validateUserName} | Check user name uniqueness | [Source](../../{serviceSourcePath}) |
-| 4 | Mapper | {UserMapper} | {insert} | Execute INSERT SQL | [Source](../../{mapperSourcePath}) |
-| 5 | Mapper XML | {UserMapper.xml} | {insert} | SQL: INSERT INTO user (...) VALUES (...) | [Source](../../{mapperXmlSourcePath}) |
+| 1 | Controller | {UserController} | {createUser} | Receive request, validate params, call service | [Source](../../../../../../{controllerSourcePath}) |
+| 2 | Service | {UserService} | {createUser} | Business validation, data processing, call mapper | [Source](../../../../../../{serviceSourcePath}) |
+| 3 | Service | {UserService} | {validateUserName} | Check user name uniqueness | [Source](../../../../../../{serviceSourcePath}) |
+| 4 | Mapper | {UserMapper} | {insert} | Execute INSERT SQL | [Source](../../../../../../{mapperSourcePath}) |
+| 5 | Mapper XML | {UserMapper.xml} | {insert} | SQL: INSERT INTO user (...) VALUES (...) | [Source](../../../../../../{mapperXmlSourcePath}) |
 
 **Database Operations:**
 
@@ -217,7 +217,7 @@ graph TB
 | {related_table} | {One-to-Many} | {this_table.related_id} | {Relationship description} |
 | {another_table} | {Many-to-One} | {this_table.parent_id} | {Relationship description} |
 
-**Source:** [Entity](../../{entitySourcePath}) | [Mapper XML](../../{mapperXmlSourcePath})
+**Source:** [Entity](../../../../../../{entitySourcePath}) | [Mapper XML](../../../../../../{mapperXmlSourcePath})
 
 ### 3.2 Entity-Database Mapping
 
@@ -266,23 +266,23 @@ graph TB
 
 | Service Name | Purpose | Source Path |
 |--------------|---------|-------------|
-| {ServiceName} | {e.g., User business logic} | [Source](../../{serviceSourcePath}) |
-| {ServiceName} | {e.g., Permission validation} | [Source](../../{serviceSourcePath}) |
+| {ServiceName} | {e.g., User business logic} | [Source](../../../../../../{serviceSourcePath}) |
+| {ServiceName} | {e.g., Permission validation} | [Source](../../../../../../{serviceSourcePath}) |
 
 ### 4.2 Data Access Layer
 
 | Mapper/Repository | Entity | Purpose | Source Path |
 |-------------------|--------|---------|-------------|
-| {MapperName} | {EntityName} | {e.g., User CRUD operations} | [Source](../../{mapperSourcePath}) |
-| {MapperName} | {EntityName} | {e.g., Role query} | [Source](../../{mapperSourcePath}) |
+| {MapperName} | {EntityName} | {e.g., User CRUD operations} | [Source](../../../../../../{mapperSourcePath}) |
+| {MapperName} | {EntityName} | {e.g., Role query} | [Source](../../../../../../{mapperSourcePath}) |
 
 ### 4.3 DTOs and Entities
 
 | Class Name | Type | Purpose | Source Path |
 |------------|------|---------|-------------|
-| {DTOClass} | Request DTO | {e.g., Create user request} | [Source](../../{dtoSourcePath}) |
-| {VOClass} | Response VO | {e.g., User detail response} | [Source](../../{voSourcePath}) |
-| {EntityClass} | Entity | {e.g., User database entity} | [Source](../../{entitySourcePath}) |
+| {DTOClass} | Request DTO | {e.g., Create user request} | [Source](../../../../../../{dtoSourcePath}) |
+| {VOClass} | Response VO | {e.g., User detail response} | [Source](../../../../../../{voSourcePath}) |
+| {EntityClass} | Entity | {e.g., User database entity} | [Source](../../../../../../{entitySourcePath}) |
 
 ### 4.4 API Consumers
 
@@ -290,8 +290,8 @@ graph TB
 
 | Page Name | Function Description | Source Path | Document Path |
 |-----------|---------------------|-------------|---------------|
-| {PageName} | {e.g., User management list page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
-| {PageName} | {e.g., User form page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
+| {PageName} | {e.g., User management list page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
+| {PageName} | {e.g., User form page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
 
 ---
 
@@ -346,7 +346,7 @@ graph LR
 ```
 
 **Diagram Source**
-- [{Service}.java](../../{serviceSourcePath})
+- [{Service}.java](../../../../../../{serviceSourcePath})
 
 ### 6.3 External Dependencies
 
@@ -476,6 +476,6 @@ feature:
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Controller}.java](../../{controllerSourcePath})
-- [{Service}.java](../../{serviceSourcePath})
-- [{Entity}.java](../../{entitySourcePath})
+- [{Controller}.java](../../../../../../{controllerSourcePath})
+- [{Service}.java](../../../../../../{serviceSourcePath})
+- [{Entity}.java](../../../../../../{entitySourcePath})

package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-NET.md

@@ -11,10 +11,10 @@
 
 | # | File | Source |
 |---|------|--------|
-| 1 | {Controller} | [View](../../{controllerSourcePath}) |
-| 2 | {Service} | [View](../../{serviceSourcePath}) |
-| 3 | {Repository} | [View](../../{repositorySourcePath}) |
-| 4 | {Entity} | [View](../../{entitySourcePath}) |
+| 1 | {Controller} | [View](../../../../../../{controllerSourcePath}) |
+| 2 | {Service} | [View](../../../../../../{serviceSourcePath}) |
+| 3 | {Repository} | [View](../../../../../../{repositorySourcePath}) |
+| 4 | {Entity} | [View](../../../../../../{entitySourcePath}) |
 
 ---
 
@@ -152,11 +152,11 @@ graph TB
 
 | # | Layer | File | Method/Class | Responsibility | Source |
 |---|-------|------|--------------|----------------|--------|
-| 1 | Controller | {UsersController.cs} | {CreateUser} | Receive request, validate params, call service | [Source](../../{controllerSourcePath}) |
-| 2 | Service | {UserService.cs} | {CreateUserAsync} | Business validation, data processing, call repository | [Source](../../{serviceSourcePath}) |
-| 3 | Service | {UserService.cs} | {ValidateUserEmailAsync} | Check email uniqueness | [Source](../../{serviceSourcePath}) |
-| 4 | Repository | {UserRepository.cs} | {AddAsync} | Execute Add via EF Core | [Source](../../{repositorySourcePath}) |
-| 5 | Entity | {User.cs} | {User entity} | EF Core entity definition | [Source](../../{entitySourcePath}) |
+| 1 | Controller | {UsersController.cs} | {CreateUser} | Receive request, validate params, call service | [Source](../../../../../../{controllerSourcePath}) |
+| 2 | Service | {UserService.cs} | {CreateUserAsync} | Business validation, data processing, call repository | [Source](../../../../../../{serviceSourcePath}) |
+| 3 | Service | {UserService.cs} | {ValidateUserEmailAsync} | Check email uniqueness | [Source](../../../../../../{serviceSourcePath}) |
+| 4 | Repository | {UserRepository.cs} | {AddAsync} | Execute Add via EF Core | [Source](../../../../../../{repositorySourcePath}) |
+| 5 | Entity | {User.cs} | {User entity} | EF Core entity definition | [Source](../../../../../../{entitySourcePath}) |
 
 **Database Operations:**
 
@@ -213,7 +213,7 @@ graph TB
 | {RelatedTable} | {One-to-Many} | {RelatedId} | {Relationship description} |
 | {AnotherTable} | {Many-to-One} | {AnotherId} | {Relationship description} |
 
-**Source:** [Entity](../../{entitySourcePath}) | [DbContext](../../{dbContextSourcePath})
+**Source:** [Entity](../../../../../../{entitySourcePath}) | [DbContext](../../../../../../{dbContextSourcePath})
 
 ### 3.2 Entity-Database Mapping
 
@@ -262,23 +262,23 @@ public class {UserResponse}
 
 | Service Name | Purpose | Source Path |
 |--------------|---------|-------------|
-| {IUserService} | {e.g., User business logic interface} | [Source](../../{serviceInterfaceSourcePath}) |
-| {UserService} | {e.g., User business logic implementation} | [Source](../../{serviceSourcePath}) |
+| {IUserService} | {e.g., User business logic interface} | [Source](../../../../../../{serviceInterfaceSourcePath}) |
+| {UserService} | {e.g., User business logic implementation} | [Source](../../../../../../{serviceSourcePath}) |
 
 ### 4.2 Data Access Layer
 
 | Repository | Entity | Purpose | Source Path |
 |------------|--------|---------|-------------|
-| {IUserRepository} | {User} | {e.g., User repository interface} | [Source](../../{repositoryInterfaceSourcePath}) |
-| {UserRepository} | {User} | {e.g., User repository implementation} | [Source](../../{repositorySourcePath}) |
+| {IUserRepository} | {User} | {e.g., User repository interface} | [Source](../../../../../../{repositoryInterfaceSourcePath}) |
+| {UserRepository} | {User} | {e.g., User repository implementation} | [Source](../../../../../../{repositorySourcePath}) |
 
 ### 4.3 DTOs and Entities
 
 | Class Name | Type | Purpose | Source Path |
 |------------|------|---------|-------------|
-| {CreateUserRequest} | Request DTO | {e.g., Create user request} | [Source](../../{dtoSourcePath}) |
-| {UserResponse} | Response DTO | {e.g., User detail response} | [Source](../../{dtoSourcePath}) |
-| {User} | EF Core Entity | {e.g., User database entity} | [Source](../../{entitySourcePath}) |
+| {CreateUserRequest} | Request DTO | {e.g., Create user request} | [Source](../../../../../../{dtoSourcePath}) |
+| {UserResponse} | Response DTO | {e.g., User detail response} | [Source](../../../../../../{dtoSourcePath}) |
+| {User} | EF Core Entity | {e.g., User database entity} | [Source](../../../../../../{entitySourcePath}) |
 
 ### 4.4 API Consumers
 
@@ -286,8 +286,8 @@ public class {UserResponse}
 
 | Page Name | Function Description | Source Path | Document Path |
 |-----------|---------------------|-------------|---------------|
-| {PageName} | {e.g., User management list page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
-| {PageName} | {e.g., User form page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
+| {PageName} | {e.g., User management list page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
+| {PageName} | {e.g., User form page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
 
 ---
 
@@ -341,7 +341,7 @@ graph LR
 ```
 
 **Diagram Source**
-- [{Service}.cs](../../{serviceSourcePath})
+- [{Service}.cs](../../../../../../{serviceSourcePath})
 
 ### 6.3 External Dependencies
 
@@ -460,6 +460,6 @@ builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Controller}.cs](../../{controllerSourcePath})
-- [{Service}.cs](../../{serviceSourcePath})
-- [{Entity}.cs](../../{entitySourcePath})
+- [{Controller}.cs](../../../../../../{controllerSourcePath})
+- [{Service}.cs](../../../../../../{serviceSourcePath})
+- [{Entity}.cs](../../../../../../{entitySourcePath})

package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE.md

@@ -11,10 +11,10 @@
 
 | # | File | Source |
 |---|------|--------|
-| 1 | {Controller} | [View](../../{controllerSourcePath}) |
-| 2 | {Service} | [View](../../{serviceSourcePath}) |
-| 3 | {Entity} | [View](../../{entitySourcePath}) |
-| 4 | {DTO} | [View](../../{dtoSourcePath}) |
+| 1 | {Controller} | [View](../../../../../../{controllerSourcePath}) |
+| 2 | {Service} | [View](../../../../../../{serviceSourcePath}) |
+| 3 | {Entity} | [View](../../../../../../{entitySourcePath}) |
+| 4 | {DTO} | [View](../../../../../../{dtoSourcePath}) |
 
 ---
 
@@ -156,11 +156,11 @@ graph TB
 
 | # | Layer | Class | Method | Responsibility | Source |
 |---|-------|-------|--------|----------------|--------|
-| 1 | Controller | {UserController} | {createUser} | Receive request, validate params, call service | [Source](../../{controllerSourcePath}) |
-| 2 | Service | {UserService} | {createUser} | Business validation, data processing, call mapper | [Source](../../{serviceSourcePath}) |
-| 3 | Service | {UserService} | {validateUserName} | Check user name uniqueness | [Source](../../{serviceSourcePath}) |
-| 4 | Mapper | {UserMapper} | {insert} | Execute INSERT SQL | [Source](../../{mapperSourcePath}) |
-| 5 | Mapper XML | {UserMapper.xml} | {insert} | SQL: INSERT INTO user (...) VALUES (...) | [Source](../../{mapperXmlSourcePath}) |
+| 1 | Controller | {UserController} | {createUser} | Receive request, validate params, call service | [Source](../../../../../../{controllerSourcePath}) |
+| 2 | Service | {UserService} | {createUser} | Business validation, data processing, call mapper | [Source](../../../../../../{serviceSourcePath}) |
+| 3 | Service | {UserService} | {validateUserName} | Check user name uniqueness | [Source](../../../../../../{serviceSourcePath}) |
+| 4 | Mapper | {UserMapper} | {insert} | Execute INSERT SQL | [Source](../../../../../../{mapperSourcePath}) |
+| 5 | Mapper XML | {UserMapper.xml} | {insert} | SQL: INSERT INTO user (...) VALUES (...) | [Source](../../../../../../{mapperXmlSourcePath}) |
 
 **Database Operations:**
 
@@ -217,7 +217,7 @@ graph TB
 | {related_table} | {One-to-Many} | {this_table.related_id} | {Relationship description} |
 | {another_table} | {Many-to-One} | {this_table.parent_id} | {Relationship description} |
 
-**Source:** [Entity](../../{entitySourcePath}) | [Mapper XML](../../{mapperXmlSourcePath})
+**Source:** [Entity](../../../../../../{entitySourcePath}) | [Mapper XML](../../../../../../{mapperXmlSourcePath})
 
 ### 3.2 Entity-Database Mapping
 
@@ -266,23 +266,23 @@ graph TB
 
 | Service Name | Purpose | Source Path |
 |--------------|---------|-------------|
-| {ServiceName} | {e.g., User business logic} | [Source](../../{serviceSourcePath}) |
-| {ServiceName} | {e.g., Permission validation} | [Source](../../{serviceSourcePath}) |
+| {ServiceName} | {e.g., User business logic} | [Source](../../../../../../{serviceSourcePath}) |
+| {ServiceName} | {e.g., Permission validation} | [Source](../../../../../../{serviceSourcePath}) |
 
 ### 4.2 Data Access Layer
 
 | Mapper/Repository | Entity | Purpose | Source Path |
 |-------------------|--------|---------|-------------|
-| {MapperName} | {EntityName} | {e.g., User CRUD operations} | [Source](../../{mapperSourcePath}) |
-| {MapperName} | {EntityName} | {e.g., Role query} | [Source](../../{mapperSourcePath}) |
+| {MapperName} | {EntityName} | {e.g., User CRUD operations} | [Source](../../../../../../{mapperSourcePath}) |
+| {MapperName} | {EntityName} | {e.g., Role query} | [Source](../../../../../../{mapperSourcePath}) |
 
 ### 4.3 DTOs and Entities
 
 | Class Name | Type | Purpose | Source Path |
 |------------|------|---------|-------------|
-| {DTOClass} | Request DTO | {e.g., Create user request} | [Source](../../{dtoSourcePath}) |
-| {VOClass} | Response VO | {e.g., User detail response} | [Source](../../{voSourcePath}) |
-| {EntityClass} | Entity | {e.g., User database entity} | [Source](../../{entitySourcePath}) |
+| {DTOClass} | Request DTO | {e.g., Create user request} | [Source](../../../../../../{dtoSourcePath}) |
+| {VOClass} | Response VO | {e.g., User detail response} | [Source](../../../../../../{voSourcePath}) |
+| {EntityClass} | Entity | {e.g., User database entity} | [Source](../../../../../../{entitySourcePath}) |
 
 ### 4.4 API Consumers
 
@@ -290,8 +290,8 @@ graph TB
 
 | Page Name | Function Description | Source Path | Document Path |
 |-----------|---------------------|-------------|---------------|
-| {PageName} | {e.g., User management list page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
-| {PageName} | {e.g., User form page} | [Source](../../{pageSourcePath}) | [Doc](../../{pageDocumentPath}) |
+| {PageName} | {e.g., User management list page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
+| {PageName} | {e.g., User form page} | [Source](../../../../../../{pageSourcePath}) | [Doc](../../../../../../{pageDocumentPath}) |
 
 ---
 
@@ -346,7 +346,7 @@ graph LR
 ```
 
 **Diagram Source**
-- [{Service}.java](../../{serviceSourcePath})
+- [{Service}.java](../../../../../../{serviceSourcePath})
 
 ### 6.3 External Dependencies
 
@@ -476,6 +476,6 @@ feature:
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Controller}.java](../../{controllerSourcePath})
-- [{Service}.java](../../{serviceSourcePath})
-- [{Entity}.java](../../{entitySourcePath})
+- [{Controller}.java](../../../../../../{controllerSourcePath})
+- [{Service}.java](../../../../../../{serviceSourcePath})
+- [{Entity}.java](../../../../../../{entitySourcePath})

package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/workflow.agentflow.xml

@@ -320,11 +320,6 @@
   </block>
   
   <!-- ==================== STEP 5B: FILL EACH SECTION USING SEARCH_REPLACE ==================== -->
-  <!-- Calculate Dynamic Path Prefix -->
-  <block type="task" id="B17" action="calculate-path-prefix" desc="Calculate path prefix">
-    <field name="documentPath" value="${documentPath}"/>
-    <field name="output" var="pathPrefix" from="calculation.prefix"/>
-  </block>
   
   <!-- Section 1: Content Overview -->
   <block type="task" id="B18" action="search_replace" desc="Fill overview section">
@@ -479,6 +474,14 @@
     <field name="verify" value="file.exists(${completed_dir}/${markerName}.done.json)"/>
   </block>
   
+  <!-- ==================== MANDATORY GRAPH WRITE RULE ==================== -->
+  <block type="rule" id="R-GRAPH" level="mandatory" desc="Graph data write is MANDATORY">
+    <field name="text">MANDATORY: You MUST execute ALL graph write blocks (B32a through B32g) before proceeding to O1.</field>
+    <field name="text">Graph data (nodes + edges) MUST be appended to knowledges/bizs/graph/nodes.json and edges.json.</field>
+    <field name="text">DO NOT skip graph write. DO NOT jump directly to O1 output block.</field>
+    <field name="text">If graph directory does not exist, create it first.</field>
+  </block>
+    
   <!-- Step 7b: Construct and Append Graph Data -->
   <!-- Construct Graph Nodes from API Analysis -->
   <block type="task" id="B32a" action="analyze" desc="Construct API endpoint nodes">
@@ -612,6 +615,7 @@ console.log('Edges appended:', newEdges.length);
     <field name="featureName" from="step6-report.feature_name"/>
     <field name="generatedFile" from="step6-report.generated_file"/>
     <field name="message" from="step6-report.message"/>
+    <field name="graph_status" value="nodes and edges written to knowledges/bizs/graph/"/>
   </block>
   
   <!-- ==================== ERROR HANDLING ==================== -->

package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md

@@ -129,7 +129,7 @@ Stage 4: System Summary
     <field name="changed_files" required="false" type="array" desc="(incremental only) Pre-computed changed file list"/>
     <field name="max_concurrent_workers" required="false" type="number" default="5" desc="Maximum parallel Worker count"/>
     <field name="workspace_path" required="true" type="string" desc="Absolute path to speccrew-workspace directory"/>
-    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/"/>
+    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/ (✓ correct: .../knowledges/base/sync-state/knowledge-bizs/ | ✗ wrong: .../knowledges/bizs/sync-state/knowledge-bizs/)"/>
     <field name="ide_skills_dir" required="true" type="string" desc="Absolute path to IDE-specific skills directory (e.g., .qoder/skills/, .cursor/skills/, .claude/skills/) where skill scripts are deployed"/>
     <field name="configs_dir" required="true" type="string" desc="Absolute path to docs/configs/ directory"/>
     <field name="graph_root" required="false" type="string" desc="Graph data output root path (absolute path preferred)" default="${workspace_path}/knowledges/bizs/graph"/>
@@ -184,6 +184,13 @@ Stage 4: System Summary
       <field name="text">Missing a platform means incomplete knowledge base generation</field>
     </block>
 
+    <block type="rule" id="S0-R2" level="mandatory" desc="platformId format constraints">
+      <field name="text">platformId MUST use format: {platformType}-{techStack}</field>
+      <field name="text">platformType values: web (NOT frontend), mobile, desktop, backend</field>
+      <field name="text">✓ Correct: backend-fastapi, web-vue3, mobile-uniapp, desktop-electron</field>
+      <field name="text">✗ Wrong: backend-system, frontend-web, mobile-app, frontend-vue3</field>
+    </block>
+
     <!-- Step 1: Scan backend modules -->
     <block type="task" id="S0-B1" action="run-script" status="pending" desc="Scan backend module directories">
       <field name="command">Get-ChildItem -Path "${source_path}" -Filter "yudao-module-*" -Directory</field>

package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/workflow.agentflow.xml

@@ -13,7 +13,7 @@
     <field name="changed_files" required="false" type="array" desc="(incremental only) Pre-computed changed file list"/>
     <field name="max_concurrent_workers" required="false" type="number" default="5" desc="Maximum parallel Worker count"/>
     <field name="workspace_path" required="true" type="string" desc="Absolute path to speccrew-workspace directory"/>
-    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/"/>
+    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/ (✓ correct: .../knowledges/base/sync-state/knowledge-bizs/ | ✗ wrong: .../knowledges/bizs/sync-state/knowledge-bizs/)"/>
     <field name="ide_skills_dir" required="true" type="string" desc="Absolute path to IDE-specific skills directory (e.g., .qoder/skills/, .cursor/skills/, .claude/skills/) where skill scripts are deployed"/>
     <field name="configs_dir" required="true" type="string" desc="Absolute path to docs/configs/ directory"/>
     <field name="graph_root" required="false" type="string" desc="Graph data output root path (absolute path preferred)" default="${workspace_path}/knowledges/bizs/graph"/>
@@ -72,6 +72,13 @@
       <field name="text">Missing a platform means incomplete knowledge base generation</field>
     </block>
 
+    <block type="rule" id="S0-R2" level="mandatory" desc="platformId format constraints">
+      <field name="text">platformId MUST use format: {platformType}-{techStack}</field>
+      <field name="text">platformType values: web (NOT frontend), mobile, desktop, backend</field>
+      <field name="text">✓ Correct: backend-fastapi, web-vue3, mobile-uniapp, desktop-electron</field>
+      <field name="text">✗ Wrong: backend-system, frontend-web, mobile-app, frontend-vue3</field>
+    </block>
+
     <!-- Step 1: Scan backend modules -->
     <block type="task" id="S0-B1" action="run-script" status="pending" desc="Scan backend module directories">
       <field name="command">Get-ChildItem -Path "${source_path}" -Filter "yudao-module-*" -Directory</field>

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/SKILL.md

@@ -35,7 +35,7 @@ All generated documents must match the user's language. Detect the language from
 | `entryDirsFile` | string | Yes | Absolute path to entry-dirs JSON file |
 | `outputDir` | string | Yes | Absolute path to features JSON output directory |
 | `workspace_path` | string | Yes | Absolute path to speccrew-workspace directory |
-| `sync_state_bizs_dir` | string | Yes | Absolute path to sync-state/knowledge-bizs directory |
+| `sync_state_bizs_dir` | string | Yes | Absolute path to knowledges/base/sync-state/knowledge-bizs/ (✓ correct: .../knowledges/base/sync-state/knowledge-bizs/ | ✗ wrong: .../knowledges/bizs/sync-state/knowledge-bizs/) |
 | `language` | string | Yes | Language code for generated content |
 
 ## Output
@@ -61,7 +61,7 @@ All generated documents must match the user's language. Detect the language from
     <field name="entryDirsFile" required="true" type="string" desc="Absolute path to entry-dirs JSON file"/>
     <field name="outputDir" required="true" type="string" desc="Absolute path to features JSON output directory"/>
     <field name="workspace_path" required="true" type="string" desc="Absolute path to speccrew-workspace directory"/>
-    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to sync-state/knowledge-bizs directory"/>
+    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/ (✓ correct: .../knowledges/base/sync-state/knowledge-bizs/ | ✗ wrong: .../knowledges/bizs/sync-state/knowledge-bizs/)"/>
     <field name="language" required="true" type="string" desc="Language code for generated content"/>
   </block>
 

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/workflow.agentflow.xml

@@ -14,7 +14,7 @@
     <field name="entryDirsFile" required="true" type="string" desc="Absolute path to entry-dirs JSON file"/>
     <field name="outputDir" required="true" type="string" desc="Absolute path to features JSON output directory"/>
     <field name="workspace_path" required="true" type="string" desc="Absolute path to speccrew-workspace directory"/>
-    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to sync-state/knowledge-bizs directory"/>
+    <field name="sync_state_bizs_dir" required="true" type="string" desc="Absolute path to knowledges/base/sync-state/knowledge-bizs/ (✓ correct: .../knowledges/base/sync-state/knowledge-bizs/ | ✗ wrong: .../knowledges/bizs/sync-state/knowledge-bizs/)"/>
     <field name="language" required="true" type="string" desc="Language code for generated content"/>
   </block>