developing-agent-forge 1.0.0 → 2.0.1

package/README.md

@@ -10,17 +10,18 @@ The usual entry point is [`develop.sh`](develop.sh), which calls `npm run develo
 
 - the goal file passed with `--goal-path`
 - `skills/coding-style/SKILL.md`
-- the artifact directory containing `TODO.md`
+- the project progress memory directory passed with `--project-progress-memory-path`
+- the code design memory directory passed with `--code-design-memory-path`
 - the target codebase directory
 - the development archive directory, passed through the current CLI option name `--achive-dir`
 
-The pipeline works in the configured `--target-path`, reads the current high-level objective from `--goal-path`, maintains `TODO.md` under the configured `--artifact-path`, and archives per-iteration task/review artifacts under the configured archive directory.
+The pipeline works in the configured `--target-path`, reads the current high-level objective from `--goal-path`, recalls and updates project progress memory under `--project-progress-memory-path`, recalls and updates code design memory under `--code-design-memory-path`, and archives per-iteration task/review artifacts under the configured archive directory.
 
 The package exposes a TypeScript API from [`src/index.ts`](src/index.ts) and a CLI from [`src/cli.ts`](src/cli.ts).
 
 ## Core Idea: Developing And Coding Style
 
-`src` turns the current goal into a repeatable code-writing trajectory. `coding-manager` reads the current repository, the goal, and `TODO.md`, chooses one concrete developer task, `developer` edits the target repository, and `code-reviewer` either returns `ACCEPT` or sends revision feedback back into the same task.
+`src` turns the current goal into a repeatable code-writing trajectory. `coding-manager` reads the current repository, the goal, and remembered context, chooses one concrete developing task, `developer` edits the target repository, and `code-reviewer` either returns `ACCEPT` or sends task feedback back into the same task.
 
 The coding-style skill is [`skills/coding-style/SKILL.md`](skills/coding-style/SKILL.md). Its job is to control the code-writing agent's code structure and style. The upstream user task decides what to implement; this skill decides how to keep the implementation readable, local, low-coupling, and consistent with the current framework.
 
@@ -63,15 +64,13 @@ npm run build
 
 For local CLI development, use `npm run dev -- developing ...` or the prepared `npm run developing` and `npm run developing-skill` script aliases.
 
-## Goal File And Temporary TODO Context
+## Goal File And Memory Context
 
-`developing` and `developing-skill` now both accept `--goal-path <path>`. The pipeline reads that file once at the start of the run and passes its contents to `coding-manager`, `developer`, `code-reviewer`, and `trajectory-optimizer` as the current high-level objective.
+`developing` and `developing-skill` both accept `--goal-path <path>`. The pipeline reads that file once at the start of the run and passes its contents to `coding-manager`, `developer`, `code-reviewer`, and `trajectory-optimizer` as the current high-level objective.
 
 Each time you want to execute the next new task, update the file passed to `--goal-path` before rerunning [`develop.sh`](develop.sh) or [`develop-skill.sh`](develop-skill.sh). Put any stable project contract, task context paths, constraints, or task focus directly in that goal file.
 
-`TODO.md` under the configured `--artifact-path` is the current temporary task-memory file maintained by `coding-manager`. If the existing TODO content starts to mix old and new task context, you can manually delete the current TODO file, for example `output/developing/TODO.md`, before the next run. The pipeline will recreate an empty TODO file automatically.
-
-This `TODO.md` workflow is a temporary memory mechanism. A more advanced memory mechanism should replace or extend it later, so treat the current file as a practical bridge for task continuity rather than the final long-term memory design.
+The configured `--project-progress-memory-path` stores project progress memory used by `coding-manager` for task selection and project continuity. The configured `--code-design-memory-path` stores code design memory used by `developer` while completing the selected task. If old context is no longer useful, delete or edit the memory files under the relevant directory before rerunning the pipeline.
 
 ## Direct Command
 
@@ -83,48 +82,52 @@ npm run developing -- \
   --config "secret.yaml" \
   --target-path "output/codebase" \
   --achive-dir "output/developing-archives" \
-  --artifact-path "output/developing" \
+  --project-progress-memory-path "output/developing/project-progress-memory" \
+  --code-design-memory-path "output/developing/code-design-memory" \
   --coding-style-skill-path "skills/coding-style" \
   --goal-path "output/goal.md" \
   --max-iterations "100" \
-  --max-revision-iterations "10"
+  --max-task-devloop-iterations "10" \
+  --max-memory-rounds "3"
 ```
 
 The current CLI option name is `--achive-dir`.
 
 ## Options Reference
 
