Skip to main content

Plan Writing Guide (Cross-end Technical Plan: Decomposition + Acceptance)

Goal and Positioning​

  • Plan carries Draft forward, decomposes business requirements into technical work, and outputs a technical acceptance checklist and execution order that can enter Code directly.
  • Tasks are generally split by frontend and backend, with the default order of backend business implementation -> frontend page implementation -> frontend-backend integration, subject to adjustment by dependency.
  • The aim is to reduce intermediate review and accelerate entry into Review, without writing business code at this stage.

Usage Scenarios​

  • Use it as a System Prompt in a conversation to drive convergence from a technical perspective: clarify the requirement -> define technical points -> produce a TDD acceptance checklist and execution order.
  • Use Chinese throughout the conversation by default. Technical terms and comments may use English. Focus on verifiable output and dependency orchestration.

Thinking Boundaries and Default Constraints (Role of the System Prompt)​

  • Stage boundary: do not implement code. Only perform technical analysis, contract sketches, acceptance planning, and execution ordering.
  • Granularity boundary: describe interface semantics, field semantics, component responsibilities, and states rather than code-level details.
  • Output boundary: produce a Plan document following the template, including:
    • overall goal decomposition based on requirements (new work only)
    • business requirement -> technical point -> technical acceptance checklist (TDD assertions)
    • technical detail analysis, including research summaries and decisions based on the latest material
    • execution order and dependencies, with the default order of backend -> frontend -> integration
  • Research constraint: collect information from the internet and record the source domain and key points instead of copying original text or large passages.

Information Collection Dimensions (Fill in Gradually During the Conversation)​

  • Business-to-technical mapping for new work: semantics of objects and actions, data constraints, error semantics, and boundaries
  • Frontend additions: pages / modules, key states such as Loading / Empty / Error, interaction rules, and accessibility considerations
  • Backend additions: routes / methods, request / response semantics, error code range, data consistency, and permission constraints
  • Technical research topics: new dependencies, solution comparison, best practices, with source domains, key points, selection rationale, risks, and fallback strategy
  • Quality gates: type safety, style, test layers, and contract synchronization strategy

Target Outputs (Expected When the Conversation Converges)​

  • New-goal decomposition: cross-end decomposition and the suggested default order of backend -> frontend -> integration, adjustable by dependency
  • Business requirements -> technical points -> technical acceptance checklist, where TDD assertions can be converted directly into tests
  • Technical detail analysis and research conclusions: source domains, key points, decisions, impact scope, risks, and rollback plans
  • Execution order and dependencies: slice sequence, milestones, integration points, and regression points

Writing Points​

  • Drive technical decomposition from business semantics, rather than falling into implementation detail too early.
  • Use assertions in the acceptance checklist and cover positive, negative, boundary, and empty states so both frontend and backend remain verifiable.
  • Clarify dependencies, merge / regression checkpoints, and rollback strategy to shorten the feedback loop.
  • Technical solutions should be backed by up-to-date reference material to avoid obsolete approaches or reinventing the wheel.

Output and Filing​

  • Once the conversation converges, output a complete Plan document using the Plan Template.

Definition of Done (DoD)​

  • Three elements are complete: goal decomposition; requirement -> technical point -> technical acceptance checklist; technical details and research conclusions.
  • Execution order is clear: backend -> frontend -> integration by default, with special dependency adjustments explicitly marked.
  • The acceptance checklist can be converted directly into tests; boundaries and exception paths are clear; a rollback plan exists.

Mapping to the Template​

  • The output of this guide must cover the following sections in the Plan Template:
    1. Summary (goal summary / scope statement / out-of-scope)
    2. Overall goal decomposition based on requirements (new work only)
    3. Business requirement -> technical point -> technical acceptance checklist (TDD)
    4. Contract and type synchronization plan (new / changed only)
    5. Technical detail analysis (research and decisions)
    6. Execution order and dependencies (backend -> frontend -> integration by default)
    7. Risks, rollback, and impact scope
    8. Milestones and checkpoints
    9. File and deliverable list (plan)