Skip to content

Commit c3dbbe7

Browse files
committed
docs: update README files to clarify appendix preferences structure and add examples
feat: modify default paper profile to initialize appendix preferences as empty test: add tests for resolving paper profile defaults and handling single-column layout
1 parent e1fa209 commit c3dbbe7

13 files changed

Lines changed: 57 additions & 13 deletions

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Notes:
193193
The brief is not just a startup note. It is the governed contract for a run.
194194

195195
`/new` creates or opens `Brief.md`. `/brief start --latest` validates it, snapshots it into the run, and starts execution from that snapshot. The run records the brief source path, the snapshot path, and any parsed manuscript format so the provenance of the run remains inspectable even if the workspace brief changes later.
196+
`Appendix Preferences` can now be structured with `Prefer appendix for:` and `Keep in main body:` so appendix-routing intent is explicit in the brief contract.
196197

197198
That makes the brief part of the audit trail, not just part of the prompt.
198199

docs/README.de.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Hinweise:
193193
Der Brief ist nicht nur ein Startdokument. Er ist der governed contract für einen Run.
194194

195195
`/new` erstellt oder öffnet `Brief.md`. `/brief start --latest` validiert den Brief, snapshotet ihn in den Run und startet die Ausführung auf Basis dieses Snapshots. Der Run speichert den source path des Briefs, den snapshot path und ein eventuell geparstes manuscript format. So bleibt die Provenance des Runs inspectable, auch wenn sich der Workspace-Brief später ändert.
196+
`Appendix Preferences` kann jetzt mit `Prefer appendix for:` und `Keep in main body:` strukturiert werden, damit die Appendix-Routing-Absicht im brief contract explizit bleibt.
196197

197198
Mit anderen Worten: Der Brief ist nicht nur Teil des Prompts. Er ist Teil des Audit Trails.
198199

docs/README.es.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Notas:
193193
El brief no es solo un documento de arranque. Es el governed contract de la corrida.
194194

195195
`/new` crea o abre `Brief.md`. `/brief start --latest` lo valida, lo snapshot dentro del run y arranca la ejecución a partir de ese snapshot. El run registra el source path del brief, el snapshot path y cualquier manuscript format parseado. Así, la provenance del run sigue siendo inspectable incluso si el brief del workspace cambia después.
196+
`Appendix Preferences` ahora puede escribirse con la estructura `Prefer appendix for:` y `Keep in main body:` para que la intención de appendix routing quede explícita dentro del brief contract.
196197

197198
Es decir, el brief no es solo parte del prompt. Es parte del audit trail.
198199

docs/README.fr.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Notes :
193193
Le brief n’est pas seulement un document de départ. C’est le governed contract du run.
194194

195195
`/new` crée ou ouvre `Brief.md`. `/brief start --latest` le valide, le snapshot dans le run, puis lance l’exécution à partir de ce snapshot. Le run enregistre le source path du brief, le snapshot path, ainsi que tout manuscript format analysé. Ainsi, la provenance du run reste inspectable même si le brief du workspace change ensuite.
196+
`Appendix Preferences` peut désormais être structuré avec `Prefer appendix for:` et `Keep in main body:` afin que l’intention de routage vers l’appendice soit explicite dans le brief contract.
196197

197198
En d’autres termes, le brief n’est pas seulement une partie du prompt. Il fait partie de l’audit trail.
198199

docs/README.ja.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ autolabos web # Web UI
193193
Brief は単なる開始文書ではありません。run の governed contract です。
194194

195195
`/new``Brief.md` を作成または開きます。`/brief start --latest` はそれを検証し、run に snapshot したうえで、その snapshot を基準に execution を開始します。run には brief source path、snapshot path、そして解析された manuscript format があればそれも記録されます。workspace の brief が後から変わっても、その run の provenance は inspectable のまま残ります。
196+
`Appendix Preferences``Prefer appendix for:``Keep in main body:` の構造で書けるため、appendix routing の意図を brief 契約の中でより明示的にできます。
196197

197198
つまり brief は prompt の一部ではなく、audit trail の一部です。
198199

