Workspace files¶
Every file in a generated workspace, who owns it, and who changes it.
Path |
Owner |
Agent may edit? |
Purpose |
|---|---|---|---|
|
template |
no |
Short instructions: session loop, rules, variant notes |
|
template |
no |
|
|
project |
ticks boxes, overwrites Handoff |
Goal, acceptance criteria, steps, scope, Handoff |
|
project |
adds entries at top |
Dated, human-readable history of the deliverable |
|
Copier |
no |
Template version and answers; used by |
|
generated |
no |
JIRA/Confluence snapshots (reference, not instructions) |
|
template |
no |
The rules |
|
template |
no |
Plot helpers + |
|
template |
no |
|
|
template |
no |
Diagram theme |
|
project |
yes |
Mermaid sources |
|
generated |
via scripts only |
Rendered plots and diagrams |
|
generated |
via |
Settings for captions |
|
humans |
never |
Hand-annotated overrides |
|
template |
runs it |
Snapshot JIRA/Confluence |
|
template |
runs it |
Mermaid → figures |
|
template |
runs it |
Stale-annotation check |
|
template |
no |
Python dependencies |
|
project |
yes |
The deliverable (one per variant) |
|
template |
no |
TeX search path, tolerant BibTeX |
“Template-owned” files are refreshed by copier update; local edits to them get merged
or flagged as conflicts, so propose changes to the template instead.