Skip to content

docs: soul-file ISSUES-INDEX + HB-003 github-settings drift#83

Merged
AceHack merged 4 commits intoLucent-Financial-Group:mainfrom
AceHack:docs/soul-file-independence-index
Apr 22, 2026
Merged

docs: soul-file ISSUES-INDEX + HB-003 github-settings drift#83
AceHack merged 4 commits intoLucent-Financial-Group:mainfrom
AceHack:docs/soul-file-independence-index

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 22, 2026

Summary

Three net-new soul-file commits landing on LFG, per Aaron 2026-04-21 directive: "we are git native so still keep a record in the soul file for independence" — the git repo itself must independently retain the record of what got translated to GitHub issues, so the factory remains reproducible from git alone.

  • fd2125f — land docs/ISSUES-INDEX.md: git-native mapping of LFG issues <P0> Nation-state + supply-chain threat-model rewrite #55-<P1> Escalate-to-human-maintainer criteria-sweep (will-propagation gap) #82 back to their BACKLOG.md source rows (section + line range). Authoritative-pointer, not authoritative-content: BACKLOG stays the source of truth; the index is a cross-reference that survives any GitHub issue-tracker outage or migration.
  • 604785e — BACKLOG.md meta-section pointer to ISSUES-INDEX.md so the cross-reference is discoverable from the authoritative record.
  • 0c9cca9 — HUMAN-BACKLOG.md HB-003 row: a drift-check autonomous pass found tools/hygiene/github-settings.expected.json has build-and-test (macos-14) in the checked-in baseline but absent from live LFG branch-protection (matches prior task frontier-readiness: gap #5 audit — 3 directory-level audits (agents + openspec + github) #191 build-matrix-split decision). Agent declined to auto-update the baseline on a retractable-safe tick (shared-infra-policy; baseline updates want human sign-off so unrelated drift isn't silently ratified) — surfaces the decision for Aaron rather than silently waiting.

Why this is the right shape

  • Soul-file discipline. The ISSUES-INDEX bridges dispatch-surface (GitHub issues) back to authoritative-record (BACKLOG.md) so the factory is reproducible without GitHub. Text-only, small, portable — fits the soul-file constraint.
  • HB-003 honors the agent/human boundary. Drift-check ran read-only (retractable-safe); the fix is irretractable (shared-infra baseline change) so it goes to HUMAN-BACKLOG rather than a unilateral agent commit.
  • Witnessable-self-directed-evolution. The HB-003 commit message narrates the wrong-move → correction (autonomous permission-denied on cp ... expected.json) → course-correction (file the row instead). Preserved in git history legibly.

Test plan

  • docs/ISSUES-INDEX.md issue→line mappings resolve against current docs/BACKLOG.md line numbers
  • BACKLOG.md meta pointer renders as a readable bullet (not a Markdown syntax glitch)
  • HUMAN-BACKLOG.md HB-003 row is in Aaron's sub-table with no conflict-marker residue
  • bash tools/hygiene/check-github-settings-drift.sh still exits 1 with the same single-line diff (no baseline mutation in this PR)

🤖 Generated with Claude Code

AceHack and others added 3 commits April 21, 2026 23:00
…inancial-Group#55-82 for soul-file independence

Aaron 2026-04-21: *"oh yeah remember we are git native so still
keep a record in the soul file for independence"* — after 28
BACKLOG rows translated to LFG GitHub issues (Lucent-Financial-Group#55-Lucent-Financial-Group#82) via
parallel agent dispatch, the soul-file (git repo) must
independently retain the record so the factory is reproducible
without GitHub.

Index maps each issue number to:
- priority (P0/P1)
- title
- BACKLOG.md source section + line-range
- GitHub URL (LFG remote)

Authoritative content stays in docs/BACKLOG.md; GitHub issues
are a dispatch surface, not the record of truth. If GitHub or
the LFG org vanishes, a fork can reconstitute the tracker from
this file + BACKLOG.md via the documented regeneration protocol.

Composes with:
- memory/user_git_repo_is_factory_soul_file_reproducibility_substrate_aaron_2026_04_21.md
- memory/feedback_capture_everything_including_failure_aspirational_honesty.md
- memory/feedback_witnessable_self_directed_evolution_factory_as_public_artifact.md

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

Cross-reference BACKLOG.md ↔ ISSUES-INDEX.md so a future
contributor reading BACKLOG discovers the issue-tracker
mapping without needing to know the file name already.

Retractable-safe additive edit (one bullet in Meta section,
no row content modified). Composes with the ISSUES-INDEX.md
landing in d6ded51.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Autonomous drift-check tick on LFG/Zeta surfaced a single-line
bounded diff: `build-and-test (macos-14)` is in checked-in
expected snapshot but absent from live branch-protection.
Matches prior task Lucent-Financial-Group#191 decision (macOS on AceHack fork, Linux
on LFG). Agent declined to overwrite the baseline autonomously
— shared-infra policy moves want explicit human sign-off so
unrelated drift isn't silently ratified. Row files the decision
for Aaron.

Fighter-pilot discipline: tactical authority on retractable reads
(run drift-check), chain-of-command preserved on policy writes
(baseline update).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 22, 2026 03:01
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 a git-native “soul-file” index that maps GitHub issues back to their originating docs/BACKLOG.md rows, and records a GitHub settings-drift decision for human disposition—aiming to keep the factory reconstructible from git alone.

Changes:

  • Introduces docs/ISSUES-INDEX.md to map LFG GitHub issues (#55#82) back to docs/BACKLOG.md sections + line ranges.
  • Adds a docs/BACKLOG.md meta pointer to the new issues index for discoverability.
  • Adds HB-002 / HB-003 entries to docs/HUMAN-BACKLOG.md (including the GitHub-settings drift disposition decision).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File Description
docs/ISSUES-INDEX.md New index file mapping GitHub issues to BACKLOG line ranges + reconstruction protocol.
docs/HUMAN-BACKLOG.md Adds human-decision backlog rows HB-002 and HB-003 (incl. GitHub settings drift disposition).
docs/BACKLOG.md Adds a meta bullet pointing to docs/ISSUES-INDEX.md as the git-native cross-index.

Comment thread docs/ISSUES-INDEX.md Outdated
Comment thread docs/ISSUES-INDEX.md Outdated
Comment thread docs/ISSUES-INDEX.md Outdated
Comment thread docs/ISSUES-INDEX.md Outdated
Comment thread docs/HUMAN-BACKLOG.md Outdated
Comment thread docs/HUMAN-BACKLOG.md Outdated
@AceHack AceHack enabled auto-merge (squash) April 22, 2026 03:08
…fixes

ISSUES-INDEX.md (P0 + three P1 Copilot comments):

- Replace brittle line-range anchors with section-header +
  bullet-keyword anchors. Line numbers drift on every BACKLOG
  edit; section titles and bold-title keywords survive. All 28
  row anchors verified to resolve to their sections on this
  PR branch.
- Drop auto-memory cross-references (files under `memory/*`
  that live outside the git tree and therefore violate the
  "standalone reconstruction from this repo" soul-file
  discipline the doc is defending).
- Replace contributor-name prose filename reference with
  role-neutral language per `docs/AGENT-BEST-PRACTICES.md`
  L284-L290 (names confined to `memory/persona/<name>/`
  and optionally `docs/BACKLOG.md`).
- Add a Source-availability note for six rows whose source
  bullets are expected to land via Batch 6 of the speculative
  drain (Lucent-Financial-Group#57, Lucent-Financial-Group#60, Lucent-Financial-Group#63, Lucent-Financial-Group#79, Lucent-Financial-Group#80, Lucent-Financial-Group#81); mark them
  `source pending Batch 6 drain` so re-verification after
  the drain is explicit.
- Expand the What-this-file-is-NOT and Composition sections
  to cite in-tree authoritative sources (BACKLOG.md,
  GOVERNANCE.md §2/§24, HUMAN-BACKLOG.md) instead of
  auto-memory paths.

HUMAN-BACKLOG.md (two Copilot comments):

- HB-002: decisions file path was cited as if present, but
  the ADR was drafted on the speculative fork branch and
  lands on LFG only via Batch 6. Rephrase the Source cell to
  describe current location + expected on-LFG path, so the
  citation stays valid before and after the drain.
- HB-003: replace the "in-flight Round 44 notes" pointer
  (no in-repo path) with the concrete commit `77c2450`
  (`gate.yml: split macOS leg to forks only; drop (macos-14)
  from LFG required checks`) which implemented the matrix
  split that produced this drift.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack
Copy link
Copy Markdown
Member Author

AceHack commented Apr 22, 2026

Addressed all 6 Copilot review comments in commit 5a79704.

ISSUES-INDEX.md:

  • P0 line-range drift — rewrote the index to use section-header + bullet-keyword anchors instead of line-ranges. BACKLOG.md is a living doc; line numbers drift on every edit. Section titles and bold-title keywords survive arbitrary churn. All 28 row anchors verified to resolve to their sections on this PR branch.
  • P1 missing auto-memory cross-refs (two findings) — dropped the memory/* references. Those paths are per-user auto-memory that live outside the git tree, which is precisely the kind of external dependency the soul-file discipline this doc is defending says should not be required for standalone reconstruction. Replaced with in-tree pointers (BACKLOG.md, GOVERNANCE §2/§24, HUMAN-BACKLOG.md).
  • P1 contributor-name prose — removed the filename reference containing a contributor name per docs/AGENT-BEST-PRACTICES.md L284-L290. The discipline that informed the doc is now stated directly in the doc body without citing a name-bearing filename.

HUMAN-BACKLOG.md:

  • P1 HB-002 decisions file — the ADR was drafted on the speculative fork branch and lands on LFG only after the Batch 6 drain. Reworded the Source cell to describe current location (fork branch, fork PR Round 28 — FsCheck LawRunner (Option B) + round-29 CI anchor #4) + expected on-LFG path after drain, so the citation is valid before and after Batch 6.
  • P2 HB-003 source cell — replaced "in-flight Round 44 notes" (no in-repo path) with commit 77c2450 (gate.yml: split macOS leg to forks only; drop (macos-14) from LFG required checks), the actual commit that implemented the matrix split producing this drift.

Added a Source-availability note covering the six rows (#57, #60, #63, #79, #80, #81) whose bullet keywords expect to resolve only after Batch 6 drain — those are explicitly marked source pending Batch 6 drain so re-verification is legible.

Threads resolved. Re-arming auto-merge.

@AceHack AceHack merged commit a3d1721 into Lucent-Financial-Group:main Apr 22, 2026
11 checks passed
AceHack added a commit that referenced this pull request Apr 22, 2026
Three P1 Copilot findings on this org-transfer cleanup PR,
addressed in-place per the drain-pre-check discipline
(captured in auto-memory after PR #83 rework cycle):

1. docs/security/INCIDENT-PLAYBOOK.md:369-370 — the
   contact-tree primary line carried a contributor name
   ("Aaron") and a mid-repo-identifier line wrap. Rewrote
   to role-neutral ("human maintainer") with the repo
   identifier held as a single inline token.
2. .claude/skills/nuget-publishing-expert/SKILL.md:30-31
   — stale operational-state line said the repo was
   private on AceHack; the whole point of this PR is to
   reflect the Lucent-Financial-Group/Zeta transfer and
   public-visibility flip. Updated to match current
   state and note the remaining NuGet gates
   (prefix-reservation + release.yml) so the skill
   stays internally consistent.

Also merged origin/main into this branch to clear the
BEHIND status left by PR #83's landing.

No other file changes; PR scope remains the four URL
cleanups Copilot otherwise rated clean.
AceHack added a commit that referenced this pull request Apr 22, 2026
…p/Zeta (#48)

* cleanup: update 4 outdated AceHack/Zeta URLs to Lucent-Financial-Group/Zeta

Post-transfer operational-state references that weren't caught in the
initial transfer pass. All four are current-state statements (API
endpoint examples, package metadata, maintainer-contact info) that
read as current truth — not historical records of actions taken on
the old repo.

Files + change shape:

- `.claude/skills/nuget-publishing-expert/SKILL.md` —
  `<PackageProjectUrl>` + `<RepositoryUrl>` in the NuGet metadata
  example; plus `<Company>AceHack</Company>` → `Lucent Financial
  Group`. The skill documents what gets published on `dotnet pack`,
  which now ships under the LFG identity.
- `docs/copilot-wins.md` — the `gh api repos/…/pulls/…/comments`
  example uses the real current-state repo path so contributors can
  copy-paste it.
- `docs/NAMING.md` — naming sheet row that was literally
  parenthesised "currently `AceHack/Zeta`"; now `Lucent-Financial-
  Group/Zeta`. The "currently" hedge is gone; LFG is the steady
  state.
- `docs/security/INCIDENT-PLAYBOOK.md` — contact tree. Incident
  responders reading the playbook need the current canonical repo
  identifier, not the pre-transfer one.

Explicitly NOT touched:
- `docs/ROUND-HISTORY.md`, `docs/HUMAN-BACKLOG.md`,
  `docs/GITHUB-SETTINGS.md`, `docs/FACTORY-HYGIENE.md`,
  `docs/research/parallel-worktree-safety-2026-04-22.md`,
  `docs/HARNESS-SURFACES.md` — these carry AceHack/Zeta refs as
  *historical record* (transfer-event narration, empirical-test
  results literally run on the pre-transfer repo, FACTORY-HYGIENE
  row describing the triggering incident). Docs-read-as-current-
  state rule (GOVERNANCE §2) doesn't touch the archive layer, and
  round-history + ADR-style records of *what happened where* are
  that archive layer.

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

* address Copilot P1 findings on PR #48

Three P1 Copilot findings on this org-transfer cleanup PR,
addressed in-place per the drain-pre-check discipline
(captured in auto-memory after PR #83 rework cycle):

1. docs/security/INCIDENT-PLAYBOOK.md:369-370 — the
   contact-tree primary line carried a contributor name
   ("Aaron") and a mid-repo-identifier line wrap. Rewrote
   to role-neutral ("human maintainer") with the repo
   identifier held as a single inline token.
2. .claude/skills/nuget-publishing-expert/SKILL.md:30-31
   — stale operational-state line said the repo was
   private on AceHack; the whole point of this PR is to
   reflect the Lucent-Financial-Group/Zeta transfer and
   public-visibility flip. Updated to match current
   state and note the remaining NuGet gates
   (prefix-reservation + release.yml) so the skill
   stays internally consistent.

Also merged origin/main into this branch to clear the
BEHIND status left by PR #83's landing.

No other file changes; PR scope remains the four URL
cleanups Copilot otherwise rated clean.

---------

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