speccrew 0.1.0

package/workspace-template/docs/configs/platform-mapping.json

@@ -0,0 +1,194 @@
+{
+  "version": "1.0.0",
+  "description": "Platform naming mapping for consistent configuration across bizs and techs pipelines",
+  "last_updated": "2026-03-23",
+  "platform_categories": {
+    "web": {
+      "description": "Web frontend applications",
+      "subtypes": ["vue", "react", "angular", "nextjs", "nuxt", "svelte"]
+    },
+    "mobile": {
+      "description": "Mobile applications (all platforms)",
+      "subtypes": ["uniapp", "flutter", "react-native", "android", "ios", "miniprogram"]
+    },
+    "backend": {
+      "description": "Backend services and APIs",
+      "subtypes": ["spring", "nestjs", "express", "fastify", "django", "fastapi", "go", "rust"]
+    },
+    "desktop": {
+      "description": "Desktop applications",
+      "subtypes": ["electron", "tauri", "wpf", "winforms", "qt"]
+    },
+    "api": {
+      "description": "API-only systems (no UI)",
+      "subtypes": ["rest", "graphql", "grpc"]
+    }
+  },
+  "mappings": [
+    {
+      "platform_id": "web-react",
+      "platform_type": "web",
+      "framework": "react",
+      "platform_subtype": "react"
+    },
+    {
+      "platform_id": "web-vue",
+      "platform_type": "web",
+      "framework": "vue",
+      "platform_subtype": "vue"
+    },
+    {
+      "platform_id": "web-angular",
+      "platform_type": "web",
+      "framework": "angular",
+      "platform_subtype": "angular"
+    },
+    {
+      "platform_id": "web-nextjs",
+      "platform_type": "web",
+      "framework": "nextjs",
+      "platform_subtype": "nextjs"
+    },
+    {
+      "platform_id": "web-nuxt",
+      "platform_type": "web",
+      "framework": "nuxt",
+      "platform_subtype": "nuxt"
+    },
+    {
+      "platform_id": "web-svelte",
+      "platform_type": "web",
+      "framework": "svelte",
+      "platform_subtype": "svelte"
+    },
+    {
+      "platform_id": "mobile-uniapp",
+      "platform_type": "mobile",
+      "framework": "uniapp",
+      "platform_subtype": "uniapp"
+    },
+    {
+      "platform_id": "mobile-flutter",
+      "platform_type": "mobile",
+      "framework": "flutter",
+      "platform_subtype": "flutter"
+    },
+    {
+      "platform_id": "mobile-react-native",
+      "platform_type": "mobile",
+      "framework": "react-native",
+      "platform_subtype": "react-native"
+    },
+    {
+      "platform_id": "mobile-android",
+      "platform_type": "mobile",
+      "framework": "android",
+      "platform_subtype": "android"
+    },
+    {
+      "platform_id": "mobile-ios",
+      "platform_type": "mobile",
+      "framework": "ios",
+      "platform_subtype": "ios"
+    },
+    {
+      "platform_id": "mobile-miniprogram",
+      "platform_type": "mobile",
+      "framework": "miniprogram",
+      "platform_subtype": "miniprogram"
+    },
+    {
+      "platform_id": "backend-spring",
+      "platform_type": "backend",
+      "framework": "spring",
+      "platform_subtype": "spring"
+    },
+    {
+      "platform_id": "backend-nestjs",
+      "platform_type": "backend",
+      "framework": "nestjs",
+      "platform_subtype": "nestjs"
+    },
+    {
+      "platform_id": "backend-express",
+      "platform_type": "backend",
+      "framework": "express",
+      "platform_subtype": "express"
+    },
+    {
+      "platform_id": "backend-fastify",
+      "platform_type": "backend",
+      "framework": "fastify",
+      "platform_subtype": "fastify"
+    },
+    {
+      "platform_id": "backend-django",
+      "platform_type": "backend",
+      "framework": "django",
+      "platform_subtype": "django"
+    },
+    {
+      "platform_id": "backend-fastapi",
+      "platform_type": "backend",
+      "framework": "fastapi",
+      "platform_subtype": "fastapi"
+    },
+    {
+      "platform_id": "backend-go",
+      "platform_type": "backend",
+      "framework": "go",
+      "platform_subtype": "go"
+    },
+    {
+      "platform_id": "backend-rust",
+      "platform_type": "backend",
+      "framework": "rust",
+      "platform_subtype": "rust"
+    },
+    {
+      "platform_id": "desktop-electron",
+      "platform_type": "desktop",
+      "framework": "electron",
+      "platform_subtype": "electron"
+    },
+    {
+      "platform_id": "desktop-tauri",
+      "platform_type": "desktop",
+      "framework": "tauri",
+      "platform_subtype": "tauri"
+    },
+    {
+      "platform_id": "desktop-wpf",
+      "platform_type": "desktop",
+      "framework": "wpf",
+      "platform_subtype": "wpf"
+    },
+    {
+      "platform_id": "desktop-winforms",
+      "platform_type": "desktop",
+      "framework": "winforms",
+      "platform_subtype": "winforms"
+    },
+    {
+      "platform_id": "desktop-qt",
+      "platform_type": "desktop",
+      "framework": "qt",
+      "platform_subtype": "qt"
+    }
+  ],
+  "naming_conventions": {
+    "platform_id_format": "{platform_type}-{framework}",
+    "platform_type_values": ["web", "mobile", "backend", "desktop", "api"],
+    "field_mapping": {
+      "bizs_init": {
+        "platform_type": "platform_type",
+        "platform_subtype": "platform_subtype"
+      },
+      "techs_init": {
+        "platform_type": "platform_type",
+        "framework": "framework",
+        "platform_id": "platform_id"
+      }
+    }
+  }
+}

