CareerVector Onboarding

This folder is durable onboarding context for human and AI contributors. It is short, current, and more stable than temporary task handoff notes.

Start Here

  1. Read this file.
  2. Read 01-north-star.md for the product/business frame.
  3. Read 02-current-architecture.md for the live technical model.
  4. Read 03-hot-paths.md before editing code.
  5. Read 04-repo-operating-contract.md for repository authority and CI.
  6. Follow 05-development-and-security.md for checkout, validation, secrets, access, and incident handling.
  7. Use 06-derived-code-graph.md only when a disposable local code graph makes a large dependency or call-path question easier to inspect.

Source Priority

When sources conflict, prefer them in this order:

  1. User instructions in the current conversation.
  2. Live code in this checkout.
  3. architecture/, AGENTS.md, and the nearest directory AGENTS.md.
  4. Canon notes and this onboarding/ folder.
  5. Temporary task handoff notes in working-memory/.
  6. Studies, archives, older reports, and historical implementation plans.

Maintenance Rule

Keep these docs boring. They should answer:

  • What is the product?
  • What is the current architecture?
  • Where are the hot paths?
  • What is currently broken or mid-migration?

Do not paste long debugging transcripts here. If a detail is likely to churn, link to the file or command that proves it instead.

Source: wiki/content/onboarding/README.md