✨ feat(playbook): version durable scratch workflow state
This commit is contained in:
@@ -25,6 +25,7 @@ playbook/
|
||||
templates/
|
||||
├── AGENTS.template.md # 项目主入口与导航模板
|
||||
├── AGENT_RULES.template.md # Matt Pocock ticket-native 执行规则模板
|
||||
├── gitignore.template # .scratch 持久状态与本机运行时忽略规则
|
||||
├── memory-bank/ # 稳定项目知识模板(3 个),不是机器状态源
|
||||
├── cpp/ # C++ 工具链模板
|
||||
└── python/ # Python 工具链模板
|
||||
@@ -47,6 +48,7 @@ templates/
|
||||
- `AGENT_RULES.md`:`<!-- playbook:rules:start/end -->` 区块内的工程流程由 Playbook
|
||||
维护,重新同步时刷新;项目自己的补充写在区块外,同步不会动它
|
||||
- `AGENT_RULES.local.md`:项目私有规则,Playbook 不覆盖
|
||||
- `.gitignore`:Playbook 维护专属标记区块,仅忽略 `.scratch` 下的本机运行时产物
|
||||
- `memory-bank/`:稳定项目定位、技术上下文和当前系统模式,不承载机器状态
|
||||
|
||||
Playbook 只处理框架提供的同名文件。项目新增的 `memory-bank/*` 不会被删除。
|
||||
@@ -119,12 +121,14 @@ setup-matt-pocock-skills
|
||||
-> to-spec
|
||||
-> to-tickets
|
||||
-> main_loop.py enqueue
|
||||
-> 提交 planning baseline(spec + tickets + queue)
|
||||
-> main_loop.py claim
|
||||
-> 本地 ticket 执行协议(tdd)
|
||||
-> commit
|
||||
-> code-review
|
||||
-> main_loop.py finish
|
||||
-> main_loop.py integrate
|
||||
-> 提交 final workflow state
|
||||
```
|
||||
|
||||
产物和职责:
|
||||
@@ -136,6 +140,12 @@ setup-matt-pocock-skills
|
||||
- `docs/adr/`:长期架构决策
|
||||
- `docs/agents/*.md`:tracker 与领域文档配置
|
||||
|
||||
本批次 feature 全部 `enqueue` 后,先把对应 spec、tickets 和 queue 提交为一个 planning
|
||||
baseline,再开始任何 `claim`。生成和入队步骤本身不隐式提交。
|
||||
|
||||
feature 集成成功后,再在主干提交该 feature 的最终 `.scratch` 持久状态。此提交位于 feature
|
||||
merge commit 之后,并与其他活动 feature 的未提交状态隔离。
|
||||
|
||||
明确串行时可用 in-place,不创建 worktree;计划多个 session 并发时,第一个 claim
|
||||
就指定 worktree。并发 sessions 必须共享同一文件系统与 Git common directory;
|
||||
`main_loop.py` 不支持跨机器、独立 clone 或远程 tracker adapter。Matt skills 可单独
|
||||
@@ -175,6 +185,7 @@ project/
|
||||
├── AGENTS.md # 任一 sync_* 节启用时创建或按区块更新
|
||||
├── AGENT_RULES.md # [sync_rules]
|
||||
├── AGENT_RULES.local.md # 首次成功写入规则时创建,后续由项目维护
|
||||
├── .gitignore # [sync_rules] 更新 Playbook .scratch 标记区块
|
||||
├── CLAUDE.md # 默认位置;也可使用 .claude/CLAUDE.md
|
||||
├── .agents/ # [sync_standards]
|
||||
├── .gitattributes # [sync_standards] 按配置同步
|
||||
|
||||
Reference in New Issue
Block a user