How we work

One set of rules for how the user and their agents work on a project, kept here and nowhere else. A project that uses it carries the common block (common.md) inside its AGENTS.md, between two marker comments, so that it is in context in every session; the block points back here for the reference that goes with each kind of work. What only one project needs stays in that project: outside the block in its AGENTS.md, and in its docs/conventions/<kind>.md.

At the start of a session: sync

Run in the project's root, with this skill's scripts/ on the PATH:

set -o pipefail; export PATH="<this skill's absolute path>/scripts:$PATH";
hww.py sync

It replaces the block in AGENTS.md, markers included, with the block of common.md, and prints one JSON line for the block and one for each entry under ## To promote (or ## 待提升) in the project's own part of AGENTS.md and in its docs/conventions/*.md. Who takes over; the first two rows can both apply to one run: