speccrew 0.7.9 → 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-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-DESKTOP.md

@@ -78,21 +78,21 @@ source-path: {sourcePath}
 
 | Area | Element | Control | Description | Interaction | Source Link |
 |------|---------|---------|-------------|-------------|-------------|
-| Menu | File Menu | MenuStrip | {Application menu} | Click | [Source](../../{sourcePath}) |
-| Toolbar | New Button | ToolStripButton | {Create new} | Click | [Source](../../{sourcePath}) |
-| Tree | Navigation | TreeView | {Navigate sections} | NodeClick | [Source](../../{sourcePath}) |
-| Grid | Data Grid | DataGridView | {Display data} | CellClick/DoubleClick | [Source](../../{sourcePath}) |
-| Status | Status Label | StatusStrip | {Show status} | - | [Source](../../{sourcePath}) |
+| Menu | File Menu | MenuStrip | {Application menu} | Click | [Source](../../../../../../{sourcePath}) |
+| Toolbar | New Button | ToolStripButton | {Create new} | Click | [Source](../../../../../../{sourcePath}) |
+| Tree | Navigation | TreeView | {Navigate sections} | NodeClick | [Source](../../../../../../{sourcePath}) |
+| Grid | Data Grid | DataGridView | {Display data} | CellClick/DoubleClick | [Source](../../../../../../{sourcePath}) |
+| Status | Status Label | StatusStrip | {Show status} | - | [Source](../../../../../../{sourcePath}) |
 
 **Desktop-Specific Interactions:**
 
 | Interaction | Action | Description | Source |
 |-------------|--------|-------------|--------|
-| Click | Select/Activate | Mouse click | [Source](../../{sourcePath}) |
-| DoubleClick | Open/Edit | Double click row | [Source](../../{sourcePath}) |
-| RightClick | Context Menu | Show context menu | [Source](../../{sourcePath}) |
-| DragDrop | Reorder | Drag and drop items | [Source](../../{sourcePath}) |
-| Keyboard | Shortcut | Ctrl+S, Ctrl+N, etc. | [Source](../../{sourcePath}) |
+| Click | Select/Activate | Mouse click | [Source](../../../../../../{sourcePath}) |
+| DoubleClick | Open/Edit | Double click row | [Source](../../../../../../{sourcePath}) |
+| RightClick | Context Menu | Show context menu | [Source](../../../../../../{sourcePath}) |
+| DragDrop | Reorder | Drag and drop items | [Source](../../../../../../{sourcePath}) |
+| Keyboard | Shortcut | Ctrl+S, Ctrl+N, etc. | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -121,11 +121,11 @@ graph TB
 
 | Step | Business Operation | Event | Source |
 |------|-------------------|-------|--------|
-| 1 | Initialize UI components | Form_Load/OnInitialized | [Source](../../{sourcePath}) |
-| 2 | Load app configuration | After init | [Source](../../{sourcePath}) |
-| 3 | Check authentication | After config load | [Source](../../{sourcePath}) |
-| 4 | Load data from service | Auth passed | [Source](../../{sourcePath}) |
-| 5 | Bind data to controls | Data loaded | [Source](../../{sourcePath}) |
+| 1 | Initialize UI components | Form_Load/OnInitialized | [Source](../../../../../../{sourcePath}) |
+| 2 | Load app configuration | After init | [Source](../../../../../../{sourcePath}) |
+| 3 | Check authentication | After config load | [Source](../../../../../../{sourcePath}) |
+| 4 | Load data from service | Auth passed | [Source](../../../../../../{sourcePath}) |
+| 5 | Bind data to controls | Data loaded | [Source](../../../../../../{sourcePath}) |
 
 ### 3.2 User Interaction Flows
 
@@ -151,11 +151,11 @@ graph TB
 
 | Step | Business Operation | Event | Source |
 |------|-------------------|-------|--------|
