claudiomaradonna/agent-foundry
claudiomaradonna/agent-foundry
Template
1
0
Fork 0
Code Issues 5 Pull requests Activity

fix(agents): restore the Members list legend #156

Merged
claudiomaradonna merged 1 commit from fix/members-legend into main 2026-10-21 10:57:29 +02:00
Conversation 0 Commits 1 Files changed 1 +3
motoko commented 2026-10-21 10:45:37 +02:00
Collaborator
Copy link

Why

Fixes #148. Once an umbrella fills its Members list, as in
- app-api: `AppAPI`, `contribute` , no sentence says which field is
the <name> of .worktrees/<name>/<branch> and which the <path> of
git -C <path>. a3f65be cut the old legend as noise, on the ground that
the validator and the install steps cover the form, but both reach only
whoever fills the list, not an agent reading it in a later session.

What changed

  • § Members says, above the list, that each entry gives a member's
    name, its path from the umbrella root, and its role, in that order.
  • The name's lowercase hyphenated form stays with the validator, which
    tells whoever adds a member; the entry format and the validator are
    unchanged.
  • The sentence sits above the list's <!-- prettier-ignore --> marker,
    so the marker still keeps a long entry on one line.

How to verify

  • This check prints 1, and 0 on main:

    sed -n '/^## Members/,/^- <MEMBER_NAME>/p' AGENTS.md \
  | sed '$d' | tr -s '[:space:]' ' ' \
  | grep -Eo '[^.]*name[^.]*path[^.]*role[^.]*\.' | grep -c .

  • grep -A1 '^<!-- prettier-ignore -->$' AGENTS.md prints the marker,
    then the placeholder line.

Run on the tip, all passing: bash tests/verify-agent-config.sh (268
tests), bash tests/check-work-folder.sh (46),
.agents/hooks/shellcheck.sh repo, prettier --check '**/*.md',
scripts/verify-agent-config.sh, and git diff --check main. No
behavioral eval ran: whether agents now read a filled entry right would
take one.

## Why Fixes #148. Once an umbrella fills its Members list, as in ``- app-api: `AppAPI`, `contribute` ``, no sentence says which field is the `<name>` of `.worktrees/<name>/<branch>` and which the `<path>` of `git -C <path>`. a3f65be cut the old legend as noise, on the ground that the validator and the install steps cover the form, but both reach only whoever fills the list, not an agent reading it in a later session. ## What changed - § Members says, above the list, that each entry gives a member's name, its path from the umbrella root, and its role, in that order. - The name's lowercase hyphenated form stays with the validator, which tells whoever adds a member; the entry format and the validator are unchanged. - The sentence sits above the list's `<!-- prettier-ignore -->` marker, so the marker still keeps a long entry on one line. ## How to verify - This check prints `1`, and `0` on `main`: ```bash sed -n '/^## Members/,/^- <MEMBER_NAME>/p' AGENTS.md \ | sed '$d' | tr -s '[:space:]' ' ' \ | grep -Eo '[^.]*name[^.]*path[^.]*role[^.]*\.' | grep -c . ``` - `grep -A1 '^<!-- prettier-ignore -->$' AGENTS.md` prints the marker, then the placeholder line. Run on the tip, all passing: `bash tests/verify-agent-config.sh` (268 tests), `bash tests/check-work-folder.sh` (46), `.agents/hooks/shellcheck.sh repo`, `prettier --check '**/*.md'`, `scripts/verify-agent-config.sh`, and `git diff --check main`. No behavioral eval ran: whether agents now read a filled entry right would take one. 
Once an umbrella fills its Members list, no sentence said which field
of an entry is the name that .worktrees/<name>/<branch> uses and which
the path that git -C <path> uses: a3f65be cut the legend as noise,
since the validator and the install steps cover the form, but neither
reaches an agent reading a filled list. One sentence above the list's
prettier-ignore marker names the fields in order. Reported in #148.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
claudiomaradonna/agent-foundry!156
No description provided.