projects-setup

Scaffolds Project SSoT structures and registers projects in the orchestrator config.

1|Updated Jul 3, 2026
One-click install
npx skills add https://github.com/Ryokuman/new_human_ochestrator --skill projects-setup-ryokuman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: projects-setup
Source: https://github.com/Ryokuman/new_human_ochestrator/tree/main/system/20-skills/projects-setup
Command: npx skills add https://github.com/Ryokuman/new_human_ochestrator --skill projects-setup-ryokuman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new project inside a multi-layer orchestrator repository requires creating many directories, dashboards, dictionaries, and config entries by hand, which is error-prone and inconsistent. This Skill standardizes the registration of a project under projects/<project-id>/, scaffolds the Project SSoT and Project Work SSoT layers, and records the project in silo-projects.yaml. ## Core Features & Use Cases - Project SSoT scaffolding: Generates the 1-layer Project SSoT (project registry, project contract, requirements, decisions) and 2-layer Project Work SSoT (issues, tasks, runbooks, coverage) via setup.sh --create-project-ssot. - Dashboard and dictionary setup: Creates DataviewJS/Obsidian Base work dashboards, a project overview, and a project dictionary with defined minimum frontmatter fields. - Config registration: Adds the project to system/config/silo-projects.yaml with repo URL, protected branches, silo eligibility, and DB schema paths, without storing secrets. - Use Case: When starting a new product repo, run the setup procedure to create the full projects/<project-id>/ structure, fill in project-contract.md, and register the project so silo task execution can begin. ## Quick Start Ask the agent to register a new project with a given project id and name using the Projects Setup procedure, then verify the generated scaffold and config entry.

Frequently Asked Questions about projects-setup

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

FAQPage Schema
How do I set up a new project in the orchestrator projects structure?

Run ./setup.sh --create-project-ssot with a project id, name, and target path to scaffold the Project SSoT and Project Work SSoT directories. Then fill in project-contract.md, the requirements folder, and register the project in system/config/silo-projects.yaml.

What goes into a project-contract.md file?

The project contract records the product definition, current version goals and non-goals, core user flows, data storage and sync boundaries, repo roles, required references before task creation, task writing rules, and information that must not be estimated. Unconfirmed items are marked as missing rather than left blank.

How do I register a project in silo-projects.yaml?

Add a project entry with id, name, repo_url, default_branch, protected_branches, allowed_for_silo, role, repo ownership details, and DB usage fields. Never store tokens, passwords, or credential values in the config; only operational metadata is recorded.

Does the work dashboard require any Obsidian plugins?

Yes, the DataviewJS dashboard requires the Obsidian community plugin dataview with DataviewJS execution enabled. The scaffold also generates a work-items.base file so users can use Obsidian Base views as an alternative.

What should not be stored in the Project SSoT layer?

Raw task, issue, and QA originals, silo local logs, single-task mock data, and temporary PR judgments must not be placed in the 1-layer Project SSoT. Secrets, tokens, and credentials are also prohibited from all documents and config files.