-| 1 | Get selected row | DoubleClick | [Source](../../{sourcePath}) |
-| 2 | Validate selection | After get | [Source](../../{sourcePath}) |
-| 3 | Open edit dialog | Validation passed | [Source](../../{sourcePath}) |
-| 4 | Load detail data | Dialog opened | [Source](../../{sourcePath}) |
-| 5 | Handle save/cancel | Dialog closed | [Source](../../{sourcePath}) |
+| 1 | Get selected row | DoubleClick | [Source](../../../../../../{sourcePath}) |
+| 2 | Validate selection | After get | [Source](../../../../../../{sourcePath}) |
+| 3 | Open edit dialog | Validation passed | [Source](../../../../../../{sourcePath}) |
+| 4 | Load detail data | Dialog opened | [Source](../../../../../../{sourcePath}) |
+| 5 | Handle save/cancel | Dialog closed | [Source](../../../../../../{sourcePath}) |
 
 #### 3.2.2 {Event Name: e.g., Toolbar Button Click}
 
@@ -190,12 +190,12 @@ graph TB
 
 | Event | WPF | WinForms | Purpose | Source |
 |-------|-----|----------|---------|--------|
-| Initialized | ✅ | - | Component init | [Source](../../{sourcePath}) |
-| Loaded | ✅ | Load | Window loaded | [Source](../../{sourcePath}) |
-| Shown | - | Shown | Window visible | [Source](../../{sourcePath}) |
-| Activated | ✅ | Activated | Window focused | [Source](../../{sourcePath}) |
-| Closing | ✅ | FormClosing | About to close | [Source](../../{sourcePath}) |
-| Closed | ✅ | FormClosed | Window closed | [Source](../../{sourcePath}) |
+| Initialized | ✅ | - | Component init | [Source](../../../../../../{sourcePath}) |
+| Loaded | ✅ | Load | Window loaded | [Source](../../../../../../{sourcePath}) |
+| Shown | - | Shown | Window visible | [Source](../../../../../../{sourcePath}) |
+| Activated | ✅ | Activated | Window focused | [Source](../../../../../../{sourcePath}) |
+| Closing | ✅ | FormClosing | About to close | [Source](../../../../../../{sourcePath}) |
+| Closed | ✅ | FormClosed | Window closed | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -205,18 +205,18 @@ graph TB
 
 | Field Name | Type | Description | Binding | Source |
 |------------|------|-------------|---------|--------|
-| {Field 1} | string/int/bool | {Description} | {OneWay/TwoWay} | [Source](../../{sourcePath}) |
-| {SelectedItem} | Object | {Current selection} | {OneWayToSource} | [Source](../../{sourcePath}) |
-| {DataSource} | Collection | {List data} | {OneWay} | [Source](../../{sourcePath}) |
-| {IsBusy} | bool | {Loading state} | {OneWay} | [Source](../../{sourcePath}) |
+| {Field 1} | string/int/bool | {Description} | {OneWay/TwoWay} | [Source](../../../../../../{sourcePath}) |
+| {SelectedItem} | Object | {Current selection} | {OneWayToSource} | [Source](../../../../../../{sourcePath}) |
+| {DataSource} | Collection | {List data} | {OneWay} | [Source](../../../../../../{sourcePath}) |
+| {IsBusy} | bool | {Loading state} | {OneWay} | [Source](../../../../../../{sourcePath}) |
 
 ### 4.2 Form Fields (if applicable)
 
 | Field Name | Type | Validation | Control | Source |
 |------------|------|------------|---------|--------|
-| {Field 1} | string | {Required} | TextBox | [Source](../../{sourcePath}) |
-| {Field 2} | int | {Range} | NumericUpDown | [Source](../../{sourcePath}) |
-| {Field 3} | DateTime | {Not null} | DateTimePicker | [Source](../../{sourcePath}) |
+| {Field 1} | string | {Required} | TextBox | [Source](../../../../../../{sourcePath}) |
+| {Field 2} | int | {Range} | NumericUpDown | [Source](../../../../../../{sourcePath}) |
+| {Field 3} | DateTime | {Not null} | DateTimePicker | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -226,25 +226,25 @@ graph TB
 
 | Service | Type | Main Function | Source | Document Path |
 |---------|------|---------------|--------|---------------|
