Skip to content

Docs migration batch: Atlas documentation sweep (untracked workspace sources → code doc/) #5981

Open

Description

@dezren39

Docs migration batch — Atlas documentation sweep. Part of the hatch → code docs migration tracking issue. Full plan: ~/workspace/scratch/docs-migration-plan-2026-11-04/plan.md (§9, Atlas reality check).

Finding that shapes this batch

Inventory (2026-11-04) found zero Atlas documents in the tracked files of hatch-personal, hatch, or darwin-nix. (darwin-nix "atlas" hits are all Atlassian false positives.) Drew's premise — Atlas docs landed in hatch and should move to code — holds for the sandbox workspace, not the git repos: Atlas design and research material lives in untracked locations:

  • ~/workspace/research_notes/ (quota/Atlas research notes)
  • ~/workspace/goals/** workspaces (atlas-related goal files + hidden state)
  • ~/memory/ topic files (agent-maintained memory, not a move source — reference only)
  • Conversation logs / daily logs mentioning Atlas design decisions
  • code's own doc/ already holds some (dated design dirs; pkgs/atlas-search exists)

Work

  1. Enumerate Atlas documents in the untracked locations above (title, location, date, one-line subject).
  2. Copy the design/reference documents into code doc/ (an atlas/ subarea or the existing dated-design convention — PR decides), via the normal PR flow. Copy, never delete — sources stay.
  3. Leave pointer notes where a swept doc was previously cited from (goal workspaces), so references don't break silently.
  4. Report the enumeration back on this issue; anything sensitive or clearly ephemeral stays out, listed by name with the reason.

Out of scope

The longer-term integration of all docs/notes/logs into Atlas + the Zettelkasten graph / ID system (with classifications) — that's the future direction recorded in the tracking issue, not this batch.

Activity

  1. developing-today commented on Nov 5, 2026

    @developing-today
    Contributor
  2. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    Cross-link: ingestion consumers of this sweep

    The Atlas ingestion program (tracker #6018, filed 2026-11-04) consumes this issue's enumeration twice:

    • The first-pass corpus task (#6025) ingests "all the docs we can find" — explicitly including the untracked material this sweep enumerates (research notes, goal workspaces, memory topics). This issue's inventory is that task's doc-source list.
    • The agent-notes placement design (#6022) must agree with the docs-migration classification standard (#5983): sandbox-environment material stays in hatch-personal; everything else canonicalizes to code / zettel / ID graph — and each home needs an Atlas ingestion path with provenance marks.

    No action needed here beyond the link; sequencing (sweep first, then ingest) is recorded on #6025.

  3. added
    queue/queuedHas a queued task in the Supabase agent queue
    task/triageQueue packet kind: verify, reproduce, and route this item
    on Nov 5, 2026
  4. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  5. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · state: handed off

  6. added
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    work/assignedQueue worker lifecycle state
    and removed
    queue/queuedHas a queued task in the Supabase agent queue
    on Nov 5, 2026
  7. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  8. developing-today commented on Nov 5, 2026

    @developing-today
    Contributor

    🤖 Agent note · handed off

  9. removed
    status/parkedDeliberately paused with a recorded resume condition
    on Nov 5, 2026
  10. 1 remaining item

  11. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

    • Agent: queue worker (repo-worker-code), lane code-i
    • Session / ID: task 10350
    • Found via: queue claim
    • Task: Task 10350 (triage, issue Docs migration batch: Atlas documentation sweep (untracked workspace sources → code doc/) #5981) assigned to the opencode execution lane — handed off to the opencode claimant, which launches the bound session; this lane does not work the task directly.
    • Expectation: claimant launches the bound opencode session before the park expires; task parked 1800s for the handoff window
    • Links: task 10350
  12. added
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    status/parkedDeliberately paused with a recorded resume condition
    and removed
    queue/claimedQueue worker lifecycle state
    on Nov 5, 2026
  13. developing-today commented on Nov 5, 2026

    @developing-today
    Contributor

    🤖 Agent note · handed off

  14. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  15. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  16. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    agent-note:v1
    task: 10350
    lane: code-h
    state: handed_off
    issue: #5981
    note: Picked up by lane code-h and handed off to the opencode claimant per execution-lane assignment (assigned_lane=opencode). Fresh check: issue #5981 OPEN, no hard-stop labels. Claimant launches the bound opencode session; this lane parks task 10350 for the handoff.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationqueue/parkedQueue task is parked (waiting on CI, time, or an event)status/parkedDeliberately paused with a recorded resume conditiontask/triageQueue packet kind: verify, reproduce, and route this itemwork/assignedQueue worker lifecycle state

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions