8000 Brain system neglected: fix discoverability (decisions, learnings, inbox, assets, file index) · Issue #42 · simon-inkie/inkie-the-brain · GitHub
[go: up one dir, main page]

Skip to content

Brain system neglected: fix discoverability (decisions, learnings, inbox, assets, file index) #42

Open

Description

@simon-inkie

Original Linear description

From the maintainer (2026-07-06).

Problem

The brain system/structure (~/brain/decisions/, ~/brain/learnings/, ~/.the-brain/agents/*/inbox/, ~/brain/assets/, etc.) is being neglected as it grows. the maintainer spent a long time with agent-f today trying to find a file that should have been easy to locate.

Ideas to explore (not prescriptive, needs its own design pass)

  • A file index, possibly linked from CLAUDE.md/persona files, pointing into the brain vault so agents (and the maintainer) have a map of what lives where.
  • More emphasis on actually using the semantic remembering tool (pnpm --dir ~/io-projects/the-brain search) day-to-day, rather than agents falling back to manual file hunting.
  • Possibly new skills specifically for brain hygiene: filing discipline, periodic structure review, stale-file cleanup, cross-linking conventions.

Scope

Needs its own investigation + design pass (what's actually structurally wrong, what's just under-used tooling, what's genuinely missing) before committing to a specific fix. File this as the umbrella ticket; break into sub-tasks once the shape is clear.

Origin

Migrated from Linear: INK-644. The original wording is retained except the disclosed privacy and rendering edits below.

Current scope and qualifications

The description above is the original Linear account, including its historical findings and scope. It is not a fresh claim that every described defect still exists.
Current Linear state is Backlog. Prior source review recorded uncertain, with this remaining scope:

  • Locate the dated agreed investigation, recommendations and breakdown or leave the investigation pending.

Publication transfers the task; it does not authorise live recovery, deployment, spending or configuration changes.

Transfer edits

  • Historical principal names are aliased in prose; artificial shell-filename web links are rendered as code where present.
  • Historical fleet identities are aliased; code identifiers and permitted source paths remain references.
  • Additional transfer edits: omit private priority/cutoff; omit private programme priority and budget/rollout timing.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestmajor-featureA substantial feature or new capability

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0