Skip to content

feat(standard): board-commissioning field reports - links rule, commissioning handoff, status-options correction - #24

Merged
PBNZ merged 4 commits into
mainfrom
feat/board-commissioning-standards
Jul 20, 2026
Merged

feat(standard): board-commissioning field reports - links rule, commissioning handoff, status-options correction#24
PBNZ merged 4 commits into
mainfrom
feat/board-commissioning-standards

Conversation

@PBNZ

@PBNZ PBNZ commented Jul 20, 2026

Copy link
Copy Markdown
Owner

What & why

Resolves the three field reports from the 2026-07-20 agent-run board commissioning, as one batch (one commit per issue, ADR-0008 records the triage — all three accepted):

Refs #21, Refs #22, Refs #23 — plain refs; a human closes after verifying.

Checklist

  • One concern per PR (one batch, one concern: adopting the commissioning field reports; one commit per issue).
  • Driving issues referenced as Refs #NN (no auto-close keywords).
  • Conventional Commit title.
  • CHANGELOG.md updated under ## [Unreleased].
  • Validation passes locally (all five Python checks + repokit-check.ps1 green).
  • ADR added: docs/adr/0008-board-commissioning-standard-improvements.md.

🤖 Generated with Claude Code

https://claude.ai/code/session_01LN8Gec6kVv25mmN38xGZAQ

PBNZ and others added 4 commits July 20, 2026 16:29
…hoed (refs #23)

The org-migration checklist's status-options landmine overstated the rule:
the failure is specific to an id-less replacement, not to any API edit.
ProjectV2SingleSelectFieldOptionInput takes an optional id (verified against
the live GraphQL schema and a 75-item board); echoing ids for kept/renamed
options preserves built-in workflows and item values. Rewritten in the
checklist's symptom -> cause -> fix form, with the verify step included.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LN8Gec6kVv25mmN38xGZAQ
…at output (refs #22)

The links-not-code-formatting rule existed only as an Option B formatting
note in agent-collaboration.md, so it fired for one issue shape and nowhere
else. It now lives in doc-style.md as a deterministic Links section: the
paste-this/go-here test, explicit scope including the agent's own chat
output, a construction table for the chat/cross-repo cases where #NN and
relative links silently fail, and the first-mention-wins counter-case.
agent-collaboration.md references it instead of restating it, the pre-PR
checklist gains a links-resolve item, and the scaffolded AGENTS.md names
the chat-output half (behaviour, not lintable).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LN8Gec6kVv25mmN38xGZAQ
…due (refs #21)

An agent can commission a project board almost end-to-end, but views have
no create API, auto-add is UI-only and plan-capped, and some steps are
deliberately human - and that residue was being delivered as ephemeral
chat prose while the work stood reported done. agent-collaboration.md
gains a Commissioning handoff section: one assigned, checkboxed issue in
the review column owns the residue, each step names why it is manual (the
reason expires, so it must be re-evaluable), and the issue links what was
commissioned. The session-end checklist gains the matching tripwire and
the org-migration board-rebuild checklist points its click-through at the
handoff issue instead of budgeting it into chat.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LN8Gec6kVv25mmN38xGZAQ
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant