Skip to content

DevEx Docs

This directory is the contributor-facing entrypoint for working on SecondBrain itself.

Read In This Order

  1. quickstart.md for local setup and validation.
  2. AGENTS.md in the repo root for repo-specific operating rules.
  3. CONTRIBUTING.md in the repo root for pull request expectations and quality gates.
  4. cli-change-checklist.md before changing command surfaces.
  5. agent-operability.md before shaping agent-driven implementation work.
  6. component-test-entrypoints.md to choose a narrow validation loop.
  7. sb --help, sb dev review --help, and the specific command help for the area you are touching.

Scope

These DevEx docs are intentionally operational:

  • local setup
  • repo sanity checks
  • validation commands
  • contributor workflow
  • agent-operable task and review patterns

Point-in-time notes, rollout history, and other archival material are not part of the active contributor path anymore.