Skip to content

chore(claude): auto-ship INDEX row in /article-audit routine #108

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
emeraldleaf merged 1 commit into from
Jun 4, 2026
Merged

chore(claude): auto-ship INDEX row in /article-audit routine #108

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
40 changes: 39 additions & 1 deletion .claude/commands/article-audit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,45 @@ on each developer's machine; INDEX.md ships in the repo so the audit log
survives across contributors. You do not need to remove quotes from the
per-article files because they never reach the public repo.

### 6. Produce the chat output
### 6. Ship the INDEX row

INDEX.md is the only file that reaches the repo (per-article audit files
are gitignored). Don't leave the row sitting uncommitted — every previous
audit needed a separate "we need to commit?" prompt and a one-row PR to
finish the job. Roll that into the routine.

**Default — on `main` with only INDEX changed (the common case):**

```bash
SLUG=<the slug from step 5>
git checkout -b chore/audit-log-$SLUG
git add .claude/audits/INDEX.md
git commit -m "docs(audits): log $SLUG audit" -m "<one-line verdict + outcome>"
git push -u origin chore/audit-log-$SLUG
gh pr create --title "docs(audits): log $SLUG audit" --body "Single-row INDEX update for the $SLUG audit. <Verdict bucket>. <Outcome: 'No action' / 'Opened #N' / 'Updated #N in place'>."
gh pr merge --admin --squash --delete-branch
git checkout main && git pull --ff-only
```

Safe because INDEX is single-row append + metadata only, the admin-merge
bypass is configured for exactly this self-merge pattern (precedents:
#106, #107), and the chat output gives the user the verdict before
the merge — they can `gh pr edit` or `gh pr close` if something is off.

**On a feature branch** (rare — audit ran while other work in flight):
just commit the INDEX row to the current branch. It'll ship with the
next push. Mention it in the chat output so it's not forgotten.

**When the audit also opened an issue / PR**: ship the INDEX row *after*
the issue/PR work — the INDEX `Outcome` column references the issue
number (`Opened #N`), so #N has to exist first.

**User signals "wait" or "batch"**: skip the auto-ship; commit on the
current branch (if branching is needed, ask first). Surface the
unshipped row in the chat output. Subsequent audits in the same session
can batch onto the same branch.

### 7. Produce the chat output

Write directly to the user. Structure:

Expand Down
Loading