Skip to content

chore: split agent rules and specs into legacy and app - #174

Merged
1morr merged 4 commits into
mainfrom
chore/split-agent-instructions
Sep 28, 2026
Merged

1morr merged 4 commits into
mainfrom
chore/split-agent-instructions

Conversation

@1morr

@1morr 1morr commented Sep 28, 2026

Copy link
Copy Markdown
Owner

內容

M1 PR 1:指令檔與 spec 分家(擁有者決定 1,.trellis/tasks/09-28-m1-skeleton-tracer/design.md §1)。app/ 還沒有程式碼時先分,免得新專案的工作從舊規則開始。

  • 根目錄 AGENTS.md:只留共用部分,包括 repo 地圖、ADR 規則、issue 慣例、Trellis 段。舊規則原封搬到 lib/AGENTS.md。
  • 舊 spec:搬到 .trellis/spec/legacy/,guides/ 仍共用。config.yaml 宣告 legacy、app 兩個 package,並設 session.spec_scope: active_task。
  • Trellis 兩個本機 agent 檔:依任務的 package 讀對應的 AGENTS.md 與 spec。
  • skill:verify-on-device 改名 verify-legacy-on-device,只給舊專案緊急修正用。這個名字留給 app/ 版(PR 11)。
  • ADR 更正:0015 的 issue 編號、0021 的 window_manager 維護狀態、0027 的 skill 改名,各加一句補充,決定本身不變。

Review 指南

  • lib/AGENTS.md 的三段和舊根目錄逐字相同,只改了兩處路徑:git show main:AGENTS.md 對照。
  • spec 搬家都是 rename。另外有兩處內容改動:
    • legacy spec 裡的「AGENTS.md § …」改指 lib/AGENTS.md;
    • guides/ 裡的路徑補上 legacy/。
  • 注意:不要建 .trellis/spec/<package>/index.md。session-start.py 會把它當扁平層,不看 scope 一律注入。
  • 沒有程式碼變動,也沒有使用者看得到的改動,不需要實機驗證。

驗證

  • flutter test --exclude-tags live test/support test/workflows:100 個測試全過。
  • 舊路徑搜尋歸零,任務 archive 與 docs/audit/ 除外;101 個 markdown 檔的相對連結全部可解析。
  • 模擬 SessionStart:
    • app 任務只列 guides;
    • legacy 任務列 guides 加上五個 legacy 層;
    • 沒有 active task 時回到 app。

The root AGENTS.md and flat specs load for every session, so work in
app/ would start from old-app rules. Old rules move to lib/AGENTS.md and
.trellis/spec/legacy/; spec_scope keeps a task to its package's spec.
@1morr
1morr merged commit 1857fa4 into main Sep 28, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant