onboarding

Guide Socratic dialogue to generate project-understanding.md and .claude/dso-config.conf artifacts.

6|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/navapbc/digital-service-orchestra --skill onboarding-navapbc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onboarding
Source: https://github.com/navapbc/digital-service-orchestra/tree/main/plugins/dso/skills/onboarding
Command: npx skills add https://github.com/navapbc/digital-service-orchestra --skill onboarding-navapbc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3.

What problem does it solve?

Onboarding a new project or team member often requires repetitive questions and scattered notes. This Skill automates that process by guiding a Socratic dialogue to surface key decisions about the project's stack, architecture, governance, and CI patterns, producing structured artifacts for alignment.

Core Features & Use Cases

  • Guided Socratic onboarding across seven dimensions: stack, commands, architecture, infrastructure, CI, design, and enforcement.
  • Automatic artifact generation: project-understanding.md, .claude/dso-config.conf, and a shim at .claude/scripts/dso to load DSO workflows, enabling repeatable setup for future projects.
  • Batch-group command execution with a single approval prompt to streamline setup and guardrails.

Quick Start

Start an onboarding session with /dso:onboarding and follow the prompts to capture your project's details.

Frequently Asked Questions about onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate project onboarding to document architecture and governance?

Guided project onboarding automates discovery by running a Socratic dialogue across seven dimensions including stack, architecture, and CI, producing structured artifacts like project-understanding.md to establish shared governance and alignment.

What is Socratic onboarding for a new software project?

Socratic onboarding is a guided dialogue process that asks targeted questions to surface key decisions about infrastructure, design, and enforcement patterns. It builds shared project understanding through interactive discovery rather than manual documentation review.

How do I start an onboarding session to generate project understanding artifacts?

Start an onboarding session by invoking the /dso:onboarding command and following the interactive prompts. The skill captures project details and automatically generates project-understanding.md and .claude/dso-config.conf configuration artifacts.

Does the onboarding skill require Python or specific dependencies to run?

The onboarding skill requires Python 3 as its runtime dependency to execute batch-group commands and generate configuration artifacts. It operates within multi-agent environments and integrates with claude-code workflows without additional package requirements.

What files and configurations does automated project onboarding generate?

Automated project onboarding generates project-understanding.md for documentation, .claude/dso-config.conf for configuration, and a shim script at .claude/scripts/dso to load DSO workflows. These artifacts enable repeatable setup and standardized governance across projects.

Can I use batch-group command execution to streamline multi-agent project setup?

Batch-group command execution streamlines multi-agent project setup by consolidating multiple commands into a single approval prompt with safety and recovery guards. This approach reduces manual intervention while maintaining governance controls across the onboarding workflow.