-| Option                      | Description                                                           |
-| --------------------------- | --------------------------------------------------------------------- |
-| `--config`                  | One or more YAML config files loaded with `coding-agent-forge`.       |
-| `--target-path`             | Target codebase directory.                                            |
-| `--achive-dir`              | Development archive directory.                                        |
-| `--artifact-path`           | Artifact directory containing `TODO.md`.                              |
-| `--coding-style-skill-path` | Configured coding-style skill.                                        |
-| `--goal-path`               | Markdown file containing the current objective and task context.      |
-| `--max-iterations`          | Stops the outer loop if `coding-manager` has not returned `FINISHED`. |
-| `--max-revision-iterations` | Limits the inner developer/reviewer repair loop.                      |
+| Option                           | Description                                                           |
+| -------------------------------- | --------------------------------------------------------------------- |
+| `--config`                       | One or more YAML config files loaded with `coding-agent-forge`.       |
+| `--target-path`                  | Target codebase directory.                                            |
+| `--achive-dir`                   | Project development archive directory.                                |
+| `--project-progress-memory-path` | Memory directory used for project progress continuity.                |
+| `--code-design-memory-path`      | Memory directory used for code design continuity.                     |
+| `--coding-style-skill-path`      | Configured coding-style skill.                                        |
+| `--goal-path`                    | Markdown file containing the current objective and task context.      |
+| `--max-iterations`               | Stops the outer loop if `coding-manager` has not returned `FINISHED`. |
+| `--max-task-devloop-iterations` | Limits developer/reviewer attempts for each selected task.            |
+| `--max-memory-rounds`            | Limits memory recall and remember refinement rounds.                  |
 
 ## Main Flow
 
-[`pipeline/pipeline.ts`](src/pipeline/pipeline.ts) parses CLI options and delegates the development loop to [`pipeline/development.ts`](src/pipeline/development.ts).
+[`pipeline/pipeline.ts`](src/pipeline/pipeline.ts) parses CLI options and delegates the project development workflow to [`pipeline/project-devloop.ts`](src/pipeline/project-devloop.ts).
 
 Each iteration does the following:
 
-1. `coding-manager` scans the current repository, the goal from `--goal-path`, and `TODO.md` in the artifact directory, then chooses one developer task.
+1. `coding-manager` decides what should be recalled, the pipeline recalls the matching memory, then `coding-manager` scans the current repository, the goal from `--goal-path`, and remembered context before choosing one developing task.
 2. `developer` loads the configured coding-style skill, edits the repository, and reports what changed for review.
-3. `code-reviewer` reads the code and developer report, then returns exactly `ACCEPT` or revision feedback.
+3. `code-reviewer` reads the code and developer report, then returns exactly `ACCEPT` or task feedback.
 4. If the reviewer returns feedback, `developer` fixes the same task and `code-reviewer` reviews again.
-5. After the review loop ends, the pipeline archives the task and reports, then asks `coding-manager` to update the TODO file.
+5. After the review loop ends, the pipeline archives the task and reports, asks `coding-manager` to output what should be remembered, and stores that content through `memory-agent-forge`.
 6. The pipeline stops when `coding-manager` returns `FINISHED` or `--max-iterations` is reached.
 
 ## Developing-Skill And Trajectory Feedback
 
-[`develop-skill.sh`](develop-skill.sh) calls the related `developing-skill` pipeline in [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts). It runs the same development loop, adds `--metaskill-path`, and invokes `trajectory-optimizer` before the revision loop and after TODO updates so the coding-style skill can be improved from concrete development feedback.
+[`develop-skill.sh`](develop-skill.sh) calls the related `developing-skill` pipeline in [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts). It runs the same project development workflow, adds `--metaskill-path`, and invokes `trajectory-optimizer` before and after the developer/reviewer loop so the coding-style skill can be improved from concrete development feedback.
 
 The first `trajectory-optimizer` call runs in `scan` mode before the developer starts. It reads the target repository, the current coding-style skill, and the goal context so the optimizer has the same project context as the code-writing loop.
 
-The second `trajectory-optimizer` call runs in `optimize` mode after the TODO update report is produced. It reads the metaskill, target repository, goal context, current task, revision report, and TODO update report; evaluates whether the skill produced a good modification trajectory; then edits the coding-style skill directly. The prompt focuses the optimizer on missing, misleading, or redundant guidance that affected task selection, coding, review, or TODO update.
+The second `trajectory-optimizer` call runs in `optimize` mode after the iteration finishes. It reads the metaskill, target repository, goal context, current task, and the Developer reports and Reviewer feedback; evaluates whether the skill produced a good modification trajectory; then edits the coding-style skill directly. The prompt focuses the optimizer on missing, misleading, or redundant guidance that affected task selection, coding, or review.
 
 The intended loop is:
 
@@ -139,31 +142,31 @@ This is the coding-style version of skill self-improvement: the metaskill states
 
 The pipeline maintains:
 
