Trigger: "set up agentic OS", "initialize agent harness", "init my project for AI agents", "retrofit repository", "upgrade project for evolution", "sync instruction files", "where do I put CLAUDE.md", "create my agent environment", "set up persistent memory". Guides users through discovery, initializes/retrofits 3-Layer Memory, keeps AGENTS.md as the sole canonical instruction file, and guides plugin installation.
Installs into .claude/skills of the current project.
Are you the author of Os Init?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/richfrem-os-init)
---
name: os-init
plugin: agent-agentic-os
description: >
Trigger: "set up agentic OS", "initialize agent harness", "init my project for AI agents",
"retrofit repository", "upgrade project for evolution", "sync instruction files",
"where do I put CLAUDE.md", "create my agent environment", "set up persistent memory".
Guides users through discovery, initializes/retrofits 3-Layer Memory, keeps AGENTS.md as
the sole canonical instruction file, and guides plugin installation.
allowed-tools: Bash, Read, Write, Glob, Grep
---
# Agentic OS Init & Retrofit Guide (`os-init`)
Bootstrap or retrofit the Agentic OS and 3-Layer Memory architecture in any repository. Supports fresh setup as well as retrofitting established projects to comply with autonomous evolution standards.
## Contents
- [Critical Constraints](#critical-constraints)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
- [References](#references)
## Critical Constraints
1. **Read-Only Preflight**: Always run probe first to classify repo state; never blindly overwrite existing instructions.
2. **Canonical Instructions**: `AGENTS.md` is the sole canonical source; `CLAUDE.md` must be a short pointer.
3. **Preserve User Rules**: During retrofits, preserve custom user instructions and never destroy existing configurations without confirmation.
## Quick start
Probe installation state before taking action:
```bash
python3 scripts/control_plane/installation_probe.py --target <project-path>
```
## Workflow
1. **Preflight**: Run `installation_probe.py` to classify target as `FRESH`, `COMPLETE`, or `PARTIAL_OR_DRIFTED`.
2. **Discovery**: Interview stack, AI platforms, and package manager.
3. **Synthesize Instructions**: Keep `AGENTS.md` canonical per [instruction-blending.md](references/instruction-blending.md).
4. **Execute Provisioning**:
- Fresh: `python3 scripts/init_agentic_os.py --target <project-path> --sync-instructions`
- Retrofit: `python3 scripts/init_agentic_os.py --target <project-path> --retrofit`
5. **Verify Substrate**: Confirm 3-Layer Memory structure and run health check.
## Verification
Confirm Layer 2 `wiki/`, `context/control_plane.db`, and run `os-health-check`:
```bash
python3 scripts/control_plane/installation_probe.py --target <project-path>
```
## References
- [detailed-reference.md](references/detailed-reference.md) — Phase specifications and identity enrollment details.
- [acceptance-criteria.md](references/acceptance-criteria.md) — QA scenarios and pass/fail matrix.
- [fallback-tree.md](references/fallback-tree.md) — Remediation pathways for failed initializations or drift.
