docs: publish phased development workflow

Author: XucroYuri

README.md

@@ -90,6 +90,18 @@ docker compose --profile gpu up --build
 
 ---
 
+## 🧭 开发闭环
+
+本仓库的开发、迭代、重构与修复默认遵循“分阶段完成即提交并推送”的闭环流程。
+
+- 每个需求都要先拆成符合功能逻辑的阶段。
+- 每完成一个阶段，都要先验证，再单独提交，再推送到 GitHub，然后继续下一个阶段。
+- 不允许把多个里程碑揉成一次总提交，也不允许停留在“只做计划、不继续执行”的半完成状态。
+
+完整规则见：[docs/development-workflow.md](./docs/development-workflow.md)
+
+---
+
 ## 🧠 本地模型
 
 LocalVideo 当前的视频主引擎为 **Seedance 2.0**，并通过 **Wan2GP** 提供本地音频、图片与视频回退能力；本地视频最高支持 1080p 分辨率。

README_EN.md

@@ -95,6 +95,18 @@ docker compose --profile gpu up --build
 
 ---
 
+## 🧭 Development Loop
+
+This repository follows a mandatory "finish phase -> verify -> commit -> push -> continue" workflow for development, iteration, refactors, and non-trivial fixes.
+
+- Each request should be split into milestone-based phases that match product or functional boundaries.
+- After each completed phase, verify it, create one scoped commit, push it to GitHub, and then continue to the next phase.
+- Do not collapse multiple milestones into one catch-all commit, and do not stop after planning when the next safe phase is already executable.
+
+Full workflow: [docs/development-workflow.md](./docs/development-workflow.md)
+
+---
+
 ## 🧠 Local Models
 
 LocalVideo now uses **Seedance 2.0** as the primary video engine, while **Wan2GP** provides local audio, image, and video fallback capabilities, with local video support up to 1080p output.

docs/development-workflow.md

@@ -0,0 +1,36 @@
+# LocalVideo Development Workflow
+
+This repository uses a mandatory milestone-based delivery loop for feature work, refactors, and non-trivial fixes.
+
+## Core Rule
+
+Every meaningful task must be executed as a sequence of phases. Each phase must be completed, verified, committed, and pushed to GitHub before the next phase begins.
+
+## Required Loop
+
+1. Split the requested work into milestone-based phases that match product behavior or functional boundaries.
+2. Implement only the current phase.
+3. Run the verification that proves the current phase works.
+4. Create one scoped commit for that phase.
+5. Push the phase commit to GitHub.
+6. Continue into the next phase immediately unless a real blocker appears.
+
+## Constraints
+
+- Do not batch multiple milestones into one commit.
+- Do not leave a phase in a knowingly broken state.
+- Do not stop after planning if the next phase can already be executed safely.
+- Do not rewrite published history unless explicitly requested.
+- Keep `Seedance 2.0` through `kwjm.com` as the primary video path.
+- Keep `Wan2GP` as the local fallback path when the API path is unavailable.
+
+## Verification Standard
+
+- Never mark a phase complete without concrete verification commands.
+- Prefer fast, phase-scoped checks during implementation.
+- Run broader validation before declaring the full request complete when the scope justifies it.
+- If a check cannot be run, record exactly what was skipped and why.
+
+## Completion Standard
+
+The work is only done when all planned phases have been executed, verified, committed, pushed, and the remaining local git state is clean or explicitly explained.