Files
fidelity-ai-workspace/project-knowledge/00-start/onboarding.md
david.delagneau dbc1894e27 Add project-knowledge structure and templates
- Introduced new maps for navigating project knowledge, including "Current Work," "Fidelity Domain," "Fidelity Apps," "Work Items," and "People."
- Created base files for daily notes, decisions, people, systems, work items, and workstreams with defined properties and views.
- Developed templates for daily notes, decisions, meeting notes, persons, systems, work items, and workstreams to standardize documentation.
- Updated scripts and prompts to reflect the new project-knowledge directory structure.
- Removed outdated onboarding and start-here documents, consolidating relevant information into the new maps.
- Ensured all references in workflows and scripts point to the new project-knowledge paths.
2026-04-17 15:52:08 -06:00

2.7 KiB

type, audience, project, updated, tags
type audience project updated tags
onboarding new-member fidelity 2026-04-17
onboarding
map

New Member Onboarding

Use this guide when someone new needs to understand the Fidelity project context quickly.

This vault is project knowledge, not the product codebase and not the agent implementation manual.


First 30 Minutes

Read these in order:

  1. Start Here
  2. Current Work Map
  3. Fidelity Domain Map
  4. Work Items Map
  5. People Map

Goal:

  • understand where current work lives
  • identify active tickets
  • understand the main systems and people
  • avoid treating raw logs or inbox evidence as confirmed durable truth

First 60 Minutes

Read:

  1. Project Context
  2. XFlowSDK
  3. Fid4
  4. REST Migration
  5. AO And Discourse
  6. Communication

Goal:

  • understand why auth state, entry point, and backend configuration matter
  • distinguish external reports from regressions
  • understand why communication precision is part of the engineering workflow

First 120 Minutes

Read:

  1. Systems Index
  2. Workstreams Index
  3. iOS Context
  4. Jira Story Rules
  5. Pull Requests

Goal:

  • understand how Fidelity project knowledge is organized
  • know where to find durable systems, workstreams, people, decisions, and active tickets
  • know the communication standards expected for standups, Jira, PRs, and manager updates

Daily Workflow

  1. Start from Current Work Map.
  2. Check Current Work.
  3. Open the active work item from Work Items Map.
  4. Review the latest relevant note from Daily Notes Index.
  5. Use Communication before writing standups, Jira comments, or manager updates.

Rules Of Thumb

  • project-knowledge/06-daily/ is dated work evidence.
  • project-knowledge/01-current/ is what matters now.
  • project-knowledge/02-work-items/ is canonical ticket memory.
  • project-knowledge/03-context/ is durable project knowledge.
  • project-knowledge/04-people/ is collaborator and role memory.
  • project-knowledge/05-decisions/ is durable decision history.
  • ai/inbox/ and generated files are raw evidence, not promoted memory.