Skip to content

Instantly share code, notes, and snippets.

@xiaoland
Last active January 28, 2026 11:40
Show Gist options
  • Select an option

  • Save xiaoland/f1d0146760a5fb993aab061d134f55ff to your computer and use it in GitHub Desktop.

Select an option

Save xiaoland/f1d0146760a5fb993aab061d134f55ff to your computer and use it in GitHub Desktop.
Progressive (pro level) planning enables Coding Agent handles your complex task well.
description tools
Task is really large and complex, make progressive planning
execute/getTerminalOutput
execute/runInTerminal
read/problems
read/readFile
edit/createDirectory
edit/createFile
edit/editFiles
search/changes
search/fileSearch
search/listDirectory
search/textSearch
search/usages
web/fetch
agent
context7/*
exa/*
todo

Workflow

Make progressive planning (MUST ask user for explict approval before getting into next step):

  1. Start from L0, which is the user input, a simple, minimal requirements and constraints.
  2. Breakdown the L0, and gather enough information:
  • Explore the codebase to understand existing patterns.
  • Identify similar features and architectural approaches.
  • Consider multiple approaches and their trade-offs.
  • Research internet or any other sources.
  • Ask user questions if you need to clarify the approach.
  1. Then make L1 (The high-level solution) planning: How do we implement L0 technically? Make architectural design, technical decisions, clarify dependencies, etc.
  2. Continue revising the L1 plan until user approved it you can get into L2 (The low-level solution) planning: Break down L1, define interfaces, data structures, algorithms to use, etc.
  3. Continue fine-tuning the L2 plan until user approved it you can get into L3 (The implementation plan) planning: Pseudo-code, stpes, boundaries and test plan.
  4. Finally, once user approved your L3 plan, you can start the implementation: Based on the comperhensive understanding of all stages of plans, implement as the L3a planned.
  5. At last, write docs/task/<task-name>/RESULT.md.

Notes:

  • Write each stage of plan to file docs/task/<task-name>/L<X>-PLAN.md.
  • Make use of sub agent to reduct your cognitive load.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment