Add system architecture guides (documents pin bump) #261

Merged
weichen merged 16 commits from feature/architecture-guides into main 2026-10-08 09:41:33 +00:00
Owner

Why

任务卡 .task/feature-architecture-guides.md(随本分支合入并折叠归档)。
为系统新增现状架构导览:五篇文档落 Documents 仓 docs/guides/
(结构与架构 / 意图识别 / 任务规划与执行 / 小队与子 Agent 启动 / 小队工作机制),
本 PR 推进 documents gitlink 使组合生效。

Evidence

  • 组合验证 make test 全绿(governance/boundaries/pins + core/backend/frontend/ui
    全部套件,exit 0),完整输出由 CMD="make test" make evidence 写入任务卡收据
    (SRC=SELF;PR HEAD CI 为权威)
  • 文档验收:git diff --check 通过、互链可解析、引用行号在 R0 逐一核验
  • 任务期间 origin/main 前进(#259/#260):已并入 main 并按 pin 纪律将文档提交
    rebase 到 documents main 9505c7e 之上(双向 is-ancestor 核验,无内容丢失)

Impact

  • Documents PR:weichen/Agent-System-Documents#48(先合)
  • documents gitlink d630a04 → 4ce8155(纯文档;内容含 #259 的 RDM 记录)

Refs

  • Documents PR #48;本 PR 合入后任务卡随折叠归档闭合
## Why 任务卡 `.task/feature-architecture-guides.md`(随本分支合入并折叠归档)。 为系统新增现状架构导览:五篇文档落 Documents 仓 `docs/guides/` (结构与架构 / 意图识别 / 任务规划与执行 / 小队与子 Agent 启动 / 小队工作机制), 本 PR 推进 documents gitlink 使组合生效。 ## Evidence - 组合验证 `make test` 全绿(governance/boundaries/pins + core/backend/frontend/ui 全部套件,exit 0),完整输出由 `CMD="make test" make evidence` 写入任务卡收据 (SRC=SELF;PR HEAD CI 为权威) - 文档验收:`git diff --check` 通过、互链可解析、引用行号在 R0 逐一核验 - 任务期间 origin/main 前进(#259/#260):已并入 main 并按 pin 纪律将文档提交 rebase 到 documents main `9505c7e` 之上(双向 is-ancestor 核验,无内容丢失) ## Impact - Documents PR:weichen/Agent-System-Documents#48(先合) - documents gitlink d630a04 → 4ce8155(纯文档;内容含 #259 的 RDM 记录) ## Refs - Documents PR #48;本 PR 合入后任务卡随折叠归档闭合
weichen added 14 commits 2026-10-08 09:36:20 +00:00
Why: establish the authorized task workspace and its initial baseline.

Evidence: preserved precheck receipt in .task/feature-architecture-guides.md; R0=218fc4b1ba00b0a03b5bb79f292b3eba6c987a58.

Impact: task metadata only; the feature workspace starts at 218fc4b1ba.

Refs: .task/feature-architecture-guides.md
Why: 五篇架构导览落在 Documents 仓 docs/guides/(提交 c872e61),
Dev 组合指针随之推进,使文档随固定组合一起分发。

Evidence: Documents feature/architecture-guides c872e61 基于
documents origin/main d630a04(旧 pin 的祖先已核验);纯文档变更,
Documents 仓 git diff --check 通过。SRC=SELF。

Impact: documents gitlink 前进一个提交(纯文档);待 Documents 仓
推送建 PR 后本指针才可合入。

Refs: Documents PR 待建;本分支 feature/architecture-guides。
Why: bind the task validation checkpoint to the latest integration baseline.

Evidence: SELF recursive component checks; sync_base=218fc4b1ba00b0a03b5bb79f292b3eba6c987a58; candidate=1f20f08fe0f3efb29268faca3326b5e1f92c5bad.

Impact: task metadata only.

Refs: .task/feature-architecture-guides.md
Why: bind the task validation checkpoint to the latest integration baseline.

Evidence: SELF recursive component checks; sync_base=218fc4b1ba00b0a03b5bb79f292b3eba6c987a58; candidate=ab60b0443f8025e39ff76060e05cb8b8278b80eb.

Impact: task metadata only.

Refs: .task/feature-architecture-guides.md
Why: guides 增补实例章节(Documents c872e61 之后的增量提交),
Dev 组合指针随之推进。

Evidence: Documents feature/architecture-guides 新提交基于
d630a04 线性推进;纯文档变更。SRC=SELF。

Impact: documents gitlink 前进一个提交(纯文档)。

Refs: 同 feature/architecture-guides 任务。
Why: 任务期间 origin/main 前进(#259 记录 RDM 评审并将 documents pin
提到 9505c7e);task-sync 并入 main 时与本分支 pin 修改在 gitlink 冲突。
按 pin 纪律先验证祖先关系(旧 pin d630a04 是 documents main 祖先),
将文档提交 rebase 到 9505c7e 之上(新 head 4ce8155 包含双方全部内容),
以 rebase 后 head 解决冲突,无内容丢失。

Evidence: git -C modules/documents merge-base --is-ancestor 双向通过;
rebase 无冲突;SRC=SELF。

Impact: documents gitlink 从 73ec4c8 改为 4ce8155(内容超集)。

Refs: feature/architecture-guides 任务。
Why: bind the task validation checkpoint to the latest integration baseline.

Evidence: SELF recursive component checks; sync_base=f2d39354b4ff37ca1eed1931f625019537baa6ed; candidate=6167c1012e9eb220d363809361c534e8a8fff6fd.

Impact: task metadata only.

Refs: .task/feature-architecture-guides.md
Record make test evidence at rebased pin
ci / test (pull_request) Successful in 2m20s
efd71b9055
weichen added 2 commits 2026-10-08 09:37:15 +00:00
Close 1 merged task card(s) and archive them
ci / test (pull_request) Successful in 2m19s
b7be4c99ee
Why: branches merged into main had left their task cards open; backfill status and archive to prevent bookkeeping debt.
Evidence: feature-architecture-guides.md(already-complete) — merges verified via git log --merges against origin/main.
Impact: .task/*.md moved to .task/archive/ with status backfilled; no code or submodule change.
Refs: task.sh close (card-autoclose-r1)
weichen merged commit 34a2bbe157 into main 2026-10-08 09:41:33 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: weichen/Agent-System-Dev#261