docs/README.ko.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ autolabos web # Web UI
193193
Brief는 단순한 시작 문서가 아닙니다. 한 run의 governed contract입니다.
194194

195195
`/new``Brief.md`를 만들거나 엽니다. `/brief start --latest`는 이를 검증하고, run 안에 snapshot한 뒤, 그 snapshot을 기준으로 실행을 시작합니다. run은 brief source path, snapshot path, 그리고 파싱된 manuscript format이 있으면 그것까지 함께 기록합니다. 그래서 workspace의 brief가 나중에 바뀌더라도, 해당 run의 provenance는 계속 inspectable합니다.
196+
`Appendix Preferences`는 이제 `Prefer appendix for:``Keep in main body:` 구조를 쓸 수 있어서, appendix routing 의도가 brief 계약 안에서 더 명시적으로 표현됩니다.
196197

197198
즉, brief는 prompt 일부가 아니라 audit trail의 일부입니다.
198199

docs/README.pt.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ Notas:
193193
O brief não é apenas um documento inicial. Ele é o governed contract do run.
194194

195195
`/new` cria ou abre `Brief.md`. `/brief start --latest` valida o brief, cria um snapshot dele dentro do run e inicia a execução a partir desse snapshot. O run registra o source path do brief, o snapshot path e qualquer manuscript format parseado. Assim, a provenance do run permanece inspectable mesmo que o brief do workspace mude depois.
196+
`Appendix Preferences` agora pode ser estruturado com `Prefer appendix for:` e `Keep in main body:` para deixar explícita no brief contract a intenção de appendix routing.
196197

197198
Em outras palavras, o brief não é apenas parte do prompt. Ele é parte do audit trail.
198199

docs/README.ru.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ autolabos web # Web UI
193193
Brief — это не просто стартовый документ. Это governed contract для run.
194194

195195
`/new` создаёт или открывает `Brief.md`. `/brief start --latest` валидирует его, сохраняет snapshot внутри run и запускает выполнение на основе этого snapshot. Run записывает source path brief, snapshot path и любой распознанный manuscript format. Благодаря этому provenance run остаётся inspectable даже если brief в workspace позже изменится.
196+
`Appendix Preferences` теперь можно задавать в структуре `Prefer appendix for:` и `Keep in main body:`, чтобы намерение appendix routing было явно зафиксировано в brief contract.
196197

197198
Иными словами, brief — это не просто часть prompt. Это часть audit trail.
198199

docs/README.zh-CN.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ autolabos web # Web UI
193193
Brief 不只是启动文档。它是 run 的 governed contract。
194194

195195
`/new` 会创建或打开 `Brief.md``/brief start --latest` 会校验它,将其 snapshot 到 run 中,再基于这个 snapshot 开始执行。run 会记录 brief source path、snapshot path,以及解析出的 manuscript format(如果有)。即使 workspace 的 brief 后续发生变化,该 run 的 provenance 仍然可检查。
196+
`Appendix Preferences` 现在可以写成 `Prefer appendix for:``Keep in main body:` 这样的结构,从而把 appendix routing 的意图明确地放进 brief contract 里。
196197

197198
也就是说,brief 不是 prompt 的一部分,而是 audit trail 的一部分。
198199

docs/README.zh-TW.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,6 +193,7 @@ autolabos web # Web UI
193193
Brief 不只是啟動文件。它是 run 的 governed contract。
194194

195195
`/new` 會建立或開啟 `Brief.md``/brief start --latest` 會驗證它、將其 snapshot 到 run 中,再基於這個 snapshot 啟動執行。run 會記錄 brief source path、snapshot path,以及解析出的 manuscript format(如果有)。即使 workspace 的 brief 後續變動,該 run 的 provenance 仍然可檢視。
196+
`Appendix Preferences` 現在可以寫成 `Prefer appendix for:``Keep in main body:` 這種結構,讓 appendix routing 的意圖在 brief contract 中更明確。
196197

197198
也就是說,brief 不是 prompt 的一部分,而是 audit trail 的一部分。
198199

0 commit comments

Comments
 (0)