arif-init-wrapper

Files (1)

• SKILL.md

SKILL.md (first lines)

# arif-init-wrapper

**P0 — Universal Anchor for All Agent Vendors**
**Seal:** DITEMPA BUKAN DIBERI · 2026-03-27

---

## Purpose

Every agent on this VPS starts from the same broken state: **no anchor, no session context, no constitutional grounding.** The `arif-init-wrapper` closes this gap for every vendor by providing a universal bootstrap that:

1. Establishes a governed session via arifOS MCP
2. Verifies the agent's identity context
3. Checks constitutional floor health before any tool is touched
4. Reads carry-forward context from memory before starting work
5. Reports its status to the operator in plain language

**Why this is P0:** Without this, agents operate unanchored — the exact condition that produced the opencode catastrophe (session with no constitutional grounding, leading to blind `git reset --hard origin/main`).

---

## Trigger Patterns

Every time any of these agents start a session, run `arif-init-wrapper`:

| Agent | Invocation |
|-------|-----------|
| Claude Code | On every `claude` session start |
| Codex | On every `codex` session start |
| Gemini CLI | On every `gemini` session start |
| Kimi | On every `kimi` session start |
| OpenCode | On every `opencode` session start |
| Aider | On every `aider` session start |
| Copilot CLI | On every `github-copilot-cli` session start |
| Any new agent | On first boot, before any tool use |

---

## Protocol

### Step 1 — Anchor Session

```bash
# Probe arifOS MCP availability
curl -sf http://localhost:8080/health 2>/dev/null && {
  # Session anchor via MCP
  arifosmcp_call tool=init_anchor payload='{"actor_id":"AGENT","session_purpose":"WORK"}'
} || {
  echo "[UNANCHORED] arifOS MCP unavailable. Operating WITHOUT constitutional grounding."
  echo "[WARNING] This is high-risk. Proceed with extreme caution."
}
```

### Step 2 — Constitutional Integrity Check (LAW 2)

Before any work, verify the foundation:

```bash
# Check core directory integrity
core_modules=$(ls /root/arifosmcp/core/*.py 2>/dev/null | wc -l)
if [ "$core_modules" -lt 10 ]; then
  echo "[P0 CONSTITUTIONAL CRISIS] /root/arifosmcp/core/ appears broken ($core_modules modules, expected 20+)"
  echo "[ACTION] HALT. Report to Arif. Do not proceed."
  echo "[RECOVERY] Check feature branches: git branch -a | grep feature/"
  return 1 2>/dev/null || exit 1
fi

# Check pytest can collect tests (structural sanity)
cd /root/arifosmcp && pytest --collect-only -q 2>/dev/null | tail -1 && {
  echo "[OK] Constitutional structure verified."
} || {
  echo "[WARNING] pytest collection failed. Foundation may be unstable."
}
```

### Step 3 — Check Floors (F1–F13 baseline)

```bash
# Verify critical floors are loadable
python3 -c "
import sys
sys.path.insert(0, '/root/arifosmcp')
try:
    from core.shared.floors import THRESHOLDS
    floors_ok = len(THRESHOLDS) >= 13
    print(f'[FLOORS] {len(THRESHOLDS)}/13 loaded')
except Exception as e:
    print(f'[FATAL] Floor check failed: {e}')
    sys.exit(1)
"
```

### Step 4 — Memory Carry-Forward

```bash
# Query recent scars and unresolved issues
arifosmcp_call tool=memory_query payload='{"query":"recent scars unresolved actions","limit":5}'
```

### Step 5 — Agent Identity Declaration

State clearly:
- Which agent vendor is running
- Whether constitutional grounding is active or unavailable
- Any constitutional warnings for this session

### Step 6 — Operator Report

Report to Arif in plain language:
```
[ANCHOR] Agent: {vendor}
[STATUS] arifOS MCP: {available/unavailable}
[FLOORS] Constitutional check: {pass/wail}
[CORE]   Core modules: {count}/expected
[MEMORY] Recent context: {carry_forward_summary}
[RISK]   Session risk level: {LOW/MEDIUM/HIGH/CRITICAL}
[ACTION] Ready to proceed: YES/NO
```

From ariffazil/arifOS, AGPL-3.0.

More from ariffazil/arifOS