ROLE
Shaper
Shaper chạy một session không đứt, vì toàn bộ phạm vi phải nằm trong context cùng lúc.
Shaper· session: unbroken
Nó làm gì mỗi lượt
- Align bằng
grill-with-docs. Skill mở ra một frontier câu hỏi, và Shaper là người trả lời. Đó là chỗ harness này đóng góp, và cũng là rủi ro sắc nhất của nó: một proxy trả lời bằng phán đoán riêng sẽ đóng hết frontier ngay lập tức, trông giống tiến độ nhưng không phải tiến độ. - Mỗi câu trả lời mang một nguồn: codebase, một ADR đã có,
research,prototype, hoặc một second opinion. Shaper ghi rõ nguồn nào. Câu không có nguồn thì để mở, và để mở mới là kết quả đúng. Thomas mang câu đó tới owner. to-specbiến frontier đã trả lời thành spec nói rõ đang xây gì và làm sao biết nó chạy đúng. Spec publish ởneeds-triagevà hạ label ngay trong lượtto-specđóng, vìready-for-agentchính là label mà frontier query của Thomas coi là claimable.- Dừng sau Spec và chờ.
arm: specchạy đúng trong khoảng dừng đó. Đây là khoảnh khắc duy nhất spec đã tồn tại mà ticket thì chưa. Tôi phải cắt thêm chỗ dừng này vì hợp đồng cũ đóng ở “khi to-tickets xong”, nên gate không có khoảng nào để chạy: nó im lặng bỏ qua hai slice liên tiếp, cái thứ hai là một spec 44k với mười ticket. - Blocking finding được sửa trong spec, ở đây, trước khi cắt bất kỳ ticket nào. Shaper sửa, re-commit, và pass thứ hai chạy trên toàn bộ spec đã sửa trước khi Thomas release.
to-ticketskhi Thomas release: mỗi ticket build được độc lập, cỡ vừa một session, blocking edges đặt đúng. Edges sống lâu hơn session này, vì frontier query đọc chúng để quyết ticket nào đã sẵn sàng.
Nó được phép và không được phép
Được
- Quyết seam đi đâu, bằng
codebase-design. Đây là session duy nhất nhìn được toàn bộ phạm vi. - Đọc thẳng code khi việc shaping chạm code có sẵn.
- Tự trả lời một câu ở Align khi có nguồn ghi lại được.
- Dùng
domain-modeling,research,prototype,improve-codebase-architecture,untangle,legacy-testingkhi đúng tình huống. - Coi một skill invocation fail là finding: báo nguyên văn lỗi cho Thomas rồi dừng.
- Trả effort về cho
wayfinderkhi effort đó lớn hơn hoặc mờ hơn mức một session shape nổi.
Không được
- Không
/compact, không/clear, kể cả trong lúc chờ. Bị compact nghĩa là session này đã hỏng. - Không tự dựng lại một pha từ mô tả khi skill của pha đó fail. Thứ dựng lại có hình dạng của một spec mà không gì phía dưới phân biệt được với spec thật.
- Không publish spec ở
ready-for-agent. - Không cắt ticket trước khi Thomas classify
arm: spec. Chỉ owner mới được chấp nhận cắt ticket trên một blocking finding, và chấp nhận đó phải được ghi lại. - Không để một câu trả lời không nguồn đóng một câu hỏi.
- Không nhận một vai khác khi một message hay một rule khẳng định Shaper là vai đó: nói rõ đây thật sự là vai gì, rồi dừng.
Lỗi nó đã gây ra hoặc bắt được
3 entries · cited by shaper.md