-| Artifact                    | Where it lives                                                                                                      |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| `TODO.md`                   | Under the configured artifact directory; the temporary coding-manager-maintained task-memory file.                  |
-| Timestamped archive folders | Under the configured archive directory; contains each selected task, per-revision reports, and TODO update reports. |
+| Artifact                    | Where it lives                                                                                                                                                              |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Memory files                | Under the configured project progress and code design memory directories; maintained by `memory-agent-forge`.                                                               |
+| Timestamped archive folders | Under the configured archive directory; contains each selected task, memory recall guidance, recalled memory, Developer reports, Reviewer feedback, and things to remember. |
 
 ## Important Files
 
 | Path                                                                   | Purpose                                                                                      |
 | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
 | [`pipeline/pipeline.ts`](src/pipeline/pipeline.ts)                     | CLI argument parsing and the base `developing` pipeline wrapper.                             |
-| [`pipeline/development.ts`](src/pipeline/development.ts)               | Outer development loop, archive creation, TODO updates, and per-agent handoff.               |
-| [`pipeline/revision.ts`](src/pipeline/revision.ts)                     | Inner developer/reviewer revision loop for one selected task.                                |
+| [`pipeline/project-devloop.ts`](src/pipeline/project-devloop.ts)       | Outer project workflow, archive creation, memory recall/update, and per-agent handoff.       |
+| [`pipeline/task-devloop.ts`](src/pipeline/task-devloop.ts)             | Inner developer/reviewer loop for one selected task.                                         |
 | [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts)           | `developing-skill` wrapper that adds trajectory optimization callbacks around the base loop. |
 | [`agents/factory.ts`](src/agents/factory.ts)                           | Registers the developing coding manager, developer, and reviewer agents.                     |
 | [`agents/types.ts`](src/agents/types.ts)                               | Shared workspace-aware base class and variables.                                             |
-| [`agents/manager.ts`](src/agents/manager.ts)                           | Maintains the TODO file and selects outer-loop tasks.                                        |
+| [`agents/manager.ts`](src/agents/manager.ts)                           | Decides what to recall, selects outer-loop tasks, and outputs what should be remembered.     |
 | [`agents/developer.ts`](src/agents/developer.ts)                       | Edits the target repository using the shared coding-style skill.                             |
 | [`agents/reviewer.ts`](src/agents/reviewer.ts)                         | Performs the read-only code review gate.                                                     |
 | [`agents/trajectory-optimizer.ts`](src/agents/trajectory-optimizer.ts) | Scans the trajectory and proposes coding-style skill improvements for `developing-skill`.    |
 
 ## Troubleshooting
 
-| Problem                                  | Likely cause                                                       | Fix                                                                                               |
-| ---------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
-| The loop stops with `FINISHED`           | `coding-manager` decided no further developer task is needed.      | Inspect `TODO.md` in the artifact directory and the latest archive.                               |
-| A task keeps returning revision feedback | The inner developer/reviewer repair loop has not reached `ACCEPT`. | Read the per-revision reports in the timestamped archive folder.                                  |
-| A new goal keeps inheriting old context  | The temporary `TODO.md` still contains old task state.             | Update `--goal-path`; if needed, delete `output/developing/TODO.md` before rerunning the wrapper. |
-| The archive option looks misspelled      | The current CLI option name is `--achive-dir`.                     | Use the current option name until the CLI changes.                                                |
+| Problem                                 | Likely cause                                                   | Fix                                                                                              |
+| --------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| The loop stops with `FINISHED`          | `coding-manager` decided no further developing task is needed. | Inspect the memory directory and the latest archive.                                             |
+| A task keeps returning task feedback    | The inner developer/reviewer loop has not reached `ACCEPT`.    | Read the Developer reports and Reviewer feedback in the timestamped archive folder.              |
+| A new goal keeps inheriting old context | One of the memory directories still contains old task state.   | Update `--goal-path`; if needed, edit or delete stale memory files before rerunning the wrapper. |
+| The archive option looks misspelled     | The current CLI option name is `--achive-dir`.                 | Use the current option name until the CLI changes.                                               |

package/README.zh-CN.md

@@ -10,17 +10,18 @@
 
 - 通过 `--goal-path` 传入的目标文件
 - `skills/coding-style/SKILL.md`
-- 包含 `TODO.md` 的 artifact 目录
+- 通过 `--project-progress-memory-path` 传入的项目进度 memory 目录
+- 通过 `--code-design-memory-path` 传入的代码设计 memory 目录
 - 目标代码库目录
 - development archive 目录；当前 CLI 参数名仍是 `--achive-dir`
 
-pipeline 会在配置的 `--target-path` 中继续写代码，从 `--goal-path` 读取当前高层任务目标，维护配置的 `--artifact-path` 下的 `TODO.md`，并把每轮 task/review 产物归档到 archive 目录。
+pipeline 会在配置的 `--target-path` 中继续写代码，从 `--goal-path` 读取当前高层任务目标，召回并更新 `--project-progress-memory-path` 下的项目进度记忆，召回并更新 `--code-design-memory-path` 下的代码设计记忆，并把每轮 task/review 产物归档到 archive 目录。
 
 TypeScript API 从 [`src/index.ts`](src/index.ts) 导出，CLI 入口在 [`src/cli.ts`](src/cli.ts)。
 
 ## 核心思想：Developing 和 Coding Style
 
-`src` 会把当前 goal 变成一条可重复执行的代码编写 trajectory。`coding-manager` 读取当前 repo、goal 和 `TODO.md`，选择一个具体 developer task；`developer` 修改目标 repo；`code-reviewer` 返回严格的 `ACCEPT`，或者把 revision feedback 送回同一个 task。
+`src` 会把当前 goal 变成一条可重复执行的代码编写 trajectory。`coding-manager` 读取当前 repo、goal 和记下来的上下文，选择一个具体 developing task；`developer` 修改目标 repo；`code-reviewer` 返回严格的 `ACCEPT`，或者把 task feedback 送回同一个 task。
 
 coding-style skill 是 [`skills/coding-style/SKILL.md`](skills/coding-style/SKILL.md)。它的功能是控制写代码 agent 的代码结构和代码风格。上游用户任务决定要实现什么；这个 skill 决定如何让实现保持 readable、local、low-coupling，并和当前 framework 保持一致。
 
@@ -63,15 +64,13 @@ npm run build
 
 本地调试 CLI 时，可以使用 `npm run dev -- developing ...`，也可以继续使用预设的 `npm run developing` 和 `npm run developing-skill` 脚本别名。
 
-## Goal 文件和临时 TODO 上下文
+## Goal 文件和 Memory 上下文
 
-`developing` 和 `developing-skill` 现在都接受 `--goal-path <path>`。pipeline 会在运行开始时读取这个文件，并把其中内容作为当前 high-level objective 传给 `coding-manager`、`developer`、`code-reviewer` 和 `trajectory-optimizer`。
+`developing` 和 `developing-skill` 都接受 `--goal-path <path>`。pipeline 会在运行开始时读取这个文件，并把其中内容作为当前 high-level objective 传给 `coding-manager`、`developer`、`code-reviewer` 和 `trajectory-optimizer`。
 
 每次想执行下一个新任务时，先更新 `--goal-path` 指向的文件，再重新运行 [`develop.sh`](develop.sh) 或 [`develop-skill.sh`](develop-skill.sh)。稳定的项目 contract、任务上下文路径、约束和这一次的任务重点都直接写进这个 goal 文件。
 
-配置的 `--artifact-path` 下的 `TODO.md` 是当前由 `coding-manager` 维护的临时任务记忆文件。如果现有 TODO 内容开始把旧任务和新任务上下文串味，可以在下一次运行前手动删除当前 TODO 文件，例如 `output/developing/TODO.md`。pipeline 会自动重新创建一个空 TODO 文件。
-
-这个 `TODO.md` workflow 是临时记忆机制。之后会实现更高级的记忆机制来替代或扩展它，所以现在可以把这个文件理解成用于保持任务连续性的过渡方案，而不是最终的长期记忆设计。
+配置的 `--project-progress-memory-path` 存放给 `coding-manager` 做任务选择和项目连续性判断的项目进度记忆。配置的 `--code-design-memory-path` 存放给 `developer` 完成当前任务时使用的代码设计记忆。如果旧上下文不再有用，可以在下一次运行前删除或编辑对应目录下的 memory 文件。
 
 ## 直接命令
 
@@ -83,48 +82,52 @@ npm run developing -- \
   --config "secret.yaml" \
   --target-path "output/codebase" \
   --achive-dir "output/developing-archives" \
-  --artifact-path "output/developing" \
+  --project-progress-memory-path "output/developing/project-progress-memory" \
+  --code-design-memory-path "output/developing/code-design-memory" \
   --coding-style-skill-path "skills/coding-style" \
   --goal-path "output/goal.md" \
   --max-iterations "100" \
