os-new-person

To add a new stakeholder to global contacts and link them to a project, you capture their identity into root-level files under people/ or companies/ while optionally writing a project-scoped identity file that records their role context for the active project.

Identity onboarding captures new people or companies into a global contact store when stakeholders first appear in meetings or chats. It creates reusable root identity files under people/ or companies/ and optionally writes project-level people files with role context.

To avoid creating duplicate contacts when adding someone new, the system performs fuzzy-matches against names in existing contacts. It offers to update the existing deterministic root identity file instead of duplicating the person or company entry.

Yes, you can enrich contact summaries by providing pasted background material or a filename in raw/ during onboarding. The system ingests this material to extract key facts and update identity fields, project context, and informs metadata.

Yes, project linking records a person's specific role for the active project. When a project is selected, the system writes a project-level people file and adds CLAUDE key-people entries to capture their specific role context within that project.

The best way to capture new company contacts across multiple projects is to add them to root-level files in companies/. This creates a deterministic global identity that remains reusable across sessions, while optionally writing project-scoped files for specific role linkages.