Skip to content

Audit personal and project MARR layers for standards updates to release #107

@virtualian

Description

@virtualian

Context

MARR standards in this repo (resources/standards/) are the canonical source published to npm. Over time, ad-hoc additions, refinements, and corrections accumulate in two downstream layers that are NOT canonical:

  • ~/.claude/marr/ — the user-level MARR install
  • ~/projects/*/.claude/marr/ — per-project MARR installs across active repositories

Useful improvements made downstream do not flow back to canonical unless explicitly audited and imported.

Goal

Identify all useful divergences from canonical MARR in those two layers, decide which ones should become part of the published standards, and release the merged result to npm.

Scope

  • Compare every standard, prompt file, and configuration fragment under ~/.claude/marr/ against canonical resources/
  • Compare every .claude/marr/ directory under ~/projects/ against canonical resources/
  • Produce a triaged list of candidate updates: import as-is, adapt, reject, or already-tracked-by-existing-issue
  • For each accepted candidate, open a follow-up issue (or fold into an existing one) so the change is tracked through the normal workflow
  • Release the resulting batch to npm once merged (minor or patch per Development Workflow Standard)

Out of Scope

  • Project-specific content that is not generalisable (must remain at project level)
  • Personal preferences in ~/.claude/marr/ that are not standards-shaped
  • Changes to MARR tooling itself (separate concern)

Acceptance Criteria

  • Triage table produced covering every divergent file in both layers
  • Each accepted candidate has a tracked issue and PR against canonical
  • Rejected candidates have a one-line rationale recorded
  • All accepted changes merged to main with passing tests
  • npm release published containing the merged updates
  • Release notes summarise the standards changes

Notes

The active project list to audit lives under ~/projects/. Not every directory there is a MARR consumer — only those with a .claude/marr/ directory should be inspected.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions