Skip to content

drain(#126 follow-up): Gemini capability map xref truth-update#428

Merged
AceHack merged 2 commits intomainfrom
drain/126-followup-gemini-xref
Apr 25, 2026
Merged

drain(#126 follow-up): Gemini capability map xref truth-update#428
AceHack merged 2 commits intomainfrom
drain/126-followup-gemini-xref

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 25, 2026

Codex post-merge thread on PR #126: docs/research/gemini-cli-capability-map.md was described as "currently on PR #122, not yet merged", but the file now exists in main. Updated to "landed in main; sibling pre-install sketch using the same template".

Copilot AI review requested due to automatic review settings April 25, 2026 04:23
@AceHack AceHack enabled auto-merge (squash) April 25, 2026 04:23
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates a cross-reference note in the Grok CLI capability map to reflect that the Gemini capability map has already landed in main, removing outdated “not yet merged” wording.

Changes:

  • Rewords the “Companion to” entry for the Gemini CLI map to indicate it is now in main.
  • Adjusts the surrounding phrasing to reflect current repository state.

Comment thread docs/research/grok-cli-capability-map.md Outdated
Comment thread docs/research/grok-cli-capability-map.md Outdated
AceHack added 2 commits April 25, 2026 00:33
…ok is the pre-install sketch

Two Codex post-merge findings on the #126 follow-up PR #428:

P2 — Gemini link plain-text vs others clickable:
The Gemini entry in the Companion-to list was plain text while
Claude and Codex were clickable markdown links. Made it
consistent: all three siblings now link to their respective
docs.

P1 — 'sibling pre-install sketch' wording implied Gemini was
also a pre-install sketch:
The Gemini map is actually 'first map — verified against
gemini --version 0.39.1 on 2026-04-24'. My follow-up wording
said 'sibling pre-install sketch using the same template'
which read as if Gemini was also pre-install. Reworded to
'(v0.39.1, verified). The Grok map below is the only
pre-install sketch in this set; Claude / Codex / Gemini
siblings are all verified.'
@AceHack AceHack force-pushed the drain/126-followup-gemini-xref branch from 7ac3799 to cc2e64d Compare April 25, 2026 04:34
@AceHack AceHack merged commit dfe1671 into main Apr 25, 2026
13 checks passed
@AceHack AceHack deleted the drain/126-followup-gemini-xref branch April 25, 2026 04:36
AceHack added a commit that referenced this pull request Apr 25, 2026
…mini xref)

Otto-268 follow-on: drain-log for the targeted single-finding cascade
PR #428 (post-merge follow-up to parent #126 Grok CLI capability map).
Captures one Gemini capability-map cross-reference truth-update.

Per Otto-250 training-signal discipline. Pattern observations:

1. Cross-capability-map xref consistency is its own class. The repo
   has a growing family of CLI capability maps (Codex / Grok /
   Gemini / Claude Code) that form a related-document cluster
   needing joint cross-reference maintenance. Future doc-lint
   candidate: maintain manifest of related-document clusters and
   warn on edit-without-sweep.

2. Multi-CLI capability-map family is its own substrate pattern.
   Worth documenting in `_patterns.md`: when multiple capability
   maps cover overlapping but distinct CLIs, they form a cluster
   that benefits from shared structure (status taxonomy, parity-
   matrix shape, score-summary conventions) and joint
   cross-reference maintenance.

3. Targeted single-finding follow-ups are the cheapest cascade
   shape — 1 finding / 1 commit / 1 merge gate. Cascade-pattern
   amortized cost is dominated by the few-thread cascades.

URL → PR-number defensive pattern continues (lesson from #454/#455
collision earlier this session).
AceHack added a commit that referenced this pull request Apr 25, 2026
…#460)

* hygiene(#268+): pr-preservation drain-log for #428 (#126 follow-up Gemini xref)

Otto-268 follow-on: drain-log for the targeted single-finding cascade
PR #428 (post-merge follow-up to parent #126 Grok CLI capability map).
Captures one Gemini capability-map cross-reference truth-update.

Per Otto-250 training-signal discipline. Pattern observations:

1. Cross-capability-map xref consistency is its own class. The repo
   has a growing family of CLI capability maps (Codex / Grok /
   Gemini / Claude Code) that form a related-document cluster
   needing joint cross-reference maintenance. Future doc-lint
   candidate: maintain manifest of related-document clusters and
   warn on edit-without-sweep.

2. Multi-CLI capability-map family is its own substrate pattern.
   Worth documenting in `_patterns.md`: when multiple capability
   maps cover overlapping but distinct CLIs, they form a cluster
   that benefits from shared structure (status taxonomy, parity-
   matrix shape, score-summary conventions) and joint
   cross-reference maintenance.

3. Targeted single-finding follow-ups are the cheapest cascade
   shape — 1 finding / 1 commit / 1 merge gate. Cascade-pattern
   amortized cost is dominated by the few-thread cascades.

URL → PR-number defensive pattern continues (lesson from #454/#455
collision earlier this session).

* drain(#460 follow-up): fix capability-map xref + inline-code-span split

Codex P2 + Copilot P1+P2 caught:

- Inline code span split across newline (`docs/` on one line,
  `research/openai-codex-cli-capability-map.md` on the next) —
  reflowed to single-line so the path renders as one token.
- Capability-map cluster listed `docs/research/codex-cli-first-
  class-2026-04-23.md` as if in-tree, but PR #231 is still OPEN
  at time of this drain-log so the file isn't yet in main.
  Reframed as 'pending merge of PR #231; will be in-tree once
  that PR lands' with the in-tree
  `openai-codex-cli-capability-map.md` listed first.

Same forward-author-to-future-state-of-main drift class as #377
(38% stale-resolved density). The drain-log itself exhibits the
pattern it documents — cited a forthcoming-but-not-yet-landed
file as if already present.

Inline-code-span line-wrap is the 5th observation of that class
in the corpus (now: #191 / #195 / #219 / #423 / #460). At this
density the doc-lint Class A (PR #465 BACKLOG) is high-leverage
automation.
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.

2 participants