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.