Skip to content

Repository hygiene — stale PR, branch model, misleading closed issues, doc drift #145

Description

@lucaosti

Context

Housekeeping found during the project review that does not belong to a feature milestone.

Tasks

Stale pull request

Branch hygiene

  • mvp and mvp-testing are kept deliberately — MVP testing work continues there. But mvp is currently 5 commits behind mvp-testing and both will diverge from master further during integration. Agree and document the branch model in AGENTS.md: what each branch is for, what merges where, and when they are reconciled.

Issue accuracy

Documentation drift guards

  • The README's RAG variable table drifted from the code (SKIP_CHROMA_INDEX was documented as true, code defaults to false). Consider a test or CI check asserting documented defaults match Settings, so this class of drift cannot recur silently.

Acceptance criteria

  • No pull request open against a branch that is not part of the agreed model
  • The branch model documented in AGENTS.md
  • Every misleading closed issue carries a comment stating what was actually delivered
  • Documented configuration defaults match code, ideally enforced automatically

Why this matters

Per AGENTS.md § Keeping GitHub honest: a Done that does not match the code is worse than an open issue, because it stops anyone from looking.

Activity

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 documentation

Type

No type

Projects

No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions