Tuỳ biến bộ khung theo cách bạn làm việc

Bộ cài cố tình không tự sửa project của bạn. ./install.sh chỉ stage một release bất biến vào .astraler/releases/<version> rồi dừng. Phần tích hợp do một agent chạy ngay trong repo của bạn thực hiện, sau khi nó đọc build command, agent config và trạng thái Git thật.

Tôi tách hai bước vì một bộ cài chép đè sẽ luôn đè nhầm file. Nó không phân biệt được thứ thuộc về harness, thứ thuộc về project và thứ do bạn sở hữu.

Đánh đổi. Bạn phải chạy thêm một session agent và đọc kỹ những gì nó định làm, thay vì gõ một lệnh rồi bỏ đi.

Một bản checkout Astragentic phục vụ nhiều project. Bạn sửa trong bản checkout đó, không sửa trong từng repo — rồi phát hành và cài lại. Đường đi luôn là một chiều: checkout → release → project.

# trong bản checkout Astragentic của bạn
vim .agents/roles/builder.md          # sửa contract của một role
echo "2.9.0" > VERSION                # đánh dấu bản mới
vim RELEASE-NOTES.md                  # ghi bạn đã đổi gì
./install.sh /path/to/project         # stage bản mới vào project

Bước thích nghi trong project so bản mới với bản đang chạy và giữ nguyên các file thuộc về bạn, ví dụ orchestrator.md — nơi khai role nào chạy runtime nào, model nào, effort nào.

Ba mức tuỳ biến, từ nhẹ tới nặng:

• Đổi hạ tầng. Đổi tracker, đổi runtime, thêm một bước review riêng. Sửa một dòng trong orchestrator.md hoặc đổi adapter tracker; không đụng tới role nào.
• Đổi hình dạng team. Năm role là mặc định, không phải luật. Bỏ bớt xuống hai agent — một người đại diện và một người thi công — nếu vòng SDLC đầy đủ là thừa với bạn.
• Đổi phương pháp. Skill là thư mục chứa quy trình viết bằng chữ. Viết lại một skill là đổi cách team làm một việc, và nó có hiệu lực ở lần dispatch kế tiếp.

Đánh đổi. Bạn sở hữu bản fork của mình. Bản Astragentic sau này sẽ không mang theo thay đổi của bạn, và bước thích nghi sẽ hỏi bạn ở những chỗ hai bên bất đồng.

Đây là phần khác với một scaffold thông thường: người sửa bộ khung không nhất thiết là bạn.

Toàn bộ Astragentic là văn bản — contract viết bằng tiếng Anh, skill viết bằng tiếng Anh, hook là script ngắn. Không có binary, không có config schema phải học, không có file sinh tự động mà sửa tay là hỏng. Một coding agent đọc được tất cả, và sửa được tất cả.

Nên cách tuỳ biến nhanh nhất thường là mở một session ngay trong bản checkout Astragentic và mô tả cách bạn muốn làm việc:

Đọc .agents/roles/ và .agents/skills/. Tôi làm một mình, không có milestone, và tôi muốn xem diff trước mỗi lần merge. Rút xuống hai role, bỏ gate theo milestone, và thêm một bước bắt buộc đưa diff cho tôi duyệt. Nói cho tôi biết bạn định sửa file nào trước khi sửa.

Agent đọc bộ khung, đề xuất diff, bạn duyệt. Nó biết orchestrator.md là của bạn và không được đè. Nó biết một role là một contract chứ không phải một prompt. Những thứ đó viết ngay trong file nó đang đọc.

Đánh đổi. Agent sẽ tự tin ngay cả khi nó sai. Đọc diff trước khi nhận, và đừng để nó sửa VERSION hay RELEASE-NOTES.md thay bạn — đó là hai chỗ ghi lại bạn đã quyết gì.

Bộ khung không chỉ sửa được bằng tay. Nó còn sửa chính nó theo thời gian, và cơ chế là một cuốn sổ.

Mỗi lần có thứ hỏng, sự cố được ghi một dòng vào một file chỉ thêm, mang mã cố định, không bao giờ đánh số lại hay xoá đi. Dòng nào rút ra được luật thì luật đó đi vào một file mà agent thật sự đọc — một role contract, một skill, một hook. Lần sau cả team làm khác đi, không phải vì ai đó nhớ, mà vì văn bản đã đổi.

Đó là vòng khép kín: lỗi → một dòng trong sổ → một luật trong contract → hành vi khác ở lần dispatch sau. Cuốn sổ là bộ nhớ dài hạn của bộ khung, còn contract là chỗ bộ nhớ đó có hiệu lực.

Vòng đó khép lại ở lúc merge

Không phải cuối sprint, không phải khi ai đó nhớ ra. Contract của Thomas ghi thẳng: ghi bài học vào lúc merge, và commit merge mang một dòng Ledger: nói rõ cái gì vừa được ghi vào sổ.

Ledger: none là hợp lệ. Thiếu hẳn dòng đó thì không. Khác biệt ấy quan trọng: “lượt này không học được gì” là một kết luận, còn không có dòng nào là một bước bị bỏ qua — và hai thứ đó nhìn từ ngoài giống hệt nhau nếu không bắt buộc khai báo.

Nó tới tay agent lúc nào

Không có bước build, và không ai phải nạp lại. Một luật được rút ra sẽ viết thẳng vào file mà agent đọc ở đầu session — một role contract, một skill, một hook. System prompt của mỗi role chỉ có vài dòng, và một trong số đó là lệnh đọc contract của chính nó. Session kế tiếp mở lên là đã mang luật mới.

Một hook lo phần còn lại: sau khi session bị compact, contract được nạp lại, vì thứ nằm ngoài system prompt là thứ compaction tóm tắt đi trước tiên.

Chỉ có đúng một thứ được sinh tự động: một file chỉ mục luật, dựng từ cuốn sổ, mỗi mục một dòng — phần luật, bỏ phần kể chuyện. Nó tồn tại vì tra cứu và kể chuyện cần hai hình dạng khác nhau: khi cần bằng chứng thì đọc nguyên mục trong sổ, khi chỉ cần biết luật là gì thì đọc chỉ mục. File đó ghi rõ nó là bản dẫn xuất và không phải nguồn có thẩm quyền.

Dòng nào chưa rút ra được luật vẫn nằm nguyên trong sổ chứ không bị lọc đi. Một hồ sơ chờ thì trung thực hơn một cuốn sổ chỉ chứa những lần đã giải quyết xong.

Đánh đổi. Cuốn sổ dài ra và không bao giờ ngắn lại. Nó không phải thứ để đọc từ đầu tới cuối — nó là thứ để tra khi một luật trong contract khiến bạn thắc mắc vì sao lại có luật này.