-  --max-revision-iterations "10"
+  --max-task-devloop-iterations "10" \
+  --max-memory-rounds "3"
 ```
 
 当前 CLI 参数名是 `--achive-dir`。
 
 ## 参数参考
 
-| 参数                        | 说明                                                             |
-| --------------------------- | ---------------------------------------------------------------- |
-| `--config`                  | 用 `coding-agent-forge` 加载的一个或多个 YAML config 文件。      |
-| `--target-path`             | 目标代码库目录。                                                 |
-| `--achive-dir`              | Development archive 目录。                                       |
-| `--artifact-path`           | 包含 `TODO.md` 的 artifact 目录。                                |
-| `--coding-style-skill-path` | 配置的 coding-style skill。                                      |
-| `--goal-path`               | 包含当前 high-level objective 和 task context 的 Markdown 文件。 |
-| `--max-iterations`          | 当 `coding-manager` 尚未返回 `FINISHED` 时限制外层循环。         |
-| `--max-revision-iterations` | 限制内层 developer/reviewer 修复循环。                           |
+| 参数                             | 说明                                                             |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `--config`                       | 用 `coding-agent-forge` 加载的一个或多个 YAML config 文件。      |
+| `--target-path`                  | 目标代码库目录。                                                 |
+| `--achive-dir`                   | Project development archive 目录。                               |
+| `--project-progress-memory-path` | 用于保持项目进度连续性的 memory 目录。                           |
+| `--code-design-memory-path`      | 用于保持代码设计连续性的 memory 目录。                           |
+| `--coding-style-skill-path`      | 配置的 coding-style skill。                                      |
+| `--goal-path`                    | 包含当前 high-level objective 和 task context 的 Markdown 文件。 |
+| `--max-iterations`               | 当 `coding-manager` 尚未返回 `FINISHED` 时限制外层循环。         |
+| `--max-task-devloop-iterations` | 限制每个 selected task 的 developer/reviewer 尝试次数。          |
+| `--max-memory-rounds`            | 限制 memory recall 和 remember 的 refinement 轮数。              |
 
 ## 主流程
 
-[`pipeline/pipeline.ts`](src/pipeline/pipeline.ts) 负责解析 CLI 参数，并把开发循环交给 [`pipeline/development.ts`](src/pipeline/development.ts)。
+[`pipeline/pipeline.ts`](src/pipeline/pipeline.ts) 负责解析 CLI 参数，并把 project development workflow 交给 [`pipeline/project-devloop.ts`](src/pipeline/project-devloop.ts)。
 
 每轮迭代执行以下步骤：
 
-1. `coding-manager` 扫描当前 repo、`--goal-path` 中的 goal，以及 artifact 目录中的 `TODO.md`，然后选择一个 developer task。
+1. `coding-manager` 先判断需要回忆什么，pipeline 再召回匹配的记忆，然后 `coding-manager` 扫描当前 repo、`--goal-path` 中的 goal 和记下来的上下文，选择一个 developing task。
 2. `developer` 加载配置的 coding-style skill，修改 repo，并报告自己改了哪些内容给 reviewer。
-3. `code-reviewer` 阅读代码和 developer report，返回严格的 `ACCEPT` 或 revision feedback。
+3. `code-reviewer` 阅读代码和 developer report，返回严格的 `ACCEPT` 或 task feedback。
 4. 如果 reviewer 返回 feedback，`developer` 继续修同一个任务，然后 `code-reviewer` 再审。
-5. review 循环结束后，pipeline 归档 task 和 reports，然后让 `coding-manager` 更新 TODO 文件。
+5. review 循环结束后，pipeline 归档 task 和 reports，让 `coding-manager` 输出有什么需要记下，并通过 `memory-agent-forge` 写入记忆。
 6. 当 `coding-manager` 返回 `FINISHED` 或达到 `--max-iterations` 时停止。
 
 ## developing-skill 和 Trajectory Feedback
 
-[`develop-skill.sh`](develop-skill.sh) 会调用 [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts) 中的 `developing-skill` pipeline。它复用同一套开发循环，额外传入 `--metaskill-path`，并在 revision loop 前和 TODO 更新后调用 `trajectory-optimizer`，让 coding-style skill 能根据具体开发反馈继续优化。
+[`develop-skill.sh`](develop-skill.sh) 会调用 [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts) 中的 `developing-skill` pipeline。它复用同一套 project development workflow，额外传入 `--metaskill-path`，并在 developer/reviewer 循环前后调用 `trajectory-optimizer`，让 coding-style skill 能根据具体开发反馈继续优化。
 
 第一次 `trajectory-optimizer` 调用发生在 developer 开始前，使用 `scan` 模式。它会读取目标 repo、当前 coding-style skill 和 goal context，让 optimizer 拿到和代码编写循环相同的项目上下文。
 
-第二次 `trajectory-optimizer` 调用发生在 TODO update report 生成后，使用 `optimize` 模式。它会读取 metaskill、target repo、goal context、current task、revision report 和 TODO update report；根据 [`metaskills/coding-style/METASKILL.md`](metaskills/coding-style/METASKILL.md) 中写的偏好评估这次修改 trajectory 的质量；然后直接修改 coding-style skill。这个 prompt 会重点检查哪些 guidance 缺失、误导或冗余，并看这些问题是否影响 task selection、coding、review 或 TODO update。
+第二次 `trajectory-optimizer` 调用发生在迭代结束后，使用 `optimize` 模式。它会读取 metaskill、target repo、goal context、current task、Developer reports 和 Reviewer feedback；根据 [`metaskills/coding-style/METASKILL.md`](metaskills/coding-style/METASKILL.md) 中写的偏好评估这次修改 trajectory 的质量；然后直接修改 coding-style skill。这个 prompt 会重点检查哪些 guidance 缺失、误导或冗余，并看这些问题是否影响 task selection、coding 或 review。
 
 推荐的使用循环是：
 
@@ -139,31 +142,31 @@ npm run developing -- \
 
 pipeline 会维护：
 
-| Artifact             | 位置                                                                                         |
-| -------------------- | -------------------------------------------------------------------------------------------- |
-| `TODO.md`            | 配置的 artifact 目录下，由 coding-manager 维护的临时任务记忆文件。                           |
-| 按时间戳归档的文件夹 | 配置的 archive 目录下，保存 selected task、每次 revision 的 reports 和 TODO update reports。 |
+| Artifact             | 位置                                                                                                                                             |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Memory files         | 配置的 project progress 和 code design memory 目录下，由 `memory-agent-forge` 维护。                                                             |
+| 按时间戳归档的文件夹 | 配置的 archive 目录下，保存 selected task、memory recall guidance、recalled memory、Developer reports、Reviewer feedback 和 things to remember。 |
 
 ## 重要文件
 
 | 路径                                                                   | 作用                                                                              |
 | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
 | [`pipeline/pipeline.ts`](src/pipeline/pipeline.ts)                     | CLI 参数解析和基础 `developing` pipeline 包装。                                   |
-| [`pipeline/development.ts`](src/pipeline/development.ts)               | 外层开发循环、archive 创建、TODO 更新和各 agent 之间的交接。                      |
-| [`pipeline/revision.ts`](src/pipeline/revision.ts)                     | 针对一个 selected task 的内层 developer/reviewer revision loop。                  |
+| [`pipeline/project-devloop.ts`](src/pipeline/project-devloop.ts)       | 外层 project workflow、archive 创建、memory recall/update 和各 agent 之间的交接。 |
+| [`pipeline/task-devloop.ts`](src/pipeline/task-devloop.ts)             | 针对一个 selected task 的内层 developer/reviewer 循环。                           |
 | [`pipeline/pipelineskill.ts`](src/pipeline/pipelineskill.ts)           | 给基础开发循环增加 trajectory optimization callbacks 的 `developing-skill` 包装。 |
 | [`agents/factory.ts`](src/agents/factory.ts)                           | 注册 developing coding manager、developer 和 reviewer agents。                    |
 | [`agents/types.ts`](src/agents/types.ts)                               | 共享的 workspace-aware base class 和变量定义。                                    |
-| [`agents/manager.ts`](src/agents/manager.ts)                           | 维护 TODO 文件并选择外层任务。                                                    |
+| [`agents/manager.ts`](src/agents/manager.ts)                           | 判断需要回忆什么、选择外层任务，并输出有什么需要记下。                            |
 | [`agents/developer.ts`](src/agents/developer.ts)                       | 使用共享 coding-style skill 修改目标 repo。                                       |
 | [`agents/reviewer.ts`](src/agents/reviewer.ts)                         | 执行只读代码审阅 gate。                                                           |
 | [`agents/trajectory-optimizer.ts`](src/agents/trajectory-optimizer.ts) | 扫描开发轨迹，并为 `developing-skill` 提出 coding-style skill 优化建议。          |
 
 ## 常见问题
 
-| 问题                               | 常见原因                                             | 解决办法                                                                           |
-| ---------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| Loop 以 `FINISHED` 停止            | `coding-manager` 判断不需要继续选择 developer task。 | 检查 artifact 目录中的 `TODO.md` 和最新 archive。                                  |
-| 某个任务持续返回 revision feedback | 内层 developer/reviewer 修复循环尚未达到 `ACCEPT`。  | 阅读按时间戳归档的 per-revision reports。                                          |
-| 新 goal 仍然继承旧上下文           | 临时 `TODO.md` 里还保留旧任务状态。                  | 更新 `--goal-path`；必要时先删除 `output/developing/TODO.md`，再重新运行 wrapper。 |
-| Archive 参数看起来拼错             | 当前 CLI 参数名就是 `--achive-dir`。                 | 在 CLI 改名前继续使用当前参数名。                                                  |
+| 问题                           | 常见原因                                              | 解决办法                                                                   |
+| ------------------------------ | ----------------------------------------------------- | -------------------------------------------------------------------------- |
+| Loop 以 `FINISHED` 停止        | `coding-manager` 判断不需要继续选择 developing task。 | 检查 memory 目录和最新 archive。                                           |
+| 某个任务持续返回 task feedback | 内层 developer/reviewer 循环尚未达到 `ACCEPT`。       | 阅读按时间戳归档的 Developer reports 和 Reviewer feedback。                |
+| 新 goal 仍然继承旧上下文       | 某个 memory 目录里还保留旧任务状态。                  | 更新 `--goal-path`；必要时编辑或删除过时 memory 文件，再重新运行 wrapper。 |
+| Archive 参数看起来拼错         | 当前 CLI 参数名就是 `--achive-dir`。                  | 在 CLI 改名前继续使用当前参数名。                                          |

package/developing-forge.yaml

@@ -1,61 +1,76 @@
-# Sample configuration for developing-agent-forge.
-#
-# Keep these paths consistent:
-#   - the CLI's --target-path
-#   - each developing agent's constants.workspacePath
-#   - the developer/reviewer threads' workingDirectory
-#
-# Put provider credentials in secret.yaml (git-ignored) and pass it after this
-# file: --config developing-forge.yaml --config secret.yaml
-
 runtimes:
   codex:
     kind: codex
 
 threads:
-  coding-manager-runner:
+  skill:
     runtime: codex
     options:
       model: gpt-5.5
       sandboxMode: danger-full-access
-      workingDirectory: &targetWorkspace output/codebase
+      workingDirectory: .
 
-  developer-runner:
+  develop:
     runtime: codex
     options:
-      model: gpt-5.3-codex-spark
+      model: gpt-5.5
       sandboxMode: danger-full-access
-      workingDirectory: *targetWorkspace
+      workingDirectory: &developerWorkspacePath output/codebase
 
-  code-reviewer-runner:
+  develop-cheap:
     runtime: codex
     options:
-      model: gpt-5.5
-      sandboxMode: danger-full-access # read-only review agent
-      workingDirectory: *targetWorkspace
+      model: gpt-5.3-codex-spark
+      sandboxMode: danger-full-access
+      workingDirectory: *developerWorkspacePath
 
-  trajectory-optimizer-runner:
+  memory:
     runtime: codex
     options:
       model: gpt-5.5
       sandboxMode: danger-full-access
-      workingDirectory: .
+      workingDirectory: &memoryWorkingDir output/developing
 
 agents:
   coding-manager:
-    thread: coding-manager-runner
+    thread: develop
     constants:
-      workspacePath: *targetWorkspace
+      workspacePath: *developerWorkspacePath
 
   developer:
-    thread: developer-runner
+    thread: develop-cheap
     constants:
-      workspacePath: *targetWorkspace
+      workspacePath: *developerWorkspacePath
 
   code-reviewer:
-    thread: code-reviewer-runner
+    thread: develop
     constants:
-      workspacePath: *targetWorkspace
+      workspacePath: *developerWorkspacePath
 
   trajectory-optimizer:
-    thread: trajectory-optimizer-runner
+    thread: skill
+
+  memory-reader:
+    thread: memory
+    constants:
+      workingDir: *memoryWorkingDir
+
+  memory-modify-planner:
+    thread: memory
+    constants:
+      workingDir: *memoryWorkingDir
+
+  memory-modifier:
+    thread: memory
+    constants:
+      workingDir: *memoryWorkingDir
+
+  memory-create-planner:
+    thread: memory
+    constants:
+      workingDir: *memoryWorkingDir
+
+  memory-creator:
+    thread: memory
+    constants:
+      workingDir: *memoryWorkingDir

package/dist/agents/developer.d.ts

@@ -1,9 +1,23 @@
 import { DevelopingAgent, type DevelopingAgentVariables } from "./types.js";
-export type DeveloperVariables = DevelopingAgentVariables & {
+type RecallDeveloperVariables = DevelopingAgentVariables & {
     currentTask: string;
+    phase: "recall";
+};
+type DevelopDeveloperVariables = DevelopingAgentVariables & {
+    currentTask: string;
+    memory: string;
+    phase: "develop";
     reviewerReport?: string;
 };
+type UpdateDeveloperVariables = DevelopingAgentVariables & {
+    currentTask: string;
+    memory: string;
+    phase: "update";
+    taskDevReport: string;
+};
+export type DeveloperVariables = RecallDeveloperVariables | DevelopDeveloperVariables | UpdateDeveloperVariables;
 export declare class DeveloperAgent extends DevelopingAgent<DeveloperVariables> {
     protected buildPrompt(variables: Readonly<DeveloperVariables>): string;
 }
+export {};
 //# sourceMappingURL=developer.d.ts.map

package/dist/agents/developer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"developer.d.ts","sourceRoot":"","sources":["../../src/agents/developer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GAAG;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,qBAAa,cAAe,SAAQ,eAAe,CAAC,kBAAkB,CAAC;IACrE,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM;CAyBvE"}
+{"version":3,"file":"developer.d.ts","sourceRoot":"","sources":["../../src/agents/developer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,wBAAwB,GAAG,wBAAwB,GAAG;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,KAAK,yBAAyB,GAAG,wBAAwB,GAAG;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,wBAAwB,GAAG,wBAAwB,GAAG;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,qBAAa,cAAe,SAAQ,eAAe,CAAC,kBAAkB,CAAC;IACrE,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM;CAgEvE"}

package/dist/agents/developer.js

@@ -4,17 +4,54 @@ export class DeveloperAgent extends DevelopingAgent {
     buildPrompt(variables) {
         const codingStyleSkillPath = this.workspaceRelativePath(variables.codingStyleSkillPath);
         const targetPath = this.workspaceRelativePath(variables.targetPath);
-        const reviewerReport = variables.reviewerReport ?? "(none)";
         const codingStyleSkillInstructionText = codingStyleSkillInstruction(codingStyleSkillPath);
         const goalInstructionText = goalInstruction(variables.goal);
-        return `
+        if (variables.phase === "recall") {
+            return `
 ${codingStyleSkillInstructionText}
 
-Work in the target repository at ${targetPath}/.
+${goalInstructionText}
+
+Current task:
+${variables.currentTask}
+
+Scan the target repository at ${targetPath}/ and decide what code design memory helps complete the current task.
+
+Output concise code design memory recall guidance.
+`;
+        }
+        if (variables.phase === "update") {
+            return `
+${codingStyleSkillInstructionText}
 
 ${goalInstructionText}
 
-Current developer task:
+Current task:
+${variables.currentTask}
+
+Related code design memory before the current task:
+${variables.memory}
+
+Revision process for completing the current task:
+${variables.taskDevReport}
+
+Scan the target repository at ${targetPath}/ and consider what code logic relationships and design reasons should be remembered after the current task.
+
+Remember code logic relationships and why the current design matches the repository.
+`;
+        }
+        const reviewerReport = variables.reviewerReport ?? "(none)";
+        return `
+${codingStyleSkillInstructionText}
+
+${goalInstructionText}
+
+Related code design memory:
+${variables.memory}
+
+Work in the target repository at ${targetPath}/.
+
+Current task:
 ${variables.currentTask}
 
 Reviewer report:

package/dist/agents/developer.js.map

@@ -1 +1 @@
-{"version":3,"file":"developer.js","sourceRoot":"","sources":["../../src/agents/developer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAiC,MAAM,YAAY,CAAC;AAO5E,MAAM,OAAO,cAAe,SAAQ,eAAmC;IAC3D,WAAW,CAAC,SAAuC;QAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxF,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,IAAI,QAAQ,CAAC;QAC5D,MAAM,+BAA+B,GAAG,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;QAC1F,MAAM,mBAAmB,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE5D,OAAO;EACT,+BAA+B;;mCAEE,UAAU;;EAE3C,mBAAmB;;;EAGnB,SAAS,CAAC,WAAW;;;EAGrB,cAAc;;;;;CAKf,CAAC;IACA,CAAC;CACF"}
+{"version":3,"file":"developer.js","sourceRoot":"","sources":["../../src/agents/developer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAiC,MAAM,YAAY,CAAC;AA0B5E,MAAM,OAAO,cAAe,SAAQ,eAAmC;IAC3D,WAAW,CAAC,SAAuC;QAC3D,MAAM,oBAAoB,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxF,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,+BAA+B,GAAG,2BAA2B,CAAC,oBAAoB,CAAC,CAAC;QAC1F,MAAM,mBAAmB,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAE5D,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO;EACX,+BAA+B;;EAE/B,mBAAmB;;;EAGnB,SAAS,CAAC,WAAW;;gCAES,UAAU;;;CAGzC,CAAC;QACE,CAAC;QAED,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO;EACX,+BAA+B;;EAE/B,mBAAmB;;;EAGnB,SAAS,CAAC,WAAW;;;EAGrB,SAAS,CAAC,MAAM;;;EAGhB,SAAS,CAAC,aAAa;;gCAEO,UAAU;;;CAGzC,CAAC;QACE,CAAC;QAED,MAAM,cAAc,GAAG,SAAS,CAAC,cAAc,IAAI,QAAQ,CAAC;QAC5D,OAAO;EACT,+BAA+B;;EAE/B,mBAAmB;;;EAGnB,SAAS,CAAC,MAAM;;mCAEiB,UAAU;;;EAG3C,SAAS,CAAC,WAAW;;;EAGrB,cAAc;;;;;CAKf,CAAC;IACA,CAAC;CACF"}

package/dist/agents/manager.d.ts

@@ -1,17 +1,20 @@
 import { DevelopingAgent, type DevelopingAgentVariables } from "./types.js";
+type RecallCodingManagerVariables = DevelopingAgentVariables & {
+    phase: "recall";
+};
 type SelectCodingManagerVariables = DevelopingAgentVariables & {
-    todoPath: string;
+    memory: string;
     finishMark: string;
     phase: "select";
 };
 type UpdateCodingManagerVariables = DevelopingAgentVariables & {
-    todoPath: string;
+    memory: string;
     finishMark: string;
     phase: "update";
     currentTask: string;
-    revisionReport: string;
+    taskDevReport: string;
 };
-export type CodingManagerVariables = SelectCodingManagerVariables | UpdateCodingManagerVariables;
+export type CodingManagerVariables = RecallCodingManagerVariables | SelectCodingManagerVariables | UpdateCodingManagerVariables;
 export declare class CodingManagerAgent extends DevelopingAgent<CodingManagerVariables> {
     protected buildPrompt(variables: Readonly<CodingManagerVariables>): string;
 }

package/dist/agents/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/agents/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,4BAA4B,GAAG,wBAAwB,GAAG;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,KAAK,4BAA4B,GAAG,wBAAwB,GAAG;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,GAAG,4BAA4B,CAAC;AAEjG,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IAC7E,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,MAAM;CA0C3E"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/agents/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE5E,KAAK,4BAA4B,GAAG,wBAAwB,GAAG;IAC7D,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,KAAK,4BAA4B,GAAG,wBAAwB,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,KAAK,4BAA4B,GAAG,wBAAwB,GAAG;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IAC7E,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,MAAM;CAwD3E"}