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. 32 remaining items

  11. 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
  12. dezren39 commented on Nov 6, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · handed off

  13. added
    queue/claimedQueue worker lifecycle state
    and removed
    status/parkedDeliberately paused with a recorded resume condition
    queue/parkedQueue task is parked (waiting on CI, time, or an event)
    on Nov 6, 2026
  14. dezren39 commented on Nov 6, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · picked up

  15. dezren39 commented on Nov 6, 2026

    @dezren39
    MemberAuthor

    🤖 Agent note · triaged

    Fresh triage (2026-11-06 UTC):

    • Docs migration batch: Atlas documentation sweep (untracked workspace sources → code doc/) #5981 remains OPEN, has no hard-stop labels, and no related PR was found. It is not already done or superseded.
    • Checked current code main at 28719695372b. It has four Atlas-specific docs under doc/ (binary service, scaler revision, manifest filter surface, and PITR-vs-retention decision) plus pkgs/atlas-search; these do not establish that the untracked sources named by this issue have been swept.
    • The exact plan path named in the issue (~/workspace/scratch/docs-migration-plan-2026-11-04/plan.md) is absent on this laptop; ~/workspace/research_notes/ is absent too. The available ~/workspace/goals/ tree has no Atlas source files. This is an execution access blocker, not evidence that those sources do not exist elsewhere.

    Scoped path and ordering: once the source workspace is mounted/exported to this laptop, enumerate the source docs (title, location, date, subject); copy only durable design/reference material into doc/ without deleting sources; add canonical pointers at goal-workspace citations; and list sensitive/ephemeral exclusions by name and reason. Keep memory topics reference-only for this copy sweep, consistent with this issue. Use the classification standard in #5983 where it applies. The resulting enumeration is an input to the docs portion of #6025; #6025 can proceed with its code/cairn portion independently.

    Resume condition: provide the referenced migration plan and Atlas source trees (at minimum research_notes and relevant goal files) to the laptop workspace, then perform the enumeration and copy/PR. Until then, do not invent an inventory or copy unseen content. No Drew-only design decision is currently required.

  16. added
    status/triagedTriaged and routed (see agent note)
    and removed
    queue/claimedQueue worker lifecycle state
    work/assignedQueue worker lifecycle state
    on Nov 6, 2026
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 documentationstatus/triagedTriaged and routed (see agent note)task/triageQueue packet kind: verify, reproduce, and route this item

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions