speccrew 0.7.9 → 0.7.11

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/scripts/batch-orchestrator.js

@@ -155,6 +155,78 @@ function getBatch(args) {
   }
 }
 
+// Parse featureId to extract platformId, module, and fileName
+// featureId format: {platformId}-{module}-{fileNameWithoutExt}
+function parseFeatureId(featureId) {
+  const parts = featureId.split('-');
+  if (parts.length >= 3) {
+    const platformId = parts[0];
+    const module = parts[1];
+    const fileNameWithoutExt = parts.slice(2).join('-'); // Handle fileName with hyphens
+    return { platformId, module, fileNameWithoutExt };
+  }
+  return null;
+}
+
+// Update features JSON file with analysis results
+function updateFeaturesJson(syncStatePath, featureId, doneData) {
+  const parsed = parseFeatureId(featureId);
+  if (!parsed) {
+    console.error(JSON.stringify({ warning: `Cannot parse featureId: ${featureId}` }));
+    return false;
+  }
+  
+  const { platformId, module, fileNameWithoutExt } = parsed;
+  const featuresFilePath = path.join(syncStatePath, `features-${platformId}.json`);
+  
+  if (!fs.existsSync(featuresFilePath)) {
+    console.error(JSON.stringify({ warning: `Features file not found: ${featuresFilePath}` }));
+    return false;
+  }
+  
+  const featuresData = readJsonSafe(featuresFilePath);
+  if (!featuresData || !Array.isArray(featuresData.features)) {
+    console.error(JSON.stringify({ warning: `Invalid features data in: ${featuresFilePath}` }));
+    return false;
+  }
+  
+  // Find matching feature
+  let found = false;
+  for (const feature of featuresData.features) {
+    const featureFileName = feature.fileName || feature.sourceFile || 'unknown';
+    const featureFileNameWithoutExt = featureFileName.replace(/\.[^.]+$/, '');
+    
+    // Match by module and fileName (platformId already matched by filename)
+    if (feature.module === module && featureFileNameWithoutExt === fileNameWithoutExt) {
+      // Skip if already analyzed (idempotency)
+      if (feature.analyzed === true) {
+        found = true;
+        continue;
+      }
+      
+      // Update feature fields
+      feature.analyzed = true;
+      feature.startedAt = doneData.startedAt || doneData.timestamp || null;
+      feature.completedAt = doneData.completedAt || doneData.timestamp || null;
+      feature.analysisNotes = doneData.notes || 'completed';
+      found = true;
+    }
+  }
+  
+  if (!found) {
+    console.error(JSON.stringify({ warning: `Feature not found in ${featuresFilePath}: ${featureId}` }));
+    return false;
+  }
+  
+  // Update top-level counts
+  featuresData.analyzedCount = featuresData.features.filter(f => f.analyzed).length;
+  featuresData.pendingCount = featuresData.features.filter(f => !f.analyzed).length;
+  
+  // Write back to file (atomic write)
+  fs.writeFileSync(featuresFilePath, JSON.stringify(featuresData, null, 2));
+  return true;
+}
+
 // process-results subcommand
 function processResults(args) {
   const { syncStatePath, graphRoot, completedDir } = args;
@@ -165,9 +237,10 @@ function processResults(args) {
   let success = 0;
   let failed = 0;
   let graphUpdated = false;
+  let featuresUpdated = 0;
   
   if (!fs.existsSync(completedDir)) {
-    console.log(JSON.stringify({ success, failed, graphUpdated }));
+    console.log(JSON.stringify({ success, failed, graphUpdated, featuresUpdated }));
     return;
   }
   
@@ -178,14 +251,26 @@ function processResults(args) {
   for (const file of doneFiles) {
     const filePath = path.join(completedDir, file);
     const data = readJsonSafe(filePath);
+    
+    // Extract featureId from filename: {featureId}.done.json
+    const featureId = file.replace('.done.json', '');
+    
     if (data) {
       if (data.status === 'success' || data.status === 'completed') {
         success++;
+        // Update features JSON for successful analysis
+        if (updateFeaturesJson(syncStatePath, featureId, data)) {
+          featuresUpdated++;
+        }
       } else if (data.status === 'failed' || data.status === 'error') {
         failed++;
       } else {
         // Default to success if no status field
         success++;
+        // Update features JSON for successful analysis
+        if (updateFeaturesJson(syncStatePath, featureId, data)) {
+          featuresUpdated++;
+        }
       }
     } else {
       // Invalid JSON, assume success
@@ -260,7 +345,8 @@ function processResults(args) {
   console.log(JSON.stringify({
     success,
     failed,
-    graphUpdated
+    graphUpdated,
+    featuresUpdated
   }));
 }