@mind-fold/open-flow 0.1.6 → 0.1.8

package/README.md

@@ -72,10 +72,14 @@ your-project/
 | Command | Purpose |
 |---------|---------|
 | `/init-agent` | Initialize AI session, read context and guidelines |
+| `/before-frontend-dev` | Read frontend guidelines before starting development |
+| `/before-backend-dev` | Read backend guidelines before starting development |
 | `/check-frontend` | Check frontend code against guidelines |
 | `/check-backend` | Check backend code against guidelines |
 | `/record-agent-flow` | Record work progress (after human commits) |
 | `/onboard-developer` | Guide new developer through setup |
+| `/update-frontend-structure` | Update frontend guidelines if new patterns found |
+| `/update-backend-structure` | Update backend guidelines if new patterns found |
 
 ## Workflow
 
@@ -103,16 +107,21 @@ Fill in your project-specific guidelines in:
 - `workflow/structure/frontend/doc.md`
 - `workflow/structure/backend/doc.md`
 
-Update the `index.md` files with correct line numbers for quick navigation.
+**Requirements**:
+- Write all documentation in **English**
+- Add section markers: `@@@section:kebab-case-id` and `@@@/section:kebab-case-id`
+- Update `index.md` files with section IDs for quick navigation
 
 ## Key Concepts
 
 ### index.md + doc.md Structure
 
 Instead of reading entire guideline documents (which can be 1000+ lines), AI:
-1. Reads the lightweight `index.md` (navigation table)
-2. Finds relevant section and line numbers
-3. Reads only the needed sections from `doc.md`
+1. Reads the lightweight `index.md` (navigation table with section IDs)
+2. Finds relevant section ID for the task
+3. Extracts only the needed section: `sed -n '/@@@section:ID/,/@@@\/section:ID/p' doc.md`
+
+Section markers (`@@@section:id`) ensure references don't break when content is added or removed.
 
 This saves tokens and improves focus.
 

package/dist/configurators/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAUtD"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CActD"}

package/dist/configurators/templates.js

