Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -356,6 +356,49 @@ Suggested commit cadence:
3. stage only the intended files
4. commit before starting the next distinct chunk

### Daily work log and push checkpoints

Use a daily work log when work touches a major workspace such as `docs/`,
`docs/topics/`, `uet_history/`, `thailand_proposals/`, `services_and_experiments/`,
or another top-level project area.

Write the log under `docs/UET_Documentation_Details/WORK_LOG/` using one file per
day, such as `2026-07-04.md`. The log is not a replacement for topic
`UPDATE_LOG.md`; it is the repo-level operating trace that shows what moved that
day and what still needs a commit, push, or PR.

Add one work-log entry after each completed section of work. A section can be a
research pass, source cleanup, documentation repair, result artifact review,
history migration, service experiment change, or any coherent batch that a future
reviewer should be able to reconstruct without reading the whole diff first.

Each entry should record:

- timestamp or short section label
- workspace or topic touched
- files or artifact groups changed
- verifier, audit, or review actually run, if any
- what remains uncommitted, private, or unsafe to publish
- next commit or push action

Do not let work logs become another place for vague progress claims. Keep them
short, factual, and tied to actual files or artifacts.

Checkpoint rule:

- if 10 work-log entries exist for the current unpushed work, stop expanding scope
- inspect `git status` and stage only the intended files
- commit the safe coherent unit
- push the branch the same day whenever network and repository policy allow it
- if the work is not ready for `main`, open or update a draft PR instead of
leaving the branch local-only
- if files are unsafe to publish, commit a manifest or log note that names the
excluded class without publishing the raw/private content

Do not start an eleventh work-log entry until the checkpoint decision is made.
If a push is blocked, record the blocker and the exact next action in the daily
work log before continuing.

For multi-wave hardening, a good unit is:

1. one blocker narrowed
Expand Down
23 changes: 23 additions & 0 deletions docs/UET_Documentation_Details/WORK_LOG/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# UET Work Log

This folder records daily operating checkpoints for work that spans major UET
workspaces.

Use one file per day, named like `2026-07-04.md`.

Each completed work section should add a short entry with:

- timestamp or section label
- workspace or topic touched
- files or artifact groups changed
- verifier, audit, or review run, if any
- what remains uncommitted, private, or unsafe to publish
- next commit or push action

This log does not replace topic-level `UPDATE_LOG.md` files. Topic logs describe
research state changes. This folder tracks daily repository work so progress
does not sit invisible in local branches.

After 10 entries for unpushed work, stop expanding scope and make a checkpoint:
inspect status, stage only intended files, commit the safe unit, and push or open
a draft PR. If publishing is blocked, record the blocker here before continuing.
Loading