Skip to content

Round 44: AGENTS.md — pointer to docs/AGENT-ISSUE-WORKFLOW.md (batch 6c of 6)#88

Open
AceHack wants to merge 2 commits intoLucent-Financial-Group:mainfrom
AceHack:land-agents-md-issue-workflow-pointer-batch6c
Open

Round 44: AGENTS.md — pointer to docs/AGENT-ISSUE-WORKFLOW.md (batch 6c of 6)#88
AceHack wants to merge 2 commits intoLucent-Financial-Group:mainfrom
AceHack:land-agents-md-issue-workflow-pointer-batch6c

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 22, 2026

Summary

One-line addition to AGENTS.md required-reading section: a pointer to `docs/AGENT-ISSUE-WORKFLOW.md` (the dual-track-principle + adapter-choice doc that landed on main via #84).

AGENTS.md is the universal onboarding handbook. It already lists every required-reading doc. This PR plugs the missing pointer so the newly-landed `docs/AGENT-ISSUE-WORKFLOW.md` is discoverable via the canonical entry point.

Scope

  • 1 file changed: `AGENTS.md`, +11 lines.
  • Additive only: new bullet between `FOUNDATIONDB-DST.md` and `docs/category-theory/README.md`. No existing content modified.

Intentionally deferred

The speculative branch had broader AGENTS.md / CLAUDE.md additive diffs pointing at `docs/AUTONOMOUS-LOOP.md` as well. That file has not yet landed on main (pending a contributor-name scrub per the drain-PR pre-check discipline). Landing the pointer here would create a dangling reference, so it's deferred to a future batch that will land `AUTONOMOUS-LOOP.md` scrubbed + its pointers in the same sweep.

Batch 6c of 6

Test plan

  • Pre-check (memory/ refs + contributor-name prose) — 0 hits
  • Copilot review clean
  • CI green (doc-only; no code changes)

🤖 Generated with Claude Code

… of 6)

Adds pointer in AGENTS.md required-reading section to
docs/AGENT-ISSUE-WORKFLOW.md (landed on main via Lucent-Financial-Group#84).
AGENT-ISSUE-WORKFLOW.md defines the dual-track principle
(active-workflow claim + parallelization-lock surface +
durable in-repo markdown research substrate) and the three
adapter choices adopters pick at factory-reuse setup
(GitHub Issues / Jira-or-any-SaaS / git-native-only).

This is the third additive-only sub-batch in the six-batch
drain of round-44 speculative work. The larger AGENTS.md /
CLAUDE.md additive diffs from speculative reference
docs/AUTONOMOUS-LOOP.md which has not yet landed
(pending contributor-name scrub per drain pre-check
discipline); landing those pointers now would create a
dangling reference, so they are deferred to a future batch
after AUTONOMOUS-LOOP.md lands.

Additive-only: one new pointer bullet, no existing content
changed.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 22, 2026 04:03
@AceHack AceHack enabled auto-merge (squash) April 22, 2026 04:03
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

Adds the missing required-reading pointer in AGENTS.md so new contributors discover docs/AGENT-ISSUE-WORKFLOW.md (the dual-track principle + adapter-choice workflow doc) via the project’s canonical onboarding entry point.

Changes:

  • Add a new bullet under “Contributor required reading” linking to docs/AGENT-ISSUE-WORKFLOW.md.
  • Summarize the doc’s purpose (dual-track principle + adapter choices + claim/release protocol) inline in AGENTS.md.

Comment thread AGENTS.md
Comment on lines +310 to +311
adopters pick at setup (GitHub Issues / Jira
or any SaaS / git-native only). Covers the
Copy link

Copilot AI Apr 22, 2026

Choose a reason for hiding this comment

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

The parenthetical adapter list says "Jira / or any SaaS / git-native only", but docs/AGENT-ISSUE-WORKFLOW.md defines the second option as a ticketing SaaS (e.g., Jira/Linear/Asana/Shortcut), not arbitrary SaaS. Consider tightening this wording to avoid implying any SaaS product can serve as the active-workflow adapter without additional constraints.

Suggested change
adopters pick at setup (GitHub Issues / Jira
or any SaaS / git-native only). Covers the
adopters pick at setup (GitHub Issues /
ticketing SaaS such as Jira/Linear/Asana/
Shortcut / git-native only). Covers the

Copilot uses AI. Check for mistakes.
AceHack added a commit that referenced this pull request Apr 22, 2026
* Round 44 tick-history: auto-loop-2 PR refresh row

Second post-compaction tick. PR #91 refresh after PR #90 merged
4ac3ec3 on main mid-tick; PR #46 refresh after stale-local
reset (bc93188..63720e5). Fork PRs #88/#85/#52/#54 noted as
un-refreshable from current agent harness.

Tick-commits-on-PR-branch = live-loop class (row 112) preserved
via separate branch land-tick-history-autoloop-2-append off
origin/main.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* tick-history row fixes — Copilot findings on PR #92

Three fixes to the auto-loop-2 row:
1. Drop "AceHack" handle → "fork ownership outside the canonical
   repo" (BP-L284-L290 compliance)
2. Full ISO8601 timestamp (2026-04-22T04:20:00Z) per file schema
3. Drop self-referential "(row 112 of this file)"

Pre-check grep expanded to include "acehack" handle — prior
grep only caught "aaron" + memory/* refs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
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