rai-project-onboard

Discover repository conventions and generate six governance documents with a knowledge graph.

71|8|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/humansys/raise --skill rai-project-onboard-humansys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rai-project-onboard
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-project-onboard
Command: npx skills add https://github.com/humansys/raise --skill rai-project-onboard-humansys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Help teams onboard brownfield repositories by automatically discovering project conventions, extracting existing documentation, and filling missing governance artifacts so projects have consistent, parser-friendly governance without manual audit work.

Core Features & Use Cases

  • Automated Discovery: Run discovery to detect modules, conventions, and existing docs and build a knowledge graph.
  • Governance Filling: Identify gaps and generate six governance documents (vision, prd, guardrails, backlog, system-context, system-design) while merging detected conventions into guardrails.
  • Quality Gate: Enforce a 4-dimensional coverage gate (governance, module coverage, doc coverage, traceability) to validate readiness for sessions.
  • Use Case: Onboard an existing microservice repo after initial detection to produce governance artifacts and a searchable project graph for future AI sessions.

Quick Start

Run rai init --detect then execute /rai-project-onboard to discover conventions, fill governance templates, and build the knowledge graph.

Frequently Asked Questions about rai-project-onboard

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

FAQPage Schema
How do I generate governance documentation for an existing repository?▼

To generate governance documentation for an existing repository, run rai init --detect then execute the onboarding process. This automatically discovers project conventions, fills six governance templates, and builds a searchable knowledge graph.

What is a 4-dimensional coverage gate in project onboarding?▼

A 4-dimensional coverage gate validates repository readiness by enforcing standards across governance, module coverage, doc coverage, and traceability. It ensures brownfield projects have consistent, parser-friendly governance before completing the onboarding process.

How do I discover project conventions in a brownfield codebase?▼

Discover project conventions in a brownfield codebase by running automated discovery. This detects modules, extracts existing docs, and merges detected conventions into guardrails while building a searchable knowledge graph for future AI sessions.

Can I onboard a microservice repo without manually auditing governance artifacts?▼

Yes, you can onboard a microservice repo without manual audit by running automated discovery and gap analysis. The process identifies missing governance artifacts and generates vision, PRD, guardrails, backlog, system-context, and system-design documents automatically.

What governance files are required to prepare a codebase for AI sessions?▼

Preparing a codebase for AI sessions requires six governance files: vision, PRD, guardrails, backlog, system-context, and system-design. These documents are generated automatically by merging detected conventions into guardrail templates.

Why does project onboarding fail the coverage gate for missing documentation?▼

Project onboarding fails the coverage gate when repositories lack required governance artifacts and traceability. Automated discovery identifies documentation gaps, generates missing governance templates, and validates 4-dimensional coverage to ensure readiness.