Project Bootstrap Repo Onboarding v1.0

Category: automation

Price: $4.99

Release status: READY_FOR_LISTING / DOCS_COMPLETE

Source QA: Viper APPROVED_FOR_RELEASE and Warlock security-cleared on 2026-05-27

What it does

Project Bootstrap Repo Onboarding gives OpenClaw teams a safe first-pass onboarding plan for a cloned repository. It detects common project types, suggests setup and validation commands, checks for AGENTS.md, and flags sensitive filenames without reading their contents.

It does not execute commands or mutate the repo. Instead, it produces a practical handoff so humans and agents know what stack they are dealing with, which gates to run, and which policy gaps must be reviewed before automation starts.

Use cases

Developers handing repos to AI agents who need quick stack detection and safe setup/test guidance.
Consultants onboarding unfamiliar client codebases who need a consistent repo-readiness report before making changes.
Security-conscious teams who want sensitive-file warnings and missing agent-instruction checks before agentic development begins.

Requirements

A local repository folder to inspect.
Python 3 with standard library only; no pip dependencies.
No GitHub token, network access, or package-manager access required.
No API keys required.
Tested against the OpenClaw v2026.3.23 workspace pattern.

Example usage


python3 skills/project-bootstrap-repo-onboarding/scripts/repo_onboarding.py \
  --repo /path/to/repo \
  --json

Expected output


{
  "ok": true,
  "status": "READY",
  "project_types": ["node", "python"],
  "setup_commands": [
    "npm install",
    "python3 -m venv .venv",
    "python3 -m pip install -r requirements.txt"
  ],
  "validation_commands": [
    "npm test",
    "npm run lint",
    "python3 -m compileall .",
    "python3 -m pytest"
  ],
  "findings": [],
  "handoff": "Add detected setup and validation commands to AGENTS.md, then run gates in a disposable checkout.",
  "mutated_files": []
}

Sensitive files produce a safer blocked result without reading secret content:


{
  "status": "BLOCKED",
  "findings": [
    {"severity": "high", "code": "sensitive_file_present", "path": ".env", "message": "sensitive filename present; contents not read"}
  ]
}

Marketing copy

Project Bootstrap Repo Onboarding helps teams make any repo agent-ready without guessing. It performs read-only stack detection, recommends setup and validation commands, checks for missing AGENTS.md, and flags sensitive files by filename only, giving developers and consultants a safe handoff before OpenClaw agents start working in unfamiliar codebases.

Project Bootstrap Repo Onboarding