Skip to content

Add Serena project config and onboarding memories - #4

Merged
jqnatividad merged 3 commits into
dathere:mainfrom
jqnatividad:serena-onboarding
Sep 15, 2026
Merged

jqnatividad merged 3 commits into
dathere:mainfrom
jqnatividad:serena-onboarding

Conversation

@jqnatividad

Copy link
Copy Markdown
Collaborator

Adds Serena scaffolding so an AI coding agent working in this
repo starts from the project's real invariants instead of rediscovering them (or guessing) each
session.

What's here

  • .serena/project.yml — project config: languages, timeouts, tool settings.
  • .serena/memories/ — eight onboarding notes, organised as a reference graph from core.md:
    tech_stack, suggested_commands, conventions, task_completion, plus per-module
    agents/core and gateway/core.
  • .gitignore — ignore /.roborev/ snapshots.

What the memories actually say

They deliberately point at CONTRIBUTING.md § "Things that will bite you" and
.roborev.toml rather than transcribing them, and spend their words on things written down
nowhere, each verified against the code rather than inferred:

  • LocalStorage's root is the repo checkout itself, which is why tests/conftest.py mutates the
    already-imported storage singleton instead of re-creating it — and why code that resolves
    paths from anything but storage.root escapes the fixture and writes into the working tree.
  • mcp/registry.py sets MCP_CONFIG_DIR = Path.cwd() / "configs" at module scope, so pytest
    must run from the repo root (the same reason ci.yml forbids working-directory).
  • Local pytest picks up --cov from addopts; CI runs -q --no-cov.
  • is_llm_graph_source() merges admin-added CKAN portals at runtime, so the set of LLM-graph
    source ids cannot be found by grepping.
  • messages is the only reducer-backed GraphState key — every other list key is
    last-write-wins, so a node returning a partial execution_trace silently drops earlier entries.
  • The UP042 ruff ignore is load-bearing: rewriting (str, Enum) to StrEnum would change how
    these enums render in prompts, notebooks and logs.

Scope

Documentation and config only — no source file is touched, and the three commits add 432 lines
across 11 files with no deletions. .serena/cache and .serena/project.local.yml are excluded by
.serena/.gitignore; .serena/logs is already covered by the root logs/ rule.

Worth a deliberate call on whether agent scaffolding belongs in the repo at all — it's easy to
drop if the answer is no.

🤖 Generated with Claude Code

@jqnatividad
jqnatividad merged commit 96627e6 into dathere:main Sep 15, 2026
4 checks passed
@jqnatividad
jqnatividad deleted the serena-onboarding branch September 15, 2026 12:13
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.

1 participant