@@ -11,6 +11,10 @@ export function getCommandTemplates() {
         "onboard-developer": getOnboardDeveloperTemplate(),
         "generate-frontend-structure": getGenerateFrontendStructureTemplate(),
         "generate-backend-structure": getGenerateBackendStructureTemplate(),
+        "before-frontend-dev": getBeforeFrontendDevTemplate(),
+        "before-backend-dev": getBeforeBackendDevTemplate(),
+        "update-frontend-structure": getUpdateFrontendStructureTemplate(),
+        "update-backend-structure": getUpdateBackendStructureTemplate(),
     };
 }
 function getInitAgentTemplate() {
@@ -30,8 +34,8 @@ function getCheckFrontendTemplate() {
 
 Execute these steps:
 1. Run \`git status\` to see modified files
-2. Read \`workflow/structure/frontend/index.md\` to find relevant guidelines
-3. Read the specific sections in \`workflow/structure/frontend/doc.md\` based on your changes
+2. Read \`workflow/structure/frontend/index.md\` to find relevant section IDs
+3. Extract specific sections: \`sed -n '/@@@section:ID/,/@@@\\/section:ID/p' workflow/structure/frontend/doc.md\`
 4. Review your code against the guidelines
 5. Report any violations and fix them if found
 `;
@@ -41,8 +45,8 @@ function getCheckBackendTemplate() {
 
 Execute these steps:
 1. Run \`git status\` to see modified files
-2. Read \`workflow/structure/backend/index.md\` to find relevant guidelines
-3. Read the specific sections in \`workflow/structure/backend/doc.md\` based on your changes
+2. Read \`workflow/structure/backend/index.md\` to find relevant section IDs
+3. Extract specific sections: \`sed -n '/@@@section:ID/,/@@@\\/section:ID/p' workflow/structure/backend/doc.md\`
 4. Review your code against the guidelines
 5. Report any violations and fix them if found
 `;
@@ -101,18 +105,15 @@ function getGenerateFrontendStructureTemplate() {
 
 ## Task Description
 
-Scan the project's frontend code, analyze existing code patterns and tech stack, then auto-generate \`doc.md\` (detailed guidelines) first, then use the extract script to get accurate line numbers, finally generate \`index.md\` (navigation index).
+Scan the project's frontend code, analyze existing code patterns and tech stack, then auto-generate \`doc.md\` (detailed guidelines) with section markers, then generate \`index.md\` (navigation index) using section IDs.
 
 ---
 
-## ⚠️ CRITICAL: Execution Order
+## ⚠️ CRITICAL: Requirements
 
-**MUST follow this order:**
-1. **First**: Generate \`doc.md\` (detailed guidelines)
-2. **Then**: Run \`./workflow/scripts/extract-md-headings.sh doc.md -r\` to get accurate line numbers
-3. **Finally**: Generate \`index.md\` using the line numbers from step 2
-
-**DO NOT** generate index.md with placeholder line numbers. Always use the extract script first.
+1. **Language**: All documentation must be written in **English**
+2. **Section Markers**: Use \`@@@section:kebab-case-id\` and \`@@@/section:kebab-case-id\` to mark sections
+3. **Index**: Reference sections by ID, not line numbers
 
 ---
 
@@ -184,9 +185,7 @@ find [frontend-dir] -type d -maxdepth 3 | head -50
 - Local state
 - URL state synchronization
 
-### Step 4: Generate \`doc.md\` FIRST
-
-⚠️ **Generate doc.md BEFORE index.md**
+### Step 4: Generate \`doc.md\` with Section Markers
 
 Create directory and generate detailed guidelines:
 
@@ -201,16 +200,24 @@ mkdir -p workflow/structure/frontend
 
 These guidelines define the development standards and best practices for [Project Name] frontend modules.
 
+@@@section:directory-structure
 ## 📁 Directory Structure Guidelines
 
+@@@section:module-organization
 ### Module Organization
 [Describe directory structure with tree diagram code block]
 
 **Reference Example**:
 - \`[path]\` - [description]
 
+@@@/section:module-organization
+
+@@@/section:directory-structure
+
+@@@section:type-safety
 ## 🎯 Type Safety Guidelines
 
+@@@section:backend-contract-types
 ### 1. Backend Contract Types vs Frontend View Models
 
 #### ✅ Correct Approach - Import Types from Backend
@@ -219,23 +226,40 @@ These guidelines define the development standards and best practices for [Projec
 #### ❌ Wrong Approach
 [anti-pattern code example]
 
+@@@/section:backend-contract-types
+
+@@@/section:type-safety
+
+@@@section:hook-development
 ## 🪝 Hook Development Guidelines
 
+@@@section:query-hook-guidelines
 ### 1. Query Hook Standards
 
 #### ✅ Correct Query Hook Pattern
 [code example]
 
+@@@/section:query-hook-guidelines
+
+@@@section:mutation-hook-guidelines
 ### 2. Mutation Hook Standards
 
 #### ✅ Correct Mutation Hook Pattern
 [code example]
 
+@@@/section:mutation-hook-guidelines
+
+@@@/section:hook-development
+
+@@@section:api-calls
 ## 🔌 API Call Guidelines
 
 ### Basic Usage
 [code example]
 
+@@@/section:api-calls
+
+@@@section:state-management
 ## 🏗️ State Management Guidelines
 
 ### 1. URL State Management
@@ -244,6 +268,9 @@ These guidelines define the development standards and best practices for [Projec
 ### 2. React Context Standards
 [code example]
 
+@@@/section:state-management
+
+@@@section:component-development
 ## 🎨 Component Development Guidelines
 
 ### 1. Component Structure
@@ -252,51 +279,43 @@ These guidelines define the development standards and best practices for [Projec
 ### 2. Styling Standards
 [code example]
 
+@@@/section:component-development
+
+@@@section:performance-optimization
 ## ⚡ Performance Optimization Guidelines
 
 [performance rules]
 
+@@@/section:performance-optimization
+
+@@@section:code-quality
 ## 🔍 Code Quality Guidelines
 
 ### Lint and Formatting
 [tool configuration and usage]
 
+@@@/section:code-quality
+
+@@@section:checklist
 ## ✅ Checklist
 
 - [ ] Code passes lint check
 - [ ] Type check passes
 - [ ] [other check items...]
 
+@@@/section:checklist
+
+@@@section:reference-examples
 ## 📚 Reference Examples
 
 | Feature | Reference File |
 |---------|----------------|
 | [Feature1] | \`[path]\` |
-\`\`\`
 
-### Step 5: Extract Line Numbers with Script
-
-⚠️ **REQUIRED: Run this AFTER generating doc.md**
-
-\`\`\`bash
-# Get all headings with line number ranges
-./workflow/scripts/extract-md-headings.sh workflow/structure/frontend/doc.md -l 1,2,3 -r
-
-# Example output:
-# Level    Line         Range        Title
-# ----     ----         ----         ----
-# 1        1            L1-15        Frontend Development Guidelines
-# 2        5            L5-28        📁 Directory Structure Guidelines
-# 2        30           L30-65       🎯 Type Safety Guidelines
-# 2        67           L67-120      🪝 Hook Development Guidelines
-# ...
+@@@/section:reference-examples
 \`\`\`
 
-**Save the output** - you'll use these exact line numbers in index.md.
-
-### Step 6: Generate \`index.md\` with Accurate Line Numbers
-
-⚠️ **Use the EXACT line numbers from Step 5**
+### Step 5: Generate \`index.md\` with Section IDs
 
 \`\`\`markdown
 # Frontend Development Guidelines Index
@@ -307,40 +326,46 @@ This index helps you quickly locate the guidelines you need based on your task t
 
 ## Quick Navigation
 
-| Development Task | Section to Read | Line Range |
+| Development Task | Section to Read | Section ID |
 |-----------------|-----------------|------------|
-| **New feature module** | Directory Structure | L5-28 |
-| **Write Query Hook** | Hook Guidelines > Query Hook | L67-95 |
-| **Write Mutation Hook** | Hook Guidelines > Mutation Hook | L97-120 |
-| **API calls** | API Call Guidelines | L122-150 |
-| **State management** | State Management Guidelines | L152-180 |
-| **Write component** | Component Guidelines | L182-220 |
-| **Performance optimization** | Performance Guidelines | L222-250 |
-| **Code quality check** | Code Quality Guidelines | L252-280 |
+| **New feature module** | Directory Structure | \`directory-structure\` |
+| **Write Query Hook** | Hook Guidelines > Query Hook | \`query-hook-guidelines\` |
+| **Write Mutation Hook** | Hook Guidelines > Mutation Hook | \`mutation-hook-guidelines\` |
+| **API calls** | API Call Guidelines | \`api-calls\` |
+| **State management** | State Management Guidelines | \`state-management\` |
+| **Write component** | Component Guidelines | \`component-development\` |
+| **Performance optimization** | Performance Guidelines | \`performance-optimization\` |
+| **Code quality check** | Code Quality Guidelines | \`code-quality\` |
+
+## How to Read Sections
+
+\\\`\\\`\\\`bash
+# Extract a specific section by ID
+sed -n '/@@@section:query-hook-guidelines/,/@@@\\\\/section:query-hook-guidelines/p' doc.md
+\\\`\\\`\\\`
 
 ## By Development Scenario
 
 ### Scenario 1: Create a new Query Hook
 
 **Required Reading**:
-- Type Safety > Backend Contract Types (L30-50)
-- Hook Guidelines > Query Hook (L67-95)
+- Type Safety > Backend Contract Types (\`backend-contract-types\`)
+- Hook Guidelines > Query Hook (\`query-hook-guidelines\`)
 
 ### Scenario 2: Create a new UI Component
 
 **Required Reading**:
-- Component Guidelines > Component Structure (L182-200)
-- Component Guidelines > Styling Standards (L202-220)
+- Component Guidelines (\`component-development\`)
 
 [... add more scenarios based on project needs ...]
 
 ## Core Rules Quick Reference
 
-| Rule | Location |
-|------|----------|
-| Import types from backend, don't redefine | L35 |
-| No any type allowed | L42 |
-| [other core rules...] | LXX |
+| Rule | Section ID |
+|------|------------|
+| Import types from backend, don't redefine | \`backend-contract-types\` |
+| Query Hook patterns | \`query-hook-guidelines\` |
+| [other core rules...] | \`section-id\` |
 
 ## Reference Example Files
 
@@ -356,19 +381,18 @@ This index helps you quickly locate the guidelines you need based on your task t
 ## Output Requirements
 
 1. **Create directory**: \`mkdir -p workflow/structure/frontend\`
-2. **Generate doc.md FIRST**: Include complete detailed guidelines
-3. **Run extract script**: \`./workflow/scripts/extract-md-headings.sh doc.md -l 1,2,3 -r\`
-4. **Generate index.md LAST**: Use EXACT line numbers from the script output
+2. **Write in English**: All documentation must be in English
+3. **Add section markers**: Use \`@@@section:id\` and \`@@@/section:id\` format
+4. **Generate index.md**: Reference sections by ID, not line numbers
 5. **Use actual project code**: Examples should come from real project files
 
 ---
 
 ## Completion Confirmation
 
-- [ ] \`doc.md\` created with detailed guidelines
-- [ ] Extract script ran successfully
-- [ ] \`index.md\` created with ACCURATE line numbers from script
-- [ ] Line numbers verified to match actual doc.md content
+- [ ] \`doc.md\` created with detailed guidelines in **English**
+- [ ] Section markers added to all major sections
+- [ ] \`index.md\` created with section IDs
 - [ ] Example code from actual project files
 - [ ] Covers all major patterns used in project
 
@@ -380,18 +404,15 @@ function getGenerateBackendStructureTemplate() {
 
 ## Task Description
 
-Scan the project's backend code, analyze existing code patterns and tech stack, then auto-generate \`doc.md\` (detailed guidelines) first, then use the extract script to get accurate line numbers, finally generate \`index.md\` (navigation index).
+Scan the project's backend code, analyze existing code patterns and tech stack, then auto-generate \`doc.md\` (detailed guidelines) with section markers, then generate \`index.md\` (navigation index) using section IDs.
 
 ---
 
-## ⚠️ CRITICAL: Execution Order
+## ⚠️ CRITICAL: Requirements
 
-**MUST follow this order:**
-1. **First**: Generate \`doc.md\` (detailed guidelines)
-2. **Then**: Run \`./workflow/scripts/extract-md-headings.sh doc.md -r\` to get accurate line numbers
-3. **Finally**: Generate \`index.md\` using the line numbers from step 2
-
-**DO NOT** generate index.md with placeholder line numbers. Always use the extract script first.
+1. **Language**: All documentation must be written in **English**
+2. **Section Markers**: Use \`@@@section:kebab-case-id\` and \`@@@/section:kebab-case-id\` to mark sections
+3. **Index**: Reference sections by ID, not line numbers
 
 ---
 
@@ -469,9 +490,7 @@ find [backend-dir] -type d -maxdepth 3 | head -50
 - Log level usage
 - Structured log format
 
-### Step 4: Generate \`doc.md\` FIRST
-
-⚠️ **Generate doc.md BEFORE index.md**
+### Step 4: Generate \`doc.md\` with Section Markers
 
 Create directory and generate detailed guidelines:
 
@@ -486,13 +505,18 @@ mkdir -p workflow/structure/backend
 
 These guidelines define the development standards and best practices for [Project Name] backend modules.
 
+@@@section:directory-structure
 ## 📁 Directory Structure Guidelines
 
 ### Module Organization
 [describe directory structure]
 
+@@@/section:directory-structure
+
+@@@section:type-safety
 ## 🎯 Type Safety Guidelines
 
+@@@section:non-null-assertion
 ### 1. TypeScript Non-null Assertion Rules
 
 **Never use non-null assertion operator (\`!\`), use local variable extraction instead**
@@ -518,10 +542,16 @@ if (user.profileId) {
 }
 \\\`\\\`\\\`
 
+@@@/section:non-null-assertion
+
+@@@section:zod-schema
 ### 2. Zod Schema Definition
 
 **All API endpoints must use Zod to define input/output schemas**
 
+@@@/section:zod-schema
+
+@@@section:response-format
 ### 3. Response Format Standards
 
 #### Single Operation Response
@@ -530,7 +560,6 @@ if (user.profileId) {
   success: boolean,    // operation result
   reason?: string,     // success message or failure reason
   error?: string,      // detailed error info
-  // ... other domain-specific fields
 }
 \\\`\\\`\\\`
 
@@ -545,27 +574,30 @@ if (user.profileId) {
 }
 \\\`\\\`\\\`
 
+@@@/section:response-format
+
+@@@/section:type-safety
+
+@@@section:logging
 ## 🪵 Logging Guidelines
 
 ### Use Structured Logging
 
 **Never use \`console.log\` or \`console.error\`**
 
-#### ✅ Correct Approach
-[code example using logger]
+[code examples]
 
-#### ❌ Wrong Approach
-[anti-pattern example]
+@@@/section:logging
 
+@@@section:database-operations
 ## 🗄️ Database Operation Guidelines
 
+@@@section:no-loops
 ### 🚨 Never Execute Database Operations in Loops
 
-#### ❌ Wrong Approach - N+1 Problem
-[anti-pattern code example]
+[anti-pattern and correct pattern examples]
 
-#### ✅ Correct Approach - Batch Query
-[correct pattern code example]
+@@@/section:no-loops
 
 ### Batch Insert
 [code example]
@@ -573,6 +605,9 @@ if (user.profileId) {
 ### Conflict Handling
 [code example with onConflictDoUpdate]
 
+@@@/section:database-operations
+
+@@@section:error-handling
 ## 🎨 Error Handling
 
 ### Graceful Degradation
@@ -581,6 +616,9 @@ if (user.profileId) {
 ### Promise.allSettled
 [code example for batch operations]
 
+@@@/section:error-handling
+
+@@@section:router-guidelines
 ## 🎯 Router Guidelines
 
 ### Hono Router Example
@@ -589,6 +627,9 @@ if (user.profileId) {
 ### oRPC Router Example
 [code example]
 
+@@@/section:router-guidelines
+
+@@@section:checklist
 ## ✅ Checklist
 
 Before committing, confirm:
@@ -604,80 +645,70 @@ Before committing, confirm:
 - [ ] \`pnpm lint\` passes
 - [ ] \`pnpm type-check\` passes
 
+@@@/section:checklist
+
+@@@section:reference-examples
 ## 📚 Reference Examples
 
 | Feature | Reference File |
 |---------|----------------|
 | [Feature1] | \`[path]\` |
-\`\`\`
-
-### Step 5: Extract Line Numbers with Script
-
-⚠️ **REQUIRED: Run this AFTER generating doc.md**
 
-\`\`\`bash
-# Get all headings with line number ranges
-./workflow/scripts/extract-md-headings.sh workflow/structure/backend/doc.md -l 1,2,3 -r
-
-# Example output:
-# Level    Line         Range        Title
-# ----     ----         ----         ----
-# 1        1            L1-15        Backend Development Guidelines
-# 2        5            L5-28        📁 Directory Structure Guidelines
-# 2        30           L30-85       🎯 Type Safety Guidelines
-# 2        87           L87-120      🪵 Logging Guidelines
-# ...
+@@@/section:reference-examples
 \`\`\`
 
-**Save the output** - you'll use these exact line numbers in index.md.
-
-### Step 6: Generate \`index.md\` with Accurate Line Numbers
-
-⚠️ **Use the EXACT line numbers from Step 5**
+### Step 5: Generate \`index.md\` with Section IDs
 
 \`\`\`markdown
 # Backend Development Guidelines Index
 
 > **Full Documentation**: See \`./doc.md\` for detailed guidelines
 
-This index helps you quickly locate the sections and line numbers needed for backend tasks.
+This index helps you quickly locate the sections needed for backend tasks.
 
 ## Quick Navigation
 
-| Section | Key Content | Line Range |
+| Section | Key Content | Section ID |
 |---------|-------------|------------|
-| 📁 Directory Structure | Module directory template, examples | L5-28 |
-| 🎯 Type Safety Guidelines | TypeScript rules, Zod Schema | L30-85 |
-| 🪵 Logging Guidelines | Structured logging, no console | L87-120 |
-| 🗄️ Database Operation Guidelines | Query directory, batch operations | L122-180 |
-| 🎨 Error Handling | Graceful degradation, response format | L182-220 |
-| 🎯 Router Guidelines | Route definitions, middleware | L222-260 |
-| ✅ Checklist | Pre-commit checks | L262-290 |
+| 📁 Directory Structure | Module directory template, examples | \`directory-structure\` |
+| 🎯 Type Safety Guidelines | TypeScript rules, Zod Schema | \`type-safety\` |
+| 🪵 Logging Guidelines | Structured logging, no console | \`logging\` |
+| 🗄️ Database Operations | Query directory, batch operations | \`database-operations\` |
+| 🎨 Error Handling | Graceful degradation, response format | \`error-handling\` |
+| 🎯 Router Guidelines | Route definitions, middleware | \`router-guidelines\` |
+| ✅ Checklist | Pre-commit checks | \`checklist\` |
+
+## How to Read Sections
+
+\\\`\\\`\\\`bash
+# Extract a specific section by ID
+sed -n '/@@@section:database-operations/,/@@@\\\\/section:database-operations/p' doc.md
+\\\`\\\`\\\`
 
 ## By Scenario
 
 ### Scenario 1: Create New API Module
-- Required: 📁 Directory Structure (L5-28)
-- Also read: 🎯 Type Safety Guidelines (L30-85)
+- Required: 📁 Directory Structure (\`directory-structure\`)
+- Also read: 🎯 Type Safety Guidelines (\`type-safety\`)
 
 ### Scenario 2: Write Database Operations
-- Required: 🗄️ Database Operation Guidelines (L122-180)
-- Reference: 🎨 Error Handling (L182-220)
+- Required: 🗄️ Database Operations (\`database-operations\`)
+- Reference: 🎨 Error Handling (\`error-handling\`)
 
 ### Scenario 3: Add New Endpoint
-- Required: 🎯 Router Guidelines (L222-260)
-- Reference: 🎯 Type Safety Guidelines (L30-85)
+- Required: 🎯 Router Guidelines (\`router-guidelines\`)
+- Reference: 🎯 Type Safety Guidelines (\`type-safety\`)
 
 [... add more scenarios based on project needs ...]
 
 ## Core Rules Quick Reference
 
-| Rule | Location |
-|------|----------|
-| **All inputs/outputs must have Zod Schema** | L45 |
-| **Response body must include success + reason** | L55 |
-| **Never await database in loops** | L125 |
-| [other core rules...] | LXX |
+| Rule | Section ID |
+|------|------------|
+| **All inputs/outputs must have Zod Schema** | \`zod-schema\` |
+| **Response body must include success + reason** | \`response-format\` |
+| **Never await database in loops** | \`no-loops\` |
+| **No non-null assertions** | \`non-null-assertion\` |
 
 ## Reference Examples
 
@@ -693,23 +724,82 @@ This index helps you quickly locate the sections and line numbers needed for bac
 ## Output Requirements
 
 1. **Create directory**: \`mkdir -p workflow/structure/backend\`
-2. **Generate doc.md FIRST**: Include complete detailed guidelines
-3. **Run extract script**: \`./workflow/scripts/extract-md-headings.sh doc.md -l 1,2,3 -r\`
-4. **Generate index.md LAST**: Use EXACT line numbers from the script output
+2. **Write in English**: All documentation must be in English
+3. **Add section markers**: Use \`@@@section:id\` and \`@@@/section:id\` format
+4. **Generate index.md**: Reference sections by ID, not line numbers
 5. **Use actual project code**: Examples should come from real project files
 
 ---
 
 ## Completion Confirmation
 
-- [ ] \`doc.md\` created with detailed guidelines
-- [ ] Extract script ran successfully
-- [ ] \`index.md\` created with ACCURATE line numbers from script
-- [ ] Line numbers verified to match actual doc.md content
+- [ ] \`doc.md\` created with detailed guidelines in **English**
+- [ ] Section markers added to all major sections
+- [ ] \`index.md\` created with section IDs
 - [ ] Example code from actual project files
 - [ ] Covers all major patterns used in project
 
 Report: "Backend structure guidelines generated, please check \`workflow/structure/backend/\` directory"
 `;
 }
+function getBeforeFrontendDevTemplate() {
+    return `Read the frontend development guidelines before starting your development task.
+
+Execute these steps:
+1. Read \`workflow/structure/frontend/index.md\` to find relevant section IDs for your task
+2. Extract specific sections: \`sed -n '/@@@section:ID/,/@@@\\/section:ID/p' workflow/structure/frontend/doc.md\`
+3. Understand the coding standards and patterns you need to follow
+4. Then proceed with your development plan
+
+This step is **mandatory** before writing any frontend code.
+`;
+}
+function getBeforeBackendDevTemplate() {
+    return `Read the backend development guidelines before starting your development task.
+
+Execute these steps:
+1. Read \`workflow/structure/backend/index.md\` to find relevant section IDs for your task
+2. Extract specific sections: \`sed -n '/@@@section:ID/,/@@@\\/section:ID/p' workflow/structure/backend/doc.md\`
+3. Understand the coding standards and patterns you need to follow
+4. Then proceed with your development plan
+
+This step is **mandatory** before writing any backend code.
+`;
+}
+function getUpdateFrontendStructureTemplate() {
+    return `Check if the frontend development guidelines need to be updated based on recent code changes.
+
+Execute these steps:
+1. Review recent commits: \`git log --oneline -10\`
+2. Check if any new patterns or conventions were introduced
+3. Read current guidelines: \`workflow/structure/frontend/doc.md\`
+4. If updates are needed:
+   - Update \`doc.md\` with new patterns or rules (in **English**)
+   - Add section markers: \`@@@section:kebab-case-id\` and \`@@@/section:kebab-case-id\`
+   - Update \`index.md\` with new section IDs
+5. Report what was updated (if anything)
+
+**Language requirement**: All documentation must be written in **English**.
+
+Only update if there are genuine new patterns worth documenting.
+`;
+}
+function getUpdateBackendStructureTemplate() {
+    return `Check if the backend development guidelines need to be updated based on recent code changes.
+
+Execute these steps:
+1. Review recent commits: \`git log --oneline -10\`
+2. Check if any new patterns or conventions were introduced
+3. Read current guidelines: \`workflow/structure/backend/doc.md\`
+4. If updates are needed:
+   - Update \`doc.md\` with new patterns or rules (in **English**)
+   - Add section markers: \`@@@section:kebab-case-id\` and \`@@@/section:kebab-case-id\`
+   - Update \`index.md\` with new section IDs
+5. Report what was updated (if anything)
+
+**Language requirement**: All documentation must be written in **English**.
+
+Only update if there are genuine new patterns worth documenting.
+`;
+}
 //# sourceMappingURL=templates.js.map

package/dist/configurators/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,YAAY,EAAE,oBAAoB,EAAE;QACpC,gBAAgB,EAAE,wBAAwB,EAAE;QAC5C,eAAe,EAAE,uBAAuB,EAAE;QAC1C,mBAAmB,EAAE,0BAA0B,EAAE;QACjD,mBAAmB,EAAE,2BAA2B,EAAE;QAClD,6BAA6B,EAAE,oCAAoC,EAAE;QACrE,4BAA4B,EAAE,mCAAmC,EAAE;KACnE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB;IAC5B,OAAO;;;;;;;;;CASP,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB;IAChC,OAAO;;;;;;;;CAQP,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC/B,OAAO;;;;;;;;CAQP,CAAC;AACF,CAAC;AAED,SAAS,0BAA0B;IAClC,OAAO;;;;;;;;;;;;;;;;;;;CAmBP,CAAC;AACF,CAAC;AAED,SAAS,2BAA2B;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBP,CAAC;AACF,CAAC;AAED,SAAS,oCAAoC;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoRP,CAAC;AACF,CAAC;AAED,SAAS,mCAAmC;IAC3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8UP,CAAC;AACF,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,YAAY,EAAE,oBAAoB,EAAE;QACpC,gBAAgB,EAAE,wBAAwB,EAAE;QAC5C,eAAe,EAAE,uBAAuB,EAAE;QAC1C,mBAAmB,EAAE,0BAA0B,EAAE;QACjD,mBAAmB,EAAE,2BAA2B,EAAE;QAClD,6BAA6B,EAAE,oCAAoC,EAAE;QACrE,4BAA4B,EAAE,mCAAmC,EAAE;QACnE,qBAAqB,EAAE,4BAA4B,EAAE;QACrD,oBAAoB,EAAE,2BAA2B,EAAE;QACnD,2BAA2B,EAAE,kCAAkC,EAAE;QACjE,0BAA0B,EAAE,iCAAiC,EAAE;KAC/D,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB;IAC5B,OAAO;;;;;;;;;CASP,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB;IAChC,OAAO;;;;;;;;CAQP,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC/B,OAAO;;;;;;;;CAQP,CAAC;AACF,CAAC;AAED,SAAS,0BAA0B;IAClC,OAAO;;;;;;;;;;;;;;;;;;;CAmBP,CAAC;AACF,CAAC;AAED,SAAS,2BAA2B;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBP,CAAC;AACF,CAAC;AAED,SAAS,oCAAoC;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwSP,CAAC;AACF,CAAC;AAED,SAAS,mCAAmC;IAC3C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoVP,CAAC;AACF,CAAC;AAED,SAAS,4BAA4B;IACpC,OAAO;;;;;;;;;CASP,CAAC;AACF,CAAC;AAED,SAAS,2BAA2B;IACnC,OAAO;;;;;;;;;CASP,CAAC;AACF,CAAC;AAED,SAAS,kCAAkC;IAC1C,OAAO;;;;;;;;;;;;;;;CAeP,CAAC;AACF,CAAC;AAED,SAAS,iCAAiC;IACzC,OAAO;;;;;;;;;;;;;;;CAeP,CAAC;AACF,CAAC"}

package/dist/configurators/workflow.js

@@ -491,25 +491,32 @@ This index helps you quickly locate the guidelines you need based on your task t
 
 ## Quick Navigation
 
-| Task | Section | Line Range |
+| Task | Section | Section ID |
 |------|---------|------------|
-| **New feature module** | Directory Structure | L5-30 |
-| **Write Query Hook** | Hook Guidelines > Query | L50-100 |
-| **Write Mutation Hook** | Hook Guidelines > Mutation | L100-150 |
-| **API calls** | API Guidelines | L150-250 |
-| **State management** | State Guidelines | L250-350 |
-| **Write component** | Component Guidelines | L350-500 |
-| **Performance optimization** | Performance Guidelines | L500-600 |
-| **Code quality check** | Quality Guidelines | L600-700 |
+| **New feature module** | Directory Structure | \`directory-structure\` |
+| **Write Query Hook** | Hook Guidelines > Query | \`query-hook\` |
+| **Write Mutation Hook** | Hook Guidelines > Mutation | \`mutation-hook\` |
+| **API calls** | API Guidelines | \`api-guidelines\` |
+| **State management** | State Guidelines | \`state-management\` |
+| **Write component** | Component Guidelines | \`component-guidelines\` |
+| **Performance optimization** | Performance Guidelines | \`performance-guidelines\` |
+| **Code quality check** | Quality Guidelines | \`quality-guidelines\` |
+
+## How to Read Sections
+
+\`\`\`bash
+# Extract a specific section by ID
+sed -n '/@@@section:query-hook/,/@@@\\/section:query-hook/p' doc.md
+\`\`\`
 
 ## Core Rules
 
-| Rule | Location |
-|------|----------|
-| Import types from backend | L50-60 |
-| Use semantic HTML | L400-420 |
-| Use Next.js Image | L420-440 |
-| No non-null assertions | L600-620 |
+| Rule | Section ID |
+|------|------------|
+| Import types from backend | \`type-safety\` |
+| Use semantic HTML | \`semantic-html\` |
+| Use Next.js Image | \`image-optimization\` |
+| No non-null assertions | \`quality-guidelines\` |
 
 ## Reference Files
 
@@ -521,7 +528,7 @@ This index helps you quickly locate the guidelines you need based on your task t
 
 ---
 
-Fill in the line numbers and reference files based on your project's doc.md content.
+**Language**: All documentation must be written in **English**.
 `;
     const frontendDoc = `# Frontend Development Guidelines
 
@@ -529,7 +536,8 @@ Fill in the line numbers and reference files based on your project's doc.md cont
 
 ---
 
-## 1. Directory Structure (L5-30)
+@@@section:directory-structure
+## 1. Directory Structure
 
 \`\`\`
 modules/
@@ -540,9 +548,12 @@ modules/
 │   └── types.ts        # Type definitions
 \`\`\`
 
+@@@/section:directory-structure
+
 ---
 
-## 2. Type Safety (L30-50)
+@@@section:type-safety
+## 2. Type Safety
 
 ### Import Types from Backend
 
@@ -559,11 +570,15 @@ interface User {
 }
 \`\`\`
 
+@@@/section:type-safety
+
 ---
 
-## 3. Hook Guidelines (L50-150)
+@@@section:hook-guidelines
+## 3. Hook Guidelines
 
-### Query Hook (L50-100)
+@@@section:query-hook
+### Query Hook
 
 \`\`\`typescript
 // Template for query hooks
@@ -577,7 +592,10 @@ export function useExample() {
 }
 \`\`\`
 
-### Mutation Hook (L100-150)
+@@@/section:query-hook
+
+@@@section:mutation-hook
+### Mutation Hook
 
 \`\`\`typescript
 // Template for mutation hooks
@@ -595,22 +613,34 @@ export function useUpdateExample() {
 }
 \`\`\`
 
+@@@/section:mutation-hook
+
+@@@/section:hook-guidelines
+
 ---
 
-## 4. API Guidelines (L150-250)
+@@@section:api-guidelines
+## 4. API Guidelines
 
 (Add your project-specific API guidelines here)
 
+@@@/section:api-guidelines
+
 ---
 
-## 5. State Management (L250-350)
+@@@section:state-management
+## 5. State Management
 
 (Add your project-specific state management guidelines here)
 
+@@@/section:state-management
+
 ---
 
-## 6. Component Guidelines (L350-500)
+@@@section:component-guidelines
+## 6. Component Guidelines
 
+@@@section:semantic-html
 ### Semantic HTML
 
 Use proper HTML elements:
@@ -623,6 +653,9 @@ Use proper HTML elements:
 <div role="button" onClick={handleClick}>Click me</div>
 \`\`\`
 
+@@@/section:semantic-html
+
+@@@section:image-optimization
 ### Image Optimization
 
 Use Next.js Image component:
@@ -636,15 +669,23 @@ import Image from 'next/image';
 <img src="/logo.png" alt="Logo" />
 \`\`\`
 
+@@@/section:image-optimization
+
+@@@/section:component-guidelines
+
 ---
 
-## 7. Performance Guidelines (L500-600)
+@@@section:performance-guidelines
+## 7. Performance Guidelines
 
 (Add your project-specific performance guidelines here)
 
+@@@/section:performance-guidelines
+
 ---
 
-## 8. Quality Guidelines (L600-700)
+@@@section:quality-guidelines
+## 8. Quality Guidelines
 
 ### Before Every Commit
 
@@ -658,9 +699,11 @@ import Image from 'next/image';
 - No \`any\` type
 - No unused imports/variables
 
+@@@/section:quality-guidelines
+
 ---
 
-**Note**: Update line numbers in index.md when you modify this document.
+**Language**: All documentation must be written in **English**.
 `;
     // Backend index.md
     const backendIndex = `# Backend Development Guidelines Index
@@ -671,24 +714,31 @@ This index helps you quickly locate the guidelines you need based on your task t
 
 ## Quick Navigation
 
-| Task | Section | Line Range |
+| Task | Section | Section ID |
 |------|---------|------------|
-| **New API module** | Directory Structure | L5-30 |
-| **Type safety** | Type Safety | L30-100 |
-| **Database operations** | Database Guidelines | L100-200 |
-| **Error handling** | Error Handling | L200-250 |
-| **Logging** | Logging Guidelines | L250-300 |
-| **AI/Prompt** | AI Guidelines | L300-400 |
-| **Code quality** | Quality Guidelines | L400-500 |
+| **New API module** | Directory Structure | \`directory-structure\` |
+| **Type safety** | Type Safety | \`type-safety\` |
+| **Database operations** | Database Guidelines | \`database-guidelines\` |
+| **Error handling** | Error Handling | \`error-handling\` |
+| **Logging** | Logging Guidelines | \`logging-guidelines\` |
+| **AI/Prompt** | AI Guidelines | \`ai-guidelines\` |
+| **Code quality** | Quality Guidelines | \`quality-guidelines\` |
+
+## How to Read Sections
+
+\`\`\`bash
+# Extract a specific section by ID
+sed -n '/@@@section:database-guidelines/,/@@@\\/section:database-guidelines/p' doc.md
+\`\`\`
 
 ## Core Rules
 
-| Rule | Location |
-|------|----------|
-| No non-null assertions | L40-60 |
-| All inputs/outputs need Zod Schema | L60-80 |
-| Use structured logging | L250-270 |
-| No await in loops | L120-140 |
+| Rule | Section ID |
+|------|------------|
+| No non-null assertions | \`non-null-assertion\` |
+| All inputs/outputs need Zod Schema | \`zod-schema\` |
+| Use structured logging | \`logging-guidelines\` |
+| No await in loops | \`no-await-in-loops\` |
 
 ## Reference Files
 
@@ -699,7 +749,7 @@ This index helps you quickly locate the guidelines you need based on your task t
 
 ---
 
-Fill in the line numbers and reference files based on your project's doc.md content.
+**Language**: All documentation must be written in **English**.
 `;
     const backendDoc = `# Backend Development Guidelines
 
@@ -707,7 +757,8 @@ Fill in the line numbers and reference files based on your project's doc.md cont
 
 ---
 
-## 1. Directory Structure (L5-30)
+@@@section:directory-structure
+## 1. Directory Structure
 
 \`\`\`
 packages/api/modules/
@@ -719,11 +770,15 @@ packages/api/modules/
 │       └── *.md
 \`\`\`
 
+@@@/section:directory-structure
+
 ---
 
-## 2. Type Safety (L30-100)
+@@@section:type-safety
+## 2. Type Safety
 
-### No Non-Null Assertions (L40-60)
+@@@section:non-null-assertion
+### No Non-Null Assertions
 
 \`\`\`typescript
 // ✅ Good - use local variable
@@ -737,7 +792,10 @@ const userName = user.name; // Safe access
 const userName = user!.name;
 \`\`\`
 
-### Zod Schema (L60-80)
+@@@/section:non-null-assertion
+
+@@@section:zod-schema
+### Zod Schema
 
 \`\`\`typescript
 // All inputs and outputs need Zod schemas
@@ -751,11 +809,17 @@ const outputSchema = z.object({
 });
 \`\`\`
 
+@@@/section:zod-schema
+
+@@@/section:type-safety
+
 ---
 
-## 3. Database Guidelines (L100-200)
+@@@section:database-guidelines
+## 3. Database Guidelines
 
-### No Await in Loops (L120-140)
+@@@section:no-await-in-loops
+### No Await in Loops
 
 \`\`\`typescript
 // ✅ Good - parallel execution
@@ -769,7 +833,9 @@ for (const id of ids) {
 }
 \`\`\`
 
-### Batch Operations (L140-160)
+@@@/section:no-await-in-loops
+
+### Batch Operations
 
 \`\`\`typescript
 // Use batch insert with conflict handling
@@ -779,15 +845,21 @@ await db.insert(users).values(data).onConflictDoUpdate({
 });
 \`\`\`
 
+@@@/section:database-guidelines
+
 ---
 
-## 4. Error Handling (L200-250)
+@@@section:error-handling
+## 4. Error Handling
 
 (Add your project-specific error handling guidelines here)
 
+@@@/section:error-handling
+
 ---
 
-## 5. Logging Guidelines (L250-300)
+@@@section:logging-guidelines
+## 5. Logging Guidelines
 
 ### Use Structured Logging
 
@@ -799,15 +871,21 @@ logger.info('User created', { userId: user.id, email: user.email });
 console.log('User created: ' + user.id);
 \`\`\`
 
+@@@/section:logging-guidelines
+
 ---
 
-## 6. AI Guidelines (L300-400)
+@@@section:ai-guidelines
+## 6. AI Guidelines
 
 (Add your project-specific AI/prompt guidelines here)
 
+@@@/section:ai-guidelines
+
 ---
 
-## 7. Quality Guidelines (L400-500)
+@@@section:quality-guidelines
+## 7. Quality Guidelines
 
 ### Before Every Commit
 
@@ -821,9 +899,11 @@ console.log('User created: ' + user.id);
 - No \`console.log\` (use logger)
 - No await in loops
 
+@@@/section:quality-guidelines
+
 ---
 
-**Note**: Update line numbers in index.md when you modify this document.
+**Language**: All documentation must be written in **English**.
 `;
     fs.writeFileSync(path.join(cwd, "workflow/structure/frontend/index.md"), frontendIndex);
     fs.writeFileSync(path.join(cwd, "workflow/structure/frontend/doc.md"), frontendDoc);
@@ -955,7 +1035,7 @@ Based on what you'll develop (frontend/backend), read the corresponding guidelin
 cat workflow/structure/frontend/index.md
 \`\`\`
 - Find corresponding chapters based on task type (e.g., "New Query Hook", "Write Component")
-- Note down chapter names and line number ranges
+- Note down chapter names and **section IDs** (e.g., \`query-hook\`)
 - This is **mandatory**, not optional
 
 **Backend Development**:
@@ -963,29 +1043,27 @@ cat workflow/structure/frontend/index.md
 cat workflow/structure/backend/index.md
 \`\`\`
 - Find corresponding chapters based on scenario (e.g., "New API Module", "Write Batch Tasks")
-- Note down chapter names and line number ranges
+- Note down chapter names and **section IDs** (e.g., \`database-guidelines\`)
 - This is **mandatory**, not optional
 
 ### Step 3: Read Specific Guidelines ⚠️ REQUIRED
 
 **⚠️ CRITICAL: Read detailed guidelines for your specific task**
 
-Based on line numbers found in index, read detailed guideline documents:
+Based on section IDs found in index, extract specific sections:
 
 **Frontend**:
 \`\`\`bash
-# Use Read tool to read specific line ranges
-# Example: L179-264 (Query Hook guidelines)
-Read workflow/structure/frontend/doc.md --offset 179 --limit 85
+# Extract specific section by ID
+sed -n '/@@@section:query-hook/,/@@@\\/section:query-hook/p' workflow/structure/frontend/doc.md
 \`\`\`
 - **MUST read** the sections relevant to your task
 - Do NOT skip this step
 
 **Backend**:
 \`\`\`bash
-# Use Read tool to read specific line ranges
-# Example: L5-28 (Directory structure guidelines)
-Read workflow/structure/backend/doc.md --offset 5 --limit 23
+# Extract specific section by ID
+sed -n '/@@@section:database-guidelines/,/@@@\\/section:database-guidelines/p' workflow/structure/backend/doc.md
 \`\`\`
 - **MUST read** the sections relevant to your task
 - Do NOT skip this step
@@ -1175,6 +1253,7 @@ planned → in-progress → completed
 7. ⚠️ **Don't** execute \`git commit\` - AI should not commit code
    - Only allowed: \`git log\`, \`git status\`, \`git diff\`
    - Human is responsible for testing and committing
+8. **Don't** write \`workflow/structure/\` docs in Chinese - **English only**
 
 ---
 
@@ -1213,13 +1292,13 @@ git status
 
 ### Must-read Before Development
 
-| Task Type | Must-read Document | Line Numbers |
+| Task Type | Must-read Document | Section ID |
 |---------|---------|------|
-| New Frontend Query Hook | \`frontend/doc.md\` | (see index.md) |
-| New Frontend Mutation Hook | \`frontend/doc.md\` | (see index.md) |
-| New Frontend Component | \`frontend/doc.md\` | (see index.md) |
-| New Backend API | \`backend/doc.md\` | (see index.md) |
-| Database Batch Operations | \`backend/doc.md\` | (see index.md) |
+| New Frontend Query Hook | \`frontend/doc.md\` | \`query-hook\` |
+| New Frontend Mutation Hook | \`frontend/doc.md\` | \`mutation-hook\` |
+| New Frontend Component | \`frontend/doc.md\` | \`component-guidelines\` |
+| New Backend API | \`backend/doc.md\` | \`directory-structure\`, \`type-safety\` |
+| Database Batch Operations | \`backend/doc.md\` | \`database-guidelines\` |
 
 ### Commit Convention
 
@@ -1339,6 +1418,10 @@ workflow/
 | \`/record-agent-flow\` | Record progress to agent-progress | After human commits code |
 | \`/generate-frontend-structure\` | Auto-generate frontend guidelines | Setting up project standards |
 | \`/generate-backend-structure\` | Auto-generate backend guidelines | Setting up project standards |
+| \`/before-frontend-dev\` | Read frontend guidelines before development | Before writing frontend code |
+| \`/before-backend-dev\` | Read backend guidelines before development | Before writing backend code |
+| \`/update-frontend-structure\` | Update frontend guidelines with new patterns | When new patterns are found |
+| \`/update-backend-structure\` | Update backend guidelines with new patterns | When new patterns are found |
 
 ### 1.5 AI Permission Boundaries
 

package/dist/configurators/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mind-fold/open-flow",
-	"version": "0.1.6",
+	"version": "0.1.8",
 	"description": "AI-assisted development workflow initializer for Cursor, Claude Code and more",
 	"type": "module",
 	"main": "./dist/index.js",