-| {Service Name} | Business | {Description} | [Source](../../{serviceSourcePath}) | [Service Doc](../../services/{service-name}.md) |
+| {Service Name} | Business | {Description} | [Source](../../../../../../{serviceSourcePath}) | [Service Doc](../../../../../../services/{service-name}.md) |
 
 ### 5.2 UI Components
 
 | Component | Framework | Type | Main Function | Source | Document Path |
 |-----------|-----------|------|---------------|--------|---------------|
-| {UserControl} | WPF/WinForms | Custom | {Reusable UI} | [Source](../../{componentSourcePath}) | [Component Doc](../../components/{component-name}.md) |
+| {UserControl} | WPF/WinForms | Custom | {Reusable UI} | [Source](../../../../../../{componentSourcePath}) | [Component Doc](../../../../../../components/{component-name}.md) |
 
 ### 5.3 Other Windows
 
 | Window Name | Relation Type | Description | Source | Document Path |
 |-------------|---------------|-------------|--------|---------------|
-| {Window Name} | Dialog/Child | {Relation description} | [Source](../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
+| {Window Name} | Dialog/Child | {Relation description} | [Source](../../../../../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
 
 ### 5.4 Referenced By
 
 | Window Name | Function Description | Source Path | Document Path |
 |-------------|---------------------|-------------|---------------|
-| {Referencing Window} | {e.g., "Open this window from main menu"} | {source-path} | [Window Doc](../{window-path}.md) |
+| {Referencing Window} | {e.g., "Open this window from main menu"} | {source-path} | [Window Doc](../../../../../../{window-path}.md) |
 
 ---
 
@@ -254,21 +254,21 @@ graph TB
 
 | Operation | Permission Requirement | No Permission Handling | Source |
 |-----------|----------------------|----------------------|--------|
-| View window | {Role required} | Hide menu item / Show message | [Source](../../{sourcePath}) |
-| Edit data | {Permission required} | Disable edit button | [Source](../../{sourcePath}) |
-| Delete record | {Admin role} | Disable delete button | [Source](../../{sourcePath}) |
+| View window | {Role required} | Hide menu item / Show message | [Source](../../../../../../{sourcePath}) |
+| Edit data | {Permission required} | Disable edit button | [Source](../../../../../../{sourcePath}) |
+| Delete record | {Admin role} | Disable delete button | [Source](../../../../../../{sourcePath}) |
 
 ### 6.2 Desktop-Specific Rules
 
-1. **Auto-save**: {e.g., Auto-save draft every 5 minutes} | [Source](../../{sourcePath})
-2. **Keyboard Shortcuts**: {e.g., Ctrl+S save, Ctrl+F find} | [Source](../../{sourcePath})
-3. **Window State**: {e.g., Remember window size and position} | [Source](../../{sourcePath})
+1. **Auto-save**: {e.g., Auto-save draft every 5 minutes} | [Source](../../../../../../{sourcePath})
+2. **Keyboard Shortcuts**: {e.g., Ctrl+S save, Ctrl+F find} | [Source](../../../../../../{sourcePath})
+3. **Window State**: {e.g., Remember window size and position} | [Source](../../../../../../{sourcePath})
 
 ### 6.3 Validation Rules
 
 | Scenario | Rule | Error Handling | Source |
 |----------|------|----------------|--------|
-| Form submit | {Validation rule} | Show error provider / MessageBox | [Source](../../{sourcePath}) |
+| Form submit | {Validation rule} | Show error provider / MessageBox | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -299,5 +299,5 @@ graph TB
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Window}.xaml.cs/{Form}.cs](../../{sourcePath})
-- [{ViewModel}.cs](../../{viewModelPath})
+- [{Window}.xaml.cs/{Form}.cs](../../../../../../{sourcePath})
+- [{ViewModel}.cs](../../../../../../{viewModelPath})