@guanlin4924/devflow-pi 0.1.0

package/plugins/devflow-core/skills/workflow-orchestrator/templates/feature-development.yaml

@@ -0,0 +1,783 @@
+schema_version: 1
+id: feature-development
+name: Feature Development Workflow
+description: >
+  Generic feature delivery workflow for OMP-controlled .planning projects.
+  Generated by workflow-orchestrator.
+
+phase_scope:
+  name: workflow-control-plane
+  orchestrator_skill_enabled: true
+  orchestrator_auto_executes_skills: true
+  artifact_registry_enabled: true
+  failure_branch_enabled: true
+  parallel_window_enabled: true
+
+artifact_registry:
+  source: ".planning/artifacts/index.yaml"
+  path_key: path
+  status_key: status
+  pending_statuses:
+    - planned
+    - pending_rerun
+  terminal_success_statuses:
+    - approved
+    - completed
+    - passed
+
+lessons_policy:
+  sources:
+    - path: ".context/lessons/README.md"
+      required: false
+    - path: ".planning/lessons/README.md"
+      required: false
+  selection:
+    enabled: true
+    max_candidates: 5
+    min_score: 1
+  write:
+    enabled: true
+    default_dir: ".context/lessons"
+    index_path: ".context/lessons/README.md"
+    template_only: true
+
+parallel_windows:
+  - id: dual-track-design
+    label: API contract based frontend/backend design parallel window
+    after_step: api-contract
+    branch_steps:
+      - backend-tech-spec
+      - ui-spec
+    branches:
+      track_a:
+        - backend-tech-spec
+        - api-call-guide
+      track_b:
+        - ui-spec
+        - feature-breakdown
+        - frontend-tech-spec
+        - api-supplement
+    join_step: integration-verify
+    checkpoint: CP-2
+    execution_policy:
+      mode: parallel_when_supported
+      serial_fallback_order:
+        - backend-tech-spec
+        - api-call-guide
+        - ui-spec
+        - feature-breakdown
+        - frontend-tech-spec
+        - api-supplement
+      join_requires:
+        - ".planning/features/{feature}/api-call-guide.md"
+        - ".planning/features/{feature}/前端技术方案.md"
+
+failure_branches:
+  verify:
+    id: verify-failed-remediation
+    label: Verify failure remediation
+    workflow: uat-remediation
+    workflow_config: ".planning/workflows/uat-remediation.yaml"
+    trigger_conditions:
+      state_statuses:
+        - failed
+      checkpoint_decisions:
+        - rejected
+        - needs_fix
+      artifact_statuses:
+        - failed
+    resume_after_success:
+      flow: feature-development
+      step: verify
+      status: waiting_checkpoint
+      checkpoint: CP-4
+
+state_contract:
+  source: ".planning/STATE.md"
+  parser_hint: "read YAML front matter first, then fall back to Markdown sections"
+  required_fields:
+    - current_flow
+    - current_feature
+    - current_phase
+    - current_step
+    - status
+    - completed_steps
+    - pending_steps
+
+variables:
+  feature:
+    source: state.current_feature
+  phase:
+    source: state.current_phase
+
+statuses:
+  - not_started
+  - in_progress
+  - waiting_checkpoint
+  - completed
+  - blocked
+  - failed
+  - remediation
+
+checkpoints:
+  CP-1:
+    name: Requirement baseline confirmation
+    gate_after: requirement-baseline
+    producing_step: requirement-baseline
+    required_outputs:
+      - ".planning/requirements/baseline.md"
+    required_meta_output: ".planning/requirements/baseline.meta.json"
+    required_meta_fields:
+      - review_status
+      - fp_count
+      - br_count
+      - bc_count
+      - blocking_pending_count
+      - critical_image_missing_count
+      - challenge_pending_count
+      - code_reality_missing_count
+      - current_feature
+      - depends_on_count
+    summary_fields:
+      - fp_count
+      - br_count
+      - bc_count
+      - blocking_pending_count
+      - critical_image_missing_count
+      - challenge_pending_count
+      - code_reality_missing_count
+      - key_decisions
+      - risks
+    prompt: "确认需求基线是否准确完整，并允许进入 UI/功能拆解和技术方案阶段。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then continue with api-contract"
+  CP-API:
+    name: API contract confirmation
+    gate_after: api-contract
+    producing_step: api-contract
+    required_outputs:
+      - ".planning/features/{feature}/api-contract.md"
+    required_meta_output: ".planning/features/{feature}/api-contract.meta.json"
+    required_meta_fields:
+      - review_status
+      - endpoint_count
+      - api_required
+      - pending_contract_count
+      - breaking_change_count
+      - permission_rule_count
+      - error_case_count
+    summary_fields:
+      - endpoint_count
+      - api_required
+      - pending_contract_count
+      - breaking_change_count
+      - permission_rule_count
+      - error_case_count
+    prompt: "确认 API 契约是否完整、字段/错误/权限/兼容性是否已拍板，并允许前后端分轨设计。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then enter Track A/Track B design"
+  CP-2:
+    name: Merge Gate confirmation
+    gate_after: integration-verify
+    producing_step: integration-verify
+    required_outputs:
+      - ".planning/features/{feature}/integration-report.md"
+    required_meta_output: ".planning/features/{feature}/integration-report.meta.json"
+    required_meta_fields:
+      - merge_gate_status
+      - api_required
+      - contract_backend_mismatch_count
+      - contract_frontend_mismatch_count
+      - unhandled_api_supplement_count
+      - blocking_issue_count
+    summary_fields:
+      - merge_gate_status
+      - api_required
+      - contract_backend_mismatch_count
+      - contract_frontend_mismatch_count
+      - unhandled_api_supplement_count
+      - blocking_issue_count
+    prompt: "确认 API 契约、后端方案、前端调用三方一致，并允许进入变更清单。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then continue with change-plan"
+  CP-3:
+    name: Change plan confirmation
+    gate_after: change-plan
+    producing_step: change-plan
+    required_outputs:
+      - ".planning/features/{feature}/变更清单.md"
+    summary_fields:
+      - task_count
+      - ddl_count
+      - migration_steps
+      - verification_steps
+      - risks
+    prompt: "确认变更清单中的 DDL、代码任务、上线步骤和验收标准可执行，并允许进入代码执行。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then continue with phase-structure"
+  CP-4:
+    name: Acceptance confirmation
+    gate_after: verify
+    producing_step: verify
+    required_outputs:
+      - ".planning/phases/{phase}/01-UAT.md"
+      - ".planning/phases/{phase}/01-VERIFICATION.md"
+    required_meta_output: ".planning/phases/{phase}/01-VERIFICATION.meta.json"
+    required_meta_fields:
+      - uat_passed
+      - uat_failed
+      - uat_skipped
+      - gate_passed
+      - gate_total
+      - known_issues
+    summary_fields:
+      - uat_passed
+      - uat_failed
+      - uat_skipped
+      - gate_passed
+      - gate_total
+      - known_issues
+    prompt: "确认 UAT、主流程、规则、兼容性和工具链验证已通过，并允许进入审计归档。"
+    confirm_options:
+      - approve
+      - needs_fix
+    skip_policy: never
+    resume_behavior: "user confirms, then continue with audit"
+
+steps:
+  - id: requirement-triage
+    order: 5
+    label: Requirement triage
+    skill: workflow-requirement-triage
+    depends_on: []
+    inputs:
+      - ".planning/PROJECT.md"
+      - ".planning/navigation/INDEX.md"
+      - ".planning/requirements/baseline.md"
+      - ".planning/features/"
+      - ".planning/milestones/"
+    outputs:
+      - path: ".planning/requirements/{feature}/入口分诊.md"
+        type: requirement-triage
+        required: true
+    meta_output:
+      path: ".planning/requirements/{feature}/入口分诊.meta.json"
+      fields:
+        feature_name: { type: string, required: true }
+        status: { type: string, required: true }
+        route: { type: string, required: true }
+        request_type: { type: string, required: true }
+        route_reason: { type: string, required: true }
+        duplicate_count: { type: integer, required: true }
+        prior_rejection_count: { type: integer, required: true }
+        blocking_question: { type: string, required: false }
+        next_skill: { type: string, required: true }
+        searched_sources: { type: array, required: true }
+        related_code_paths: { type: array, required: true }
+        related_history_paths: { type: array, required: true }
+
+  - id: requirement-wayfinder
+    order: 6
+    label: Requirement wayfinder
+    skill: workflow-wayfinder
+    depends_on:
+      - requirement-triage
+    inputs:
+      - ".planning/requirements/{feature}/入口分诊.md"
+      - ".planning/PROJECT.md"
+      - ".planning/navigation/INDEX.md"
+    outputs:
+      - path: ".planning/requirements/{feature}/决策地图.md"
+        type: requirement-wayfinder
+        required: true
+    meta_output:
+      path: ".planning/requirements/{feature}/决策地图.meta.json"
+      fields:
+        feature_name: { type: string, required: true }
+        status: { type: string, required: true }
+        destination: { type: string, required: true }
+        open_ticket_count: { type: integer, required: true }
+        resolved_ticket_count: { type: integer, required: true }
+        frontier_ticket_ids: { type: array, required: true }
+        next_ticket_id: { type: string, required: false }
+        blocking_reason: { type: string, required: false }
+        ready_for_baseline: { type: boolean, required: true }
+
+  - id: domain-modeling
+    order: 7
+    label: Domain modeling
+    skill: workflow-domain-modeling
+    depends_on:
+      - requirement-wayfinder
+    inputs:
+      - ".planning/requirements/{feature}/决策地图.md"
+      - ".planning/requirements/{feature}/wayfinder/"
+      - ".planning/CONTEXT.md"
+    outputs:
+      - path: ".planning/requirements/{feature}/领域模型记录.md"
+        type: domain-modeling
+        required: true
+    meta_output:
+      path: ".planning/requirements/{feature}/领域模型记录.meta.json"
+      fields:
+        feature_name: { type: string, required: true }
+        terms_added: { type: integer, required: true }
+        terms_changed: { type: integer, required: true }
+        term_conflict_count: { type: integer, required: true }
+        edge_case_count: { type: integer, required: true }
+        adr_count: { type: integer, required: true }
+        pending_question_count: { type: integer, required: true }
+
+  - id: requirement-feasibility-review
+    order: 8
+    label: Requirement feasibility review
+    skill: requirement-feasibility-review
+    depends_on:
+      - domain-modeling
+    inputs:
+      - ".planning/requirements/{feature}/决策地图.md"
+      - ".planning/requirements/{feature}/领域模型记录.md"
+      - ".planning/CONTEXT.md"
+    outputs:
+      - path: ".planning/requirements/{feature}/可实现性审查.md"
+        type: requirement-feasibility-review
+        required: true
+    meta_output:
+      path: ".planning/requirements/{feature}/可实现性审查.meta.json"
+      fields:
+        feature_name: { type: string, required: true }
+        status: { type: string, required: true }
+        baseline_gate: { type: string, required: true }
+        claim_count: { type: integer, required: true }
+        proven_count: { type: integer, required: true }
+        gap_count: { type: integer, required: true }
+        critical_finding_ids: { type: array, required: true }
+        next_action: { type: string, required: true }
+
+  - id: requirement-baseline
+    order: 10
+    label: Requirement baseline
+    skill: workflow-requirement-baseline
+    depends_on:
+      - requirement-feasibility-review
+    inputs:
+      - ".planning/PROJECT.md"
+      - ".planning/navigation/INDEX.md"
+    outputs:
+      - path: ".planning/requirements/baseline.md"
+        type: requirement-baseline
+        required: true
+    meta_output:
+      path: ".planning/requirements/baseline.meta.json"
+      fields:
+        review_status: { type: string, required: true }
+        fp_count: { type: integer, required: true }
+        br_count: { type: integer, required: true }
+        bc_count: { type: integer, required: true }
+        blocking_pending_count: { type: integer, required: true }
+        critical_image_missing_count: { type: integer, required: true }
+        challenge_pending_count: { type: integer, required: true }
+        code_reality_missing_count: { type: integer, required: true }
+        current_feature: { type: string, required: true }
+        depends_on_count: { type: integer, required: true }
+        pending_items: { type: array, required: false }
+        risks: { type: array, required: false }
+        key_decisions: { type: array, max: 5, required: false }
+    checkpoint: CP-1
+
+  - id: api-contract
+    order: 15
+    label: API contract
+    skill: workflow-api-contract
+    depends_on:
+      - requirement-baseline
+    inputs:
+      - ".planning/requirements/baseline.md"
+      - ".planning/navigation/INDEX.md"
+    outputs:
+      - path: ".planning/features/{feature}/api-contract.md"
+        type: api-contract
+        required: true
+    meta_output:
+      path: ".planning/features/{feature}/api-contract.meta.json"
+      fields:
+        review_status: { type: string, required: true }
+        api_required: { type: boolean, required: true }
+        endpoint_count: { type: integer, required: true }
+        pending_contract_count: { type: integer, required: true }
+        breaking_change_count: { type: integer, required: true }
+        permission_rule_count: { type: integer, required: true }
+        error_case_count: { type: integer, required: true }
+    checkpoint: CP-API
+
+  - id: ui-spec
+    order: 20
+    label: UI spec
+    skill: workflow-ui-spec
+    depends_on:
+      - api-contract
+    inputs:
+      - ".planning/requirements/baseline.md"
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/navigation/INDEX.md"
+    outputs:
+      - path: ".planning/features/{feature}/UI-SPEC.md"
+        type: ui-spec
+        required: true
+
+  - id: feature-breakdown
+    order: 30
+    label: Feature breakdown
+    skill: workflow-feature-breakdown
+    depends_on:
+      - ui-spec
+    inputs:
+      - ".planning/requirements/baseline.md"
+      - ".planning/features/{feature}/UI-SPEC.md"
+    outputs:
+      - path: ".planning/features/{feature}/功能点梳理.md"
+        type: feature-breakdown
+        required: true
+
+  - id: frontend-tech-spec
+    order: 40
+    label: Frontend tech spec
+    skill: workflow-frontend-tech-spec
+    depends_on:
+      - feature-breakdown
+      - api-contract
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/features/{feature}/功能点梳理.md"
+      - ".planning/features/{feature}/UI-SPEC.md"
+      - ".planning/navigation/INDEX.md"
+      - ".planning/execution-contract.md"
+      - ".planning/toolchain.md"
+    outputs:
+      - path: ".planning/features/{feature}/前端技术方案.md"
+        type: frontend-tech-spec
+        required: true
+    meta_output:
+      path: ".planning/features/{feature}/前端技术方案.meta.json"
+      fields:
+        route_count: { type: integer, required: true }
+        component_count: { type: integer, required: true }
+        api_count: { type: integer, required: true }
+        api_gaps_count: { type: integer, required: true }
+
+  - id: backend-tech-spec
+    order: 50
+    label: Backend tech spec
+    skill: workflow-backend-tech-spec
+    depends_on:
+      - api-contract
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/requirements/baseline.md"
+      - ".planning/navigation/INDEX.md"
+      - ".planning/execution-contract.md"
+      - ".planning/toolchain.md"
+    outputs:
+      - path: ".planning/features/{feature}/后端技术方案.md"
+        type: backend-tech-spec
+        required: true
+
+  - id: api-call-guide
+    order: 55
+    label: API call guide
+    skill: workflow-api-call-guide
+    depends_on:
+      - api-contract
+      - backend-tech-spec
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/features/{feature}/后端技术方案.md"
+    outputs:
+      - path: ".planning/features/{feature}/api-call-guide.md"
+        type: api-call-guide
+        required: true
+    meta_output:
+      path: ".planning/features/{feature}/api-call-guide.meta.json"
+      fields:
+        covered_endpoint_count: { type: integer, required: true }
+        api_required: { type: boolean, required: true }
+        frontend_consumable: { type: boolean, required: true }
+        mock_ready: { type: boolean, required: true }
+        pending_items: { type: array, required: true }
+        skip_reason: { type: string, required: false }
+
+  - id: api-supplement
+    order: 56
+    label: API supplement
+    skill: workflow-api-supplement
+    depends_on:
+      - frontend-tech-spec
+      - api-contract
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/features/{feature}/前端技术方案.md"
+      - ".planning/features/{feature}/UI-SPEC.md"
+    outputs:
+      - path: ".planning/features/{feature}/api-supplement-requests.md"
+        type: api-supplement-requests
+        required: true
+    meta_output:
+      path: ".planning/features/{feature}/api-supplement-requests.meta.json"
+      fields:
+        api_supplement_count: { type: integer, required: true }
+        unresolved_supplement_count: { type: integer, required: true }
+        contract_updated: { type: boolean, required: true }
+        no_supplement_required: { type: boolean, required: true }
+
+  - id: integration-verify
+    order: 58
+    label: Integration verify
+    skill: workflow-integration-verify
+    depends_on:
+      - api-call-guide
+      - frontend-tech-spec
+      - api-supplement
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/features/{feature}/api-call-guide.md"
+      - ".planning/features/{feature}/前端技术方案.md"
+      - ".planning/features/{feature}/后端技术方案.md"
+      - ".planning/features/{feature}/api-supplement-requests.md"
+    outputs:
+      - path: ".planning/features/{feature}/integration-report.md"
+        type: integration-report
+        required: true
+    meta_output:
+      path: ".planning/features/{feature}/integration-report.meta.json"
+      fields:
+        merge_gate_status: { type: string, required: true }
+        api_required: { type: boolean, required: true }
+        contract_backend_mismatch_count: { type: integer, required: true }
+        contract_frontend_mismatch_count: { type: integer, required: true }
+        unhandled_api_supplement_count: { type: integer, required: true }
+        blocking_issue_count: { type: integer, required: true }
+        skip_reason: { type: string, required: false }
+    checkpoint: CP-2
+
+  - id: change-plan
+    order: 60
+    label: Change plan
+    skill: workflow-change-plan
+    depends_on:
+      - integration-verify
+    inputs:
+      - ".planning/features/{feature}/api-contract.md"
+      - ".planning/features/{feature}/integration-report.md"
+      - ".planning/features/{feature}/前端技术方案.md"
+      - ".planning/features/{feature}/后端技术方案.md"
+      - ".planning/features/{feature}/功能点梳理.md"
+    outputs:
+      - path: ".planning/features/{feature}/变更清单.md"
+        type: change-plan
+        required: true
+    checkpoint: CP-3
+
+  - id: phase-structure
+    order: 70
+    label: Phase structure
+    action: initialize-phase-structure
+    depends_on:
+      - change-plan
+    inputs:
+      - ".planning/features/{feature}/变更清单.md"
+    outputs:
+      - path: ".planning/ROADMAP.md"
+        type: roadmap
+        required: true
+      - path: ".planning/phases/{phase}/01-CONTEXT.md"
+        type: phase-context
+        required: true
+
+  - id: execute
+    order: 80
+    label: Execute
+    skill: workflow-execute-phase
+    depends_on:
+      - phase-structure
+    inputs:
+      - ".planning/features/{feature}/变更清单.md"
+      - ".planning/phases/{phase}/01-CONTEXT.md"
+    outputs:
+      - path: ".planning/features/{feature}/PROGRESS.md"
+        type: progress
+        required: true
+      - path: ".planning/phases/{phase}/SUMMARY.md"
+        type: execution-summary
+        required: true
+
+  - id: code-index-refresh
+    order: 84
+    label: Code index refresh
+    skill: workflow-code-index
+    depends_on:
+      - execute
+    inputs:
+      - ".planning/features/{feature}/变更清单.md"
+      - ".planning/features/{feature}/PROGRESS.md"
+      - ".planning/phases/{phase}/SUMMARY.md"
+    outputs:
+      - path: ".planning/code-index/index.sqlite"
+        type: code-index-sqlite
+        required: true
+      - path: ".planning/code-index/files.jsonl"
+        type: code-index-files
+        required: true
+      - path: ".planning/code-index/symbols.jsonl"
+        type: code-index-symbols
+        required: true
+      - path: ".planning/code-index/relations.jsonl"
+        type: code-index-relations
+        required: true
+      - path: ".planning/code-index/AUDIT.md"
+        type: code-index-audit
+        required: true
+
+  - id: code-review
+    order: 85
+    label: Code Review
+    skill: code-review
+    depends_on:
+      - code-index-refresh
+    inputs:
+      - ".planning/features/{feature}/变更清单.md"
+      - ".planning/phases/{phase}/SUMMARY.md"
+    outputs:
+      - path: ".planning/phases/{phase}/REVIEW.md"
+        type: code-review-report
+        required: true
+
+  - id: generate-mainflow-cases
+    order: 86
+    label: Generate mainflow cases
+    skill: workflow-generate-mainflow-cases
+    depends_on:
+      - code-index-refresh
+    inputs:
+      - ".planning/STATE.md"
+      - ".planning/navigation/INDEX.md"
+      - ".context/spec/index.md"
+      - ".planning/requirements/baseline.md"
+      - ".planning/features/{feature}/功能点梳理.md"
+      - ".planning/features/{feature}/UI-SPEC.md"
+      - ".planning/features/{feature}/前端技术方案.md"
+      - ".planning/features/{feature}/后端技术方案.md"
+      - ".planning/features/{feature}/变更清单.md"
+      - ".planning/features/{feature}/PROGRESS.md"
+      - ".planning/phases/{phase}/SUMMARY.md"
+    outputs:
+      - path: ".planning/generated-cases/{feature}/source-map.md"
+        type: mainflow-source-map
+        required: true
+      - path: ".planning/generated-cases/{feature}/mainflow-analysis.md"
+        type: mainflow-analysis
+        required: true
+      - path: ".planning/generated-cases/{feature}/case-descriptions.json"
+        type: mainflow-case-descriptions
+        required: true
+      - path: ".planning/generated-cases/{feature}/case-import-payloads.json"
+        type: mainflow-case-import-payloads
+        required: true
+      - path: ".planning/generated-cases/{feature}/validation-report.md"
+        type: mainflow-case-validation
+        required: true
+      - path: ".planning/phases/{phase}/MAINFLOW-CASES.md"
+        type: mainflow-cases-summary
+        required: true
+
+  - id: verify
+    order: 90
+    label: Verify
+    skill: workflow-verify-work
+    depends_on:
+      - code-review
+      - generate-mainflow-cases
+    inputs:
+      - ".planning/features/{feature}/PROGRESS.md"
+      - ".planning/phases/{phase}/SUMMARY.md"
+      - ".planning/phases/{phase}/MAINFLOW-CASES.md"
+      - ".planning/generated-cases/{feature}/validation-report.md"
+      - ".planning/generated-cases/{feature}/case-import-payloads.json"
+    outputs:
+      - path: ".planning/phases/{phase}/01-UAT.md"
+        type: uat-report
+        required: true
+      - path: ".planning/phases/{phase}/01-VERIFICATION.md"
+        type: verification-report
+        required: true
+    meta_output:
+      path: ".planning/phases/{phase}/01-VERIFICATION.meta.json"
+      fields:
+        uat_passed: { type: integer, required: true }
+        uat_failed: { type: integer, required: true }
+        uat_skipped: { type: integer, required: true }
+        gate_passed: { type: integer, required: true }
+        gate_total: { type: integer, required: true }
+        known_issues: { type: array, required: true }
+    checkpoint: CP-4
+
+  - id: audit
+    order: 100
+    label: Audit
+    skill: workflow-audit-milestone
+    depends_on:
+      - verify
+    inputs:
+      - ".planning/phases/{phase}/01-UAT.md"
+      - ".planning/phases/{phase}/01-VERIFICATION.md"
+      - ".planning/features/{feature}/PROGRESS.md"
+    outputs:
+      - path: ".planning/milestone-audit.md"
+        type: milestone-audit
+        required: true
+
+  - id: update-navigation
+    order: 110
+    label: Update navigation
+    skill: workflow-update-navigation
+    depends_on:
+      - audit
+    inputs:
+      - "."
+    outputs:
+      - path: ".planning/navigation/INDEX.md"
+        type: navigation-index
+        required: true
+
+  - id: archive
+    order: 120
+    label: Archive
+    skill: workflow-complete-milestone
+    depends_on:
+      - update-navigation
+    inputs:
+      - ".planning/milestone-audit.md"
+      - ".planning/navigation/INDEX.md"
+    outputs:
+      - path: ".planning/milestones/current-MILESTONE.md"
+        type: milestone-archive
+        required: true
+
+resume_rules:
+  continue_keyword:
+    writes_next_intent: true
+    next_intent_path: ".planning/.next-intent"
+    clear_context_required: true
+  waiting_checkpoint:
+    allowed_next_action: "ask user for confirmation before advancing"