package/workspace-template/docs/configs/tech-stack-mappings.json

@@ -0,0 +1,313 @@
+{
+  "version": "1.0.0",
+  "description": "Technology stack mappings for file extensions, API patterns, and analysis rules",
+  "last_updated": "2026-03-23",
+  "global_exclude_dirs": [
+    "node_modules", ".git", ".svn",
+    "dist", "build", "out", "output", "target",
+    "e2e", "test", "tests", "__tests__",
+    "coverage", ".nyc_output",
+    ".idea", ".vscode", ".qoder", ".speccrew",
+    "playwright-report", "test-results",
+    ".next", ".nuxt", ".output",
+    "docs", "scripts", "public", "assets", "mock", "fixtures"
+  ],
+  "tech_stacks": {
+    "web": {
+      "react": {
+        "extensions": [".tsx", ".ts", ".jsx", ".js"],
+        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "hocs", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["src/pages/**/*.{tsx,jsx}", "src/components/**/*.{tsx,jsx}"],
+        "api_call_patterns": ["fetch(", "axios.", "apiClient.", "useQuery", "useMutation"],
+        "state_management": ["useState", "useReducer", "Redux", "Zustand", "MobX"],
+        "routing": ["react-router", "next/router"],
+        "component_patterns": ["export default function", "export const", "React.FC"]
+      },
+      "vue": {
+        "extensions": [".vue", ".ts", ".js"],
+        "exclude_dirs": ["components", "composables", "hooks", "utils", "mixins", "directives", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["src/views/**/*.vue", "src/components/**/*.vue", "pages/**/*.vue"],
+        "api_call_patterns": ["axios.", "fetch(", "$http", "useFetch"],
+        "state_management": ["Pinia", "Vuex", "ref", "reactive", "computed"],
+        "routing": ["vue-router"],
+        "component_patterns": ["<template>", "export default", "defineComponent"]
+      },
+      "angular": {
+        "extensions": [".ts", ".html", ".scss", ".css"],
+        "exclude_dirs": ["components", "directives", "pipes", "guards", "interceptors", "services", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["src/app/components/**/*.ts", "src/app/pages/**/*.ts"],
+        "api_call_patterns": ["HttpClient", "http.get", "http.post"],
+        "state_management": ["RxJS", "NgRx", "BehaviorSubject", "Observable"],
+        "routing": ["@angular/router"],
+        "component_patterns": ["@Component", "export class", "implements OnInit"]
+      },
+      "nextjs": {
+        "extensions": [".tsx", ".ts", ".jsx", ".js"],
+        "exclude_dirs": ["components", "hooks", "lib", "utils", "contexts", "api", "src", "views", "pages", "layout", "layouts", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["app/**/*.{tsx,jsx}", "pages/**/*.{tsx,jsx}"],
+        "api_call_patterns": ["fetch(", "axios.", "useSWR", "React Query"],
+        "state_management": ["useState", "Zustand", "Redux", "Context API"],
+        "routing": ["file-system routing", "next/navigation"],
+        "component_patterns": ["export default", "async function", "'use client'"]
+      },
+      "nuxt": {
+        "extensions": [".vue", ".ts", ".js"],
+        "exclude_dirs": ["components", "composables", "utils", "plugins", "middleware", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["pages/**/*.vue", "components/**/*.vue"],
+        "api_call_patterns": ["$fetch", "useFetch", "axios."],
+        "state_management": ["Pinia", "useState", "composables"],
+        "routing": ["file-system routing", "vue-router"],
+        "component_patterns": ["<template>", "<script setup>", "definePageMeta"]
+      },
+      "svelte": {
+        "extensions": [".svelte", ".ts", ".js"],
+        "exclude_dirs": ["components", "lib", "utils", "stores", "actions", "src", "views", "pages", "api", "layout", "layouts", "assets", "store", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["src/**/*.svelte", "routes/**/*.svelte"],
+        "api_call_patterns": ["fetch(", "axios."],
+        "state_management": ["writable", "readable", "derived", "Svelte Store"],
+        "routing": ["svelte-routing", "file-system routing"],
+        "component_patterns": ["<script>", "export let", "{#if}"]
+      }
+    },
+    "mobile": {
+      "flutter": {
+        "extensions": [".dart"],
+        "exclude_dirs": ["widgets", "components", "utils", "helpers", "models", "services"],
+        "entry_patterns": ["lib/**/*.dart", "lib/pages/**/*.dart", "lib/screens/**/*.dart"],
+        "api_call_patterns": ["http.", "dio.", "Dio()", "get(", "post("],
+        "state_management": ["Provider", "Riverpod", "Bloc", "GetX", "MobX"],
+        "routing": ["Navigator", "GoRouter", "Get.to"],
+        "component_patterns": ["class.*extends StatelessWidget", "class.*extends StatefulWidget", "@override Widget build"]
+      },
+      "react-native": {
+        "extensions": [".tsx", ".ts", ".jsx", ".js"],
+        "exclude_dirs": ["components", "hooks", "utils", "contexts", "navigations", "src", "views", "pages", "api", "screens", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs"],
+        "entry_patterns": ["src/screens/**/*.{tsx,jsx}", "src/components/**/*.{tsx,jsx}"],
+        "api_call_patterns": ["fetch(", "axios.", "apiClient."],
+        "state_management": ["useState", "Redux", "MobX", "Zustand", "Recoil"],
+        "routing": ["react-navigation", "expo-router"],
+        "component_patterns": ["export default function", "const.*=.*=>"]
+      },
+      "uniapp": {
+        "extensions": [".vue", ".ts", ".js"],
+        "exclude_dirs": ["components", "composables", "utils", "mixins", "directives", "src", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "plugins", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
+        "exclude_file_suffixes": [],
+        "strip_module_prefixes": ["pages-"],
+        "entry_patterns": ["pages/**/*.vue", "components/**/*.vue"],
+        "api_call_patterns": ["uni.request", "uni.uploadFile", "uni.downloadFile"],
+        "state_management": ["Vuex", "Pinia", "globalData"],
+        "routing": ["pages.json", "uni.navigateTo"],
+        "component_patterns": ["<template>", "export default", "onLoad", "onShow"]
+      },
+      "android": {
+        "extensions": [".kt", ".java", ".xml"],
+        "entry_patterns": ["app/src/main/java/**/*.kt", "app/src/main/java/**/*.java"],
+        "api_call_patterns": ["Retrofit", "OkHttp", "HttpURLConnection"],
+        "state_management": ["ViewModel", "LiveData", "StateFlow", "Compose State"],
+        "routing": ["Intent", "Navigation Component", "Jetpack Navigation"],
+        "component_patterns": ["class.*Activity", "class.*Fragment", "@Composable"]
+      },
+      "ios": {
+        "extensions": [".swift", ".m", ".h", ".storyboard"],
+        "entry_patterns": ["**/*.swift", "ViewControllers/**/*.swift"],
+        "api_call_patterns": ["URLSession", "Alamofire", "AF.request"],
+        "state_management": ["@State", "@ObservedObject", "@StateObject", "Combine"],
+        "routing": ["NavigationView", "TabView", "UIStoryboardSegue"],
+        "component_patterns": ["struct.*View", "class.*ViewController", "var body: some View"]
+      },
+      "miniprogram": {
+        "extensions": [".js", ".ts", ".wxml", ".wxss", ".json"],
+        "exclude_dirs": ["components", "utils", "behaviors", "mixins", "src", "views", "pages", "api", "static", "assets", "store", "stores", "router", "routes", "styles", "types", "typings", "locales", "i18n", "lang", "config", "configs", "http", "tabbar", "constants", "common", "hooks", "style"],
+        "exclude_file_suffixes": [],
+        "strip_module_prefixes": ["pages-"],
+        "entry_patterns": ["pages/**/*.js", "pages/**/*.ts", "components/**/*.js"],
+        "api_call_patterns": ["wx.request", "wx.uploadFile", "wx.downloadFile"],
+        "state_management": ["Page data", "globalData", "MobX", "Westore"],
+        "routing": ["app.json pages", "wx.navigateTo", "wx.redirectTo"],
+        "component_patterns": ["Page({", "Component({", "properties:", "data:"]
+      }
+    },
+    "backend": {
+      "spring": {
+        "extensions": [".java", ".kt"],
+        "exclude_dirs": ["controller", "controllers", "admin", "app", "api", "service", "services", "repository", "repositories", "dao", "dal", "mysql", "redis", "dataobject", "entity", "entities", "model", "models", "dto", "dtos", "vo", "vos", "mapper", "mappers", "convert", "converter", "converters", "config", "configs", "util", "utils", "common", "exception", "exceptions", "enums", "framework", "job", "mq", "listener", "listeners", "producer", "consumer"],
+        "exclude_file_suffixes": ["VO", "DTO", "DO", "Entity", "Convert", "Converter"],
+        "entry_patterns": ["**/*Controller.java", "**/*Controller.kt", "**/*Service.java"],
+        "api_patterns": {
+          "controller": ["@Controller", "@RestController", "@RequestMapping"],
+          "methods": ["@GetMapping", "@PostMapping", "@PutMapping", "@DeleteMapping", "@PatchMapping"],
+          "parameters": ["@RequestBody", "@PathVariable", "@RequestParam", "@Valid"]
+        },
+        "dto_patterns": ["class.*DTO", "class.*VO", "class.*Request", "class.*Response"],
+        "entity_patterns": ["@Entity", "@Table", "class.*DO", "class.*PO"],
+        "validation": ["@Valid", "@NotNull", "@NotBlank", "@Size", "@Pattern"]
+      },
+      "nestjs": {
+        "extensions": [".ts"],
+        "exclude_dirs": ["services", "repositories", "entities", "dtos", "guards", "interceptors", "middleware", "pipes", "filters", "decorators", "utils", "helpers"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["**/*.controller.ts", "**/*.service.ts", "**/*.module.ts"],
+        "api_patterns": {
+          "controller": ["@Controller"],
+          "methods": ["@Get", "@Post", "@Put", "@Delete", "@Patch", "@Query", "@Param", "@Body"],
+          "parameters": ["@Req", "@Res", "@Query", "@Param", "@Body", "@Headers"]
+        },
+        "dto_patterns": ["class.*Dto", "class.*DTO", "interface.*Dto"],
+        "entity_patterns": ["@Entity", "class.*Entity", "interface.*Entity"],
+        "validation": ["class-validator", "@IsString", "@IsNumber", "@IsOptional", "@Validate"]
+      },
+      "express": {
+        "extensions": [".js", ".ts"],
+        "exclude_dirs": ["services", "models", "middleware", "utils", "helpers", "validators", "schemas"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["routes/**/*.js", "controllers/**/*.js", "**/*.routes.ts"],
+        "api_patterns": {
+          "router": ["router.get", "router.post", "router.put", "router.delete", "router.patch"],
+          "app": ["app.get", "app.post", "app.use"],
+          "middleware": ["req, res, next", "async (req, res)"]
+        },
+        "dto_patterns": ["Joi validation", "express-validator", "manual validation"],
+        "entity_patterns": ["mongoose model", "sequelize model", "prisma schema"],
+        "validation": ["Joi.object", "body()", "param()", "query()"]
+      },
+      "fastify": {
+        "extensions": [".js", ".ts"],
+        "exclude_dirs": ["services", "models", "schemas", "plugins", "hooks", "utils", "helpers"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["routes/**/*.js", "**/*.routes.ts"],
+        "api_patterns": {
+          "routes": ["fastify.get", "fastify.post", "fastify.route"],
+          "schema": ["schema:", "body:", "querystring:", "params:"]
+        },
+        "dto_patterns": ["JSON Schema", "typebox", "fastify-schema"],
+        "entity_patterns": ["mongoose", "prisma", "typeorm"],
+        "validation": ["ajv", "JSON Schema validation"]
+      },
+      "django": {
+        "extensions": [".py"],
+        "exclude_dirs": ["models", "serializers", "forms", "utils", "helpers", "middleware", "templatetags"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["views.py", "**/views/*.py", "api/*.py"],
+        "api_patterns": {
+          "views": ["def.*request", "class.*APIView", "@api_view"],
+          "decorators": ["@require_http_methods", "@csrf_exempt", "@permission_classes"]
+        },
+        "dto_patterns": ["Serializer", "ModelSerializer", "Form"],
+        "entity_patterns": ["class.*models.Model", "models.CharField", "models.ForeignKey"],
+        "validation": ["serializer.is_valid", "form.is_valid", "validate_*"]
+      },
+      "fastapi": {
+        "extensions": [".py"],
+        "exclude_dirs": ["models", "schemas", "services", "repositories", "utils", "helpers", "dependencies", "middleware"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["main.py", "routers/*.py", "api/*.py"],
+        "api_patterns": {
+          "routes": ["@app.get", "@app.post", "@app.put", "@app.delete", "@router.get"],
+          "dependencies": ["Depends", "Query", "Path", "Body"]
+        },
+        "dto_patterns": ["BaseModel", "Pydantic model", "class.*Schema"],
+        "entity_patterns": ["SQLAlchemy", "Tortoise ORM", "Prisma Client"],
+        "validation": ["Pydantic validation", "Field(...)", "validator"]
+      },
+      "go": {
+        "extensions": [".go"],
+        "exclude_dirs": ["service", "services", "repository", "repositories", "model", "models", "dto", "dtos", "middleware", "utils", "helpers"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["**/*.go", "handlers/*.go", "controllers/*.go"],
+        "api_patterns": {
+          "router": ["gin.Router", "echo.Echo", "mux.Router", "http.HandleFunc"],
+          "handlers": ["gin.HandlerFunc", "echo.HandlerFunc", "func.*http.ResponseWriter"]
+        },
+        "dto_patterns": ["struct.*Request", "struct.*Response", "type.*DTO"],
+        "entity_patterns": ["gorm.Model", "bun:", "ent.*"],
+        "validation": ["go-playground/validator", "validate struct tags"]
+      },
+      "rust": {
+        "extensions": [".rs"],
+        "exclude_dirs": ["service", "services", "repository", "repositories", "model", "models", "dto", "dtos", "middleware", "utils", "helpers", "schema", "migrations"],
+        "exclude_file_suffixes": [],
+        "entry_patterns": ["src/**/*.rs", "handlers/*.rs", "routes/*.rs"],
+        "api_patterns": {
+          "frameworks": ["actix-web", "axum", "rocket", "warp"],
+          "handlers": ["#[get]", "#[post]", "async fn", "HttpResponse"]
+        },
+        "dto_patterns": ["struct.*Request", "struct.*Response", "#[derive(Deserialize)]"],
+        "entity_patterns": ["diesel", "sea-orm", "sqlx"],
+        "validation": ["validator crate", "#[validate]", "Validate trait"]
+      }
+    },
+    "desktop": {
+      "electron": {
+        "extensions": [".ts", ".tsx", ".js", ".jsx", ".html"],
+        "entry_patterns": ["src/main.ts", "src/renderer/**/*.tsx", "src/preload.ts"],
+        "ipc_patterns": ["ipcMain", "ipcRenderer", "contextBridge"],
+        "state_management": ["Redux", "Zustand", "Electron Store"],
+        "component_patterns": ["React", "Vue", "Angular in renderer"]
+      },
+      "tauri": {
+        "extensions": [".rs", ".ts", ".tsx", ".vue"],
+        "entry_patterns": ["src-tauri/src/main.rs", "src/**/*.ts", "src/**/*.vue"],
+        "ipc_patterns": ["invoke", "listen", "emit", "#[tauri::command]"],
+        "state_management": ["Pinia", "Redux", "Tauri Store"],
+        "component_patterns": ["Frontend framework components", "Rust commands"]
+      },
+      "wpf": {
+        "extensions": [".cs", ".xaml"],
+        "entry_patterns": ["**/*.xaml.cs", "ViewModels/**/*.cs", "Views/**/*.xaml"],
+        "patterns": ["INotifyPropertyChanged", "ICommand", "MVVM"],
+        "state_management": ["MVVM", "ObservableObject", "RelayCommand"]
+      },
+      "winforms": {
+        "extensions": [".cs", ".vb"],
+        "entry_patterns": ["**/*.cs", "Forms/**/*.cs"],
+        "patterns": ["Form class", "Event handlers", "Control bindings"],
+        "state_management": ["DataBinding", "INotifyPropertyChanged"]
+      },
+      "qt": {
+        "extensions": [".cpp", ".h", ".ui", ".py"],
+        "entry_patterns": ["src/**/*.cpp", "widgets/**/*.cpp", "*.ui"],
+        "patterns": ["Q_OBJECT", "signals:", "slots:", "connect("],
+        "state_management": ["Qt Property System", "QAbstractItemModel"]
+      }
+    },
+    "api": {
+      "rest": {
+        "description": "RESTful API conventions",
+        "methods": ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"],
+        "status_codes": {
+          "success": [200, 201, 204],
+          "client_error": [400, 401, 403, 404, 409, 422],
+          "server_error": [500, 502, 503, 504]
+        },
+        "content_types": ["application/json", "application/xml", "multipart/form-data"]
+      },
+      "graphql": {
+        "extensions": [".graphql", ".gql", ".ts", ".js"],
+        "entry_patterns": ["schema.graphql", "resolvers/**/*.ts", "typeDefs/**/*.ts"],
+        "patterns": ["type Query", "type Mutation", "type Subscription", "@Resolver"],
+        "operations": ["query", "mutation", "subscription"]
+      },
+      "grpc": {
+        "extensions": [".proto", ".pb.go", ".pb.java", ".grpc.pb.ts"],
+        "entry_patterns": ["**/*.proto", "**/*_pb2*.py", "**/*.pb.go"],
+        "patterns": ["service.*{", "rpc.*(", "message.*{", "protoc"],
+        "types": ["Unary", "Server Streaming", "Client Streaming", "Bidirectional"]
+      }
+    }
+  },
+  "analysis_rules": {
+    "file_search_priority": [
+      "entry_points from modules.json",
+      "**/{module_name}/**/*.{extensions}",
+      "platform-specific patterns"
+    ],
+    "api_detection": {
+      "ui_modules": "trace fetch/axios/apiClient calls",
+      "api_modules": "parse decorators and method signatures"
+    },
+    "feature_extraction": {
+      "ui": "Each page/screen or major user interaction = one feature",
+      "api": "Each public API endpoint = one feature"
+    }
+  }
+}

package/workspace-template/docs/configs/validation-rules.json

@@ -0,0 +1,87 @@
+{
+  "version": "1.0.0",
+  "description": "Cross-skill validation rules for consistent data validation across all skills",
+  "last_updated": "2026-03-23",
+  "naming_conventions": {
+    "skill_name": {
+      "pattern": "^speccrew-[a-z]+(-[a-z]+)*$",
+      "description": "Skill names must use lowercase with hyphens, prefixed with 'speccrew-'",
+      "examples": ["speccrew-knowledge-bizs-init", "speccrew-knowledge-dispatch"],
+      "invalid_examples": ["Speccrew-Knowledge", "speccrew_knowledge", "knowledge-bizs-init"]
+    },
+    "module_name": {
+      "pattern": "^[a-z]+(-[a-z]+)*$",
+      "description": "Module names must use lowercase with hyphens",
+      "examples": ["order-management", "user-center", "payment-gateway"],
+      "invalid_examples": ["OrderManagement", "order_management", "Order-Center"]
+    },
+    "platform_id": {
+      "pattern": "^(web|mobile|backend|desktop|api)-[a-z]+$",
+      "description": "Platform ID must follow {platform_type}-{framework} format",
+      "examples": ["web-react", "mobile-flutter", "backend-spring"],
+      "invalid_examples": ["web_react", "Mobile-Flutter", "backend"]
+    },
+    "feature_name": {
+      "pattern": "^[a-z]+(-[a-z]+)*$",
+      "description": "Feature names must use lowercase with hyphens",
+      "examples": ["create-order", "list-users", "get-user-detail"],
+      "invalid_examples": ["CreateOrder", "create_order", "Create-Order"]
+    },
+    "file_name": {
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*\\.md$",
+      "description": "Markdown file names must use lowercase with hyphens",
+      "examples": ["order-overview.md", "create-order.md", "system-summarize.md"],
+      "invalid_examples": ["OrderOverview.md", "create_order.md", "Create-Order.md"]
+    }
+  },
+  "required_fields": {
+    "modules_json": {
+      "fields": ["code_name", "display_name", "system_type", "entry_points"],
+      "conditional_fields": {
+        "system_type:ui": ["backend_apis"],
+        "system_type:api": ["base_path"]
+      }
+    },
+    "platform_config": {
+      "fields": ["platform_type", "platform_subtype", "source_path", "tech_stack"]
+    },
+    "feature_detail": {
+      "fields": ["feature_name", "module_name", "api_method", "api_path"],
+      "optional_fields": ["validation_rules", "business_rules", "source_files"]
+    }
+  },
+  "path_validations": {
+    "workspace_root": {
+      "pattern": "^speccrew-workspace/$",
+      "description": "All knowledge outputs must be under speccrew-workspace/"
+    },
+    "knowledge_base_path": {
+      "pattern": "^speccrew-workspace/knowledges/(bizs|techs|base)/",
+      "description": "Knowledge files must be under bizs/, techs/, or base/"
+    },
+    "module_output_path": {
+      "pattern": "^speccrew-workspace/knowledges/(bizs|techs)/{platform_type}/{module_name}/$",
+      "description": "Module output must follow platform_type/module_name structure"
+    }
+  },
+  "language_codes": {
+    "valid_codes": ["zh", "en", "ja", "ko", "fr", "de", "es"],
+    "default": "zh",
+    "mapping": {
+      "zh": "中文",
+      "en": "English",
+      "ja": "日本語",
+      "ko": "한국어",
+      "fr": "Français",
+      "de": "Deutsch",
+      "es": "Español"
+    }
+  },
+  "system_type_values": {
+    "valid_values": ["ui", "api"],
+    "descriptions": {
+      "ui": "UI-based modules with pages/components",
+      "api": "API-based modules with controllers/handlers"
+    